> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/economy/consumer-spend>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/economy/consumer-spend.mdx>

---

# Consumer Spending API

Household spending by European country, category and year.

`GET /v1/economy/consumer-spend` takes `country` (up to 10, comma-separated ISO codes, or `EU27` and `EA`), `category` (comma-separated: `total`, `food`, `alcohol_tobacco`, `clothing`, `housing`, `furnishings`, `health`, `transport`, `information_communication`, `recreation`, `education`, `restaurants_hotels`, `insurance_financial_services`, `personal_care_miscellaneous`, `personal_care`, `insurance`, `financial_services`), `unit` and a `fromYear` to `toYear` window.

`data.series` holds one entry per country and category with `country`, `countryName`, `category`, `categoryCode` (COICOP 2018), `categoryName` and `points`, one `{ year, value, status }` per year. `data.countriesWithoutData` names countries the dataset doesn't cover for that unit and window, and `data.source` carries the publisher and its credit line.

## Request

- **Endpoint:** `GET /v1/economy/consumer-spend`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by European country and category
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/economy/consumer-spend/get)
- **Platform page:** [/platforms/economy](https://www.socialfetch.dev/platforms/economy)

## FAQ

### Which units can I ask for?

eur_millions (default), eur_per_capita, share_of_total, share_of_gdp, national_currency_millions, national_currency_per_capita and real_growth_percent (change on the previous year in volume terms).

### Why is a recent year null?

The data is annual and usually one to two years behind; a year not yet published is null, and a provisional value carries status provisional.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
