Economy Data API. Spending, contracts and trade as JSON.
Official spending statistics, US federal contracts and US import records behind one key, with the same envelope and billing as every other route.
- European spending
- US federal spending
- Importer shipments
- 1 credit per request
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
Economy data as JSON. You build the product.
Live Economy data in one response shape, with platform changes handled for you.
Economy, plus every other platform
One key and one response envelope for Economy and 86 more platforms.
API key
sk_live_••••••••
Pricing you can reason about
One request, one credit. Know how far your balance will go before you run your next batch.
- Requests
- 480
- Credits
- 480
Balance
Live data on every request
Fetch public data when you ask for it.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
lookupStatus: found
Regular jobs. Better rates.
Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.
What Economy data can you get?
5 endpoints, one API key. Every response comes back as live JSON in the same envelope.
Spending
US government
Trade
Browse all 5 Economy endpoints
Example request
GET /v1/economy/consumer-spend. Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
What teams build with Economy data
Monitoring, enrichment, research and content workflows on Economy data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
API key
sfk_live_••••••••••••
Free requests100
Step 1: Create your free account
Get an API key with 100 requests included.
GET/v2/instagram/profiles/charlidamelio
1 request · 1 credit
Step 2: Choose an endpoint
Pass a username, URL, keyword, or post ID.
200 OK1.82s
{
"handle": "charlidamelio",
"displayName": "Charli D'Amelio",
"followers": 48300000,
"following": 1284
}
Step 3: Get clean JSON
Use the response immediately or send it into your pipeline.
Works with your stack
Code, automate, or connect your AI.
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- Top up from $1.50 / 1k if you run out
- 25 team seats
- Up to 250 monitors
- Cancel anytime
- 30-day money-back guarantee
- Price locked while you stay
Need 1M+ credits, invoicing, or volume rates? Talk to us
Trust signals
DevHunt
Product Hunt
Uneed
Customers
Teams building on Social Fetch.
“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”
“A maker pastes one link and Social Fetch fills in their bio and socials. Most of inko runs on it, and it just works.”
Jade P. · Founder, inko “Live profile data on every request. We never flag accounts from a stale cache.”
Hannah Webb · Founder, Scam Finder “Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”
Owen Pritchard · Founder, IP Flare
Economy API: common questions
Which countries does consumer and tourism spending cover?
EU and EFTA members and candidate countries, plus EU27 (the European Union) and EA (the euro area). Send ISO 3166-1 alpha-2 codes such as DE,FR,GR; EL for Greece and UK are accepted too. A country the dataset doesn't cover for your filters comes back in countriesWithoutData.
How recent is the spending data?
It is annual national accounts and tourism data, usually one to two years behind. Each value carries the statistics office's flag, such as provisional or estimated, and an unpublished year is null, not 0.
What does the federal spending window default to?
The latest US federal fiscal year (1 October to 30 September) that ended at least 90 days ago, because agencies report with a lag of up to 90 days. Send from and to as YYYY-MM-DD for any window from 2007-10-01.
Why does a company name find no contracts?
Contracts are filed under legal names, matched as text: Space Exploration Technologies finds SpaceX's contracts, SpaceX does not. A search with no match is an empty list.
How deep can I page contract search?
As deep as the results go: the cursor carries the last row's keys, so there is no page limit. total is the full match count, read on the first page.
How is the importer chosen from a company name?
Endings such as Inc, LLC and USA are ignored. An exact name wins, then a name starting with yours, then the largest importer that matched; selection says which, and matches lists every candidate with its id, which you can send back as company.
Do importer records include air freight or contacts?
No. The records are sea shipments from US Customs vessel manifests, and contact details are never returned. Importers can ask Customs to keep their names confidential, so some are missing.
How much does the Economy API cost?
One credit per completed request, and each contract page is its own request. Check meta.creditsCharged on every response. New accounts get 100 free credits.
The Economy API in detailHow the Economy routes work, what they cost, and how they differ from the official API.
Why teams use Social Fetch for Economy
Social Fetch exposes five routes under /v1/economy. GET /v1/economy/consumer-spend returns household spending for up to 10 European countries by category (food, housing, transport, restaurants and hotels and more) and year, in euro, per person, as a share of all spending or of GDP. GET /v1/economy/tourism-spend returns what residents of those countries spend on trips of a night or more, by category, purpose, destination and trip length.
GET /v1/economy/government-spend sums US federal spending by state, county or country for a date window, filtered by award type, NAICS industry, product or service code (PSC) and keyword. GET /v1/economy/government-contracts searches federal contract awards by recipient, keyword, NAICS, PSC and state, up to 100 a page with a cursor and the total match count. GET /v1/economy/imports takes a company name and returns the US importer's sea shipments: its suppliers, products by HS code, monthly volumes, ports, carriers and latest bills of lading.
Statistics come back as series of { year, value, status } points, with a null value for an unpublished year and the statistics office's flag (provisional, estimated) on each value. Every answer carries a source block with the publisher and the credit line its licence asks for. A country a dataset doesn't cover is listed in countriesWithoutData, never dropped silently.
How to call the Economy API
1. Create an API key
Sign up at Social Fetch and copy a key (
sfk_…). New accounts get 100 free credits.2. Ask for a series or a search
Send
GET /v1/economy/consumer-spend?country=DE,FR&category=total,transportorGET /v1/economy/government-contracts?recipient=Lockheed%20Martinwithx-api-key.3. Page, filter and credit
Follow
page.nextCursoron contract search, and showsource.attributionwhere you publish the figures.
What each Economy route returns
- Household spending for EU, EFTA and candidate countries by 16 categories and 7 units, back to 1975.
- Travel spending by category, purpose, destination, trip length and per trip or per night.
- US federal spending summed by state, county or country, with population and per capita.
- Federal contract search with recipient, NAICS, PSC, state and date filters, deep paging and a total.
- US importers' suppliers, HS codes, monthly volumes, ports, carriers and latest bills of lading.
- A source block with the publisher's credit line on every answer.
How much does the Economy API cost?
Each Economy route charges one credit per completed request; each contract page is its own request. meta.creditsCharged on every response is the billing source of truth. New accounts start with 100 free credits.
Social Fetch vs the official Economy API
The spending statistics and federal award records are published as open data; Social Fetch returns them with the same names, envelope and billing as its other routes, maps ISO country codes for you, and adds the importer records, which have no open API.
Pull your first Economy data.
Run a live Economy request in the playground. 100 free credits, no card, JSON back in seconds.
No credit cardSign up in 30 seconds withGoogleGitHub
