# Economy Consumer Spend API (https://www.socialcrawl.dev/platforms/economy/consumer-spend)

> Returns annual household final consumption expenditure per country and spending category, from Eurostat, the statistical office of the European Union. Categories are the thirteen top-level COICOP 2018 divisions (food, housing, transport, restaurants_hotels, insurance_financial and so on) plus `total`. Pick a unit: `eur_millions` for the size of the market, `eur_per_capita` to compare countries of different size, or `share_of_total` for the percentage of all household spending. Results come back as `data.series[]`, one per country and category, each with `points[]` of `{ year, value }`. A year Eurostat has not published for a country is `null`, never 0, and the latest years are often provisional. Covers EU and EEA countries and some candidates; the latest published year differs by country, so recent years can be `null` for some of them. Norway, the United Kingdom, Iceland, Albania, North Macedonia and Kosovo come from Eurostat's older COICOP 1999 dataset, the only one that still carries them: there `miscellaneous` also includes insurance and financial services, `insurance_financial` is `null`, and the United Kingdom stops at 2019. `country_code` takes ISO codes (`GR` for Greece, `GB` for the United Kingdom, `EU27` for the union) and Eurostat's own `EL` and `UK` spellings. The response also carries `dataset` (id, label, last update), `unit` and a `source_note`.

TL;DR: `GET /v1/economy/consumer-spend` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `country_code` | yes | One or more ISO 3166-1 alpha-2 country codes, comma-separated (up to 10), e.g. `DE,FR,GR`. `EU27` returns the European Union total. |
| `category` | no | Spending categories, comma-separated. Any of total, food, alcohol_tobacco, clothing, housing, furnishings, health, transport, communication, recreation, education, restaurants_hotels, insurance_financial, miscellaneous. Defaults to all fourteen. |
| `from_year` | no | First year to return. Defaults to five years before the current year. |
| `to_year` | no | Last year to return. Defaults to the latest year Eurostat has. |
| `unit` | no | `eur_millions` (current prices, million euro, the default), `eur_per_capita` (current prices, euro per person) or `share_of_total` (percentage of total household spending). (eur_millions \| eur_per_capita \| share_of_total) |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/economy/consumer-spend" \
  --data-urlencode "country_code=DE,FR" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get household spending by country from an API?

Send GET /v1/economy/consumer-spend with country_code set to one or more ISO codes, for example DE,FR. Each result series is one country and category with year and value points. Add category, from_year, to_year and unit to narrow it. Up to 10 countries per call.

### Which spending categories does consumer-spend return?

The twelve top-level COICOP divisions, including food, housing, transport and restaurants_hotels, plus total. Leave category out to get all thirteen. Pass a comma-separated list such as transport,food for just those.

### What is an example result from consumer-spend?

With country_code=DE, category=transport and unit=eur_millions, Germany's household transport spending for 2022 is EUR 253,929 million. The same call returns the other years in the window as separate points.

### Can I compare countries of different size?

Yes. Set unit=eur_per_capita for euro per person, or unit=share_of_total for the percentage of all household spending. The default eur_millions measures market size in current prices.

### Why is a year null instead of 0?

A year Eurostat has not published for a country is null, never 0, so you can tell missing data from zero spending. The latest years are often provisional, and the latest published year differs by country.

### How much does one consumer-spend call cost?

1 credit on the standard tier, whatever the number of countries or categories. New accounts get 100 free credits with no card, and a repeat within the 24 hour cache costs 0 credits.

See the full Economy API: https://www.socialcrawl.dev/platforms/economy

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- Is there an API for Eurostat household spending by country?
- How to compare consumer spending across EU countries with an API
- What is household transport spending in Germany?