Get household and travel spending, US federal spending and contracts, and a US importer's suppliers as structured JSON with one SocialCrawl API key. Eurostat and USAspending.gov are the named sources. Reads are priced in credits.
5 active endpoints. Consumer and travel spend, federal spend and contracts, importers.
Read endpoints for official spending statistics and public trade records. EU household and travel spending by country, US federal spending by place and individual contract awards, and the overseas suppliers of a US importer. Data API only.
/v1/economy/consumer-spendAnnual household spending by country and spending category from Eurostat. Choose euro millions, euro per capita or share of total. Years not yet published come back as null, never 0.
country_code, category, from_year, to_year, unit
/v1/economy/tourism-spendWhat residents of a country spend on trips, split into transport, accommodation, restaurants and more. Filter by business or personal purpose, domestic or foreign destination, and total, per trip or per night.
country_code, category, purpose, destination, measure, from_year, to_year
/v1/economy/government-spendFederal spending by state, county or country for an industry code, a product or service code or a keyword, from USAspending.gov. Ranked by amount with a total for the window.
naics, psc, keyword, from_date, to_date, geo, scope, award_type
/v1/economy/government-contractsIndividual awards with recipient, amount, awarding agency, NAICS, description, dates and place of performance. Needs one of recipient, keyword, naics or psc. No match returns an empty list and is refunded.
recipient, keyword, naics, psc (one required), from_date, to_date, type, sort, order, limit, page
/v1/economy/importsA US importer's customs record: top overseas suppliers with shipment counts, the HS headings it ships and the latest bills of lading. Brand names resolve to the filer, so Nike returns Nike Usa.
company, limit
Returns yearly household spending for each country and category, such as food, housing or transport, in euro millions, per person or as a share of the total.
Use it to compare how much people in different countries spend on a product category, or to see how a country's spending mix changes year to year.
1 credit
country_code · 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.
$ curl https://www.socialcrawl.dev/v1/economy/consumer-spend?country_code=DE%2CFR&category=transport%2Cfood&from_year=2020&to_year=2024&unit=eur_millions \
-H "x-api-key: sc_YOUR_API_KEY"// Running this live needs your own API key. Hit "Try it" to see an example responseEconomy is a normal SocialCrawl surface. You call GET /v1/economy/… with an API key, spend credits on cache misses, and get a single JSON envelope back. No keys for the official sources and no second SDK.
Send your key in the x-api-key header. The same key works for the social, search and commerce endpoints.
All routes are GET. consumer-spend and tourism-spend require country_code, imports requires company, and government-contracts requires one of recipient, keyword, naics or psc. We validate before charging.
Spending and contract calls cost 1 credit. The importer lookup costs 20 credits whatever the limit. Cache hits cost 0.
Every response has the same outer shape: success, data, credits_used, credits_remaining, request_id, cached. What sits inside data depends on the endpoint.
Start from an industry code, find the awards behind it, then look up what a company imports. The two Eurostat endpoints stand alone for market sizing by country.
GET /v1/economy/government-spend?naics=…Regions ranked by amount for an industry code
Find where federal money goes before you pull individual awards.
GET /v1/economy/government-contracts?naics=…Award rows with recipient, amount and agency
Name the companies and agencies behind a spending total.
GET /v1/economy/imports?company=…Top overseas suppliers, HS headings and bills of lading
See who a company buys from and what it ships in.
GET /v1/economy/consumer-spend
?country_code=DE,FR
&category=transport
&unit=eur_millions
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/economy/imports?company=Nike{
"success": true,
"data": {
"series": [
{
"country_code": "DE",
"category": "transport",
"points": [{ "year": 2022, "value": 253929 }]
}
],
"unit": "eur_millions",
"source_note": "…"
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}Each endpoint returns its own structured object. Series, ranked regions, award rows and a supplier dossier are all plain JSON you can read without a parser for the original source.
series[] per country and category with points[] of year and value, plus dataset, unit, source_note
series[] per country and category in euro, plus the purpose, destination and measure applied
regions[] with code, name, amount, population, per_capita; total_amount, geo_layer, filters
items[] with award_id, type, recipient_name, amount, awarding_agency, naics, description, dates, place_of_performance
company, top_suppliers, hs_codes, recent_shipments, matches, selection
Same request lifecycle as every other /v1 platform endpoint. Economy is not a sidecar.
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).
Registry lookup finds the economy route. Required params are checked first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before upstream work.
A deterministic cache key is built from platform, resource and params. Hit: return immediately with credits_used 0. Miss: the source is queried directly. Spending and importer responses cache for hours because the underlying data moves daily at most.
The source response is reshaped into the endpoint's object, validated, wrapped in the success envelope and logged for billing audit.
Billing rules that matter in production
Economy reads official statistics and public records and returns them in one JSON shape. You do not learn each source's query language.
Spending and trade facts about countries, industries and companies. Read-only reference data, not market quotes and not social content.
Household and travel spending come from Eurostat, the statistical office of the European Union. Federal spending and contracts come from USAspending.gov, the official US source. Importer records come from public US customs bill-of-lading filings.
A unified JSON envelope: success, data, credits_used, request_id, cached. Missing values are null, never 0, and responses carry a source note.
Eurostat spending covers EU and EEA countries and some candidates. Importer data covers US ocean freight imports only, with no air freight, exports or non-US trade, and some importers withhold their manifests.
The jobs this API is most often used for.
Market sizing and company sourcing research
Callers pair government-spend with government-contracts to find who is paid, and use imports to see who a merchant buys from. The Eurostat endpoints feed country comparisons. One GET per question and null for missing years instead of zero. Spending and contract calls at 1 credit, the importer lookup at 20. Same SocialCrawl key as the rest of the catalog.
Spending and contract calls usually return in a few seconds. The importer lookup takes 8 to 12 seconds and can reach about 25, so set a client timeout of at least 45 seconds.
Common ways teams put this data to work, and the stack each one tends to run.
consumer-spend and tourism-spend by country and category to size demand, with per capita or share units to compare countries of different size.
government-spend to find states and industries with federal money, then government-contracts to list the awards and recipients behind it.
imports to see a brand's top overseas suppliers, HS headings and latest shipments before a supplier or competitor review.
Spending and contract calls are 1 credit per call. The importer lookup is 20. Cache hits are free.
curl "https://www.socialcrawl.dev/v1/economy/consumer-spend?country_code=DE,FR&category=transport&unit=eur_millions" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/economy/government-spend?naics=4811&geo=state" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/economy/imports?company=Nike&limit=10" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
Same Economy data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | Calling each source directly |
|---|---|---|
| Request shape | A plain GET with query parameters on every endpoint | Eurostat expects dataset codes and JSON-stat parsing; USAspending.gov expects a JSON POST body |
| Response shape | Series with year and value points, ranked regions, award rows, or a supplier dossier | Multi-dimensional JSON-stat cubes and nested filter payloads you flatten yourself |
| Missing values | Unpublished years come back as null, never 0 | Gaps are encoded in status flags you must read yourself |
| Importer suppliers | Brand name in, top overseas suppliers and latest bills of lading out | No free official lookup by company name |
| Pricing | 1cr per spending call, 20cr per importer lookup; 100 free credits, no card | Free official APIs, but you build and run the integration |
Request shape
Response shape
Missing values
Importer suppliers
Pricing
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl