Get household spending by country and category
Get household spending for up to 10 European countries by category (food, housing, transport and more) and year, in euro, per person or as a share, with the…
Headers
Get your API keyAPI key (`sfk_...`)
Up to 10 countries, comma-separated: ISO 3166-1 alpha-2 codes of EU and EFTA members and candidate countries, e.g. `DE,FR,GR`, or `EU27` (European Union) and `EA` (euro area). `EL` (Greece) and `UK` are accepted too.
any of: EU27, EA, AL, AT, BA, BE, BG, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, HU, IE, IS, IT, LT, LU, LV, ME, MK, MT, NL, NO, PL, PT, RO, RS, SE, SI, SK, TR, XK (comma-separated)
Spending categories, 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`. Without it: `total` and the 13 main categories.
any of: 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 (comma-separated)
`eur_millions` (default), `eur_per_capita`, `share_of_total` (percent of all household spending), `share_of_gdp`, `national_currency_millions`, `national_currency_per_capita` or `real_growth_percent` (change on the previous year in volume terms).
one of: eur_millions, eur_per_capita, share_of_total, share_of_gdp, national_currency_millions, national_currency_per_capita, real_growth_percent
First year, e.g. `2015`. Default: five years before the current year.
≥ 1975 · ≤ 2100
Last year, e.g. `2024`. Default: the latest year published.
≥ 1975 · ≤ 2100
Endpoint-specific response payload.
The unit every value is in.
one of: eur_millions, eur_per_capita, share_of_total, share_of_gdp, national_currency_millions, national_currency_per_capita, real_growth_percent
The unit as the dataset names it.
First year in the answer; null when nothing was published.
Last year in the answer; null when nothing was published.
One series per country and category that has data, in the order you asked.
The country as you sent it, e.g. `DE`, `GR` or `EU27`.
min 1 chars
Country name in English.
The spending category, e.g. `transport`.
one of: 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
COICOP 2018 code of the category, e.g. `CP07`.
min 1 chars
The category's name in the dataset, e.g. `Transport`.
One value per year, oldest first.
Calendar year.
The value; null when the year is not published.
Flag the statistics office sets on the value, e.g. `provisional`, `estimated`, `break in time series`; null when none.
Countries you asked for that the dataset doesn't cover for this unit and years.
Where the data comes from and how to credit it when you reuse it.
Who publishes the data, e.g. `Eurostat`.
min 1 chars
The publisher's dataset code, when it has one.
The dataset's title.
When the publisher last updated the data, ISO 8601.
Where the data can be viewed.
The terms the data is published under.
min 1 chars
Credit line the licence asks for when you reuse or publish the data.
min 1 chars
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/economy/consumer-spend?country=DE,FR" \
-H "x-api-key: YOUR_API_KEY"Responses
Household spending series by country and category.