Economy

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…

GET/v1/economy/consumer-spend
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
countryarrayrequiredquery

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)

categoryarrayoptionalquery

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)

unitstringoptionalquery

`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

fromYearintegeroptionalquery

First year, e.g. `2015`. Default: five years before the current year.

≥ 1975 · ≤ 2100

toYearintegeroptionalquery

Last year, e.g. `2024`. Default: the latest year published.

≥ 1975 · ≤ 2100

Response fields
31

Endpoint-specific response payload.

dataunit
string

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

dataunitLabel
stringnullable

The unit as the dataset names it.

datafromYear
integernullable

First year in the answer; null when nothing was published.

datatoYear
integernullable

Last year in the answer; null when nothing was published.

One series per country and category that has data, in the order you asked.

dataseries[]country
string

The country as you sent it, e.g. `DE`, `GR` or `EU27`.

min 1 chars

dataseries[]countryName
stringnullable

Country name in English.

dataseries[]category
string

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

dataseries[]categoryCode
string

COICOP 2018 code of the category, e.g. `CP07`.

min 1 chars

dataseries[]categoryName
stringnullable

The category's name in the dataset, e.g. `Transport`.

One value per year, oldest first.

dataseries[]points[]year
integer

Calendar year.

dataseries[]points[]value
numbernullable

The value; null when the year is not published.

dataseries[]points[]status
stringnullable

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.

datacountriesWithoutData[]
stringoptional

Where the data comes from and how to credit it when you reuse it.

datasourcepublisher
string

Who publishes the data, e.g. `Eurostat`.

min 1 chars

datasourcedataset
stringnullable

The publisher's dataset code, when it has one.

datasourcetitle
stringnullable

The dataset's title.

datasourceupdatedAt
stringnullable

When the publisher last updated the data, ISO 8601.

datasourceurl
stringnullable

Where the data can be viewed.

datasourcelicence
string

The terms the data is published under.

min 1 chars

datasourceattribution
string

Credit line the licence asks for when you reuse or publish the data.

min 1 chars

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.