Economy hub

Consumer Spending API

Household spending by European country, category and year.

GET /v1/economy/consumer-spend

1 credit Failed requests are free

About this endpoint

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.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Consumer Spending API 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.