All platformsLive Economy data

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.

No credit card requiredRead the API docs
  • European spending
  • US federal spending
  • Importer shipments
  • 1 credit per request
  • Failed requests aren't charged
99.8% uptime#3 Product of the Day3,200+ developers

Teams running monitoring, research, and enrichment pipelines

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.

Just now1h ago

Nothing to maintain

We handle platform changes and breakages.

Built for production jobs

Run concurrent workloads with explicit statuses and request IDs.

req_8f42200
req_a91c200
req_3e07200
req_d5b8200

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.

MonthlyLower rate
Pay as you go

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.

Request
cURL

Example response

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

Request
JSON
Use cases

What teams build with Economy data

Monitoring, enrichment, research and content workflows on Economy data, on the same API as every other platform.

Market sizing

Size a consumer category or a travel market by country and year.

Public sector sales

Find who wins federal contracts in your industry, where the money goes and when awards end.

How it works

Your first request in three steps.

Use TypeScript or your automation tool of choice.

  1. API key

    sfk_live_••••••••••••

    Free requests100

    Step 1: Create your free account

    Get an API key with 100 requests included.

  2. GET/v2/instagram/profiles/charlidamelio

    1 request · 1 credit

    Step 2: Choose an endpoint

    Pass a username, URL, keyword, or post ID.

  3. 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.

Explore integrations

Pricing

Social data, priced simply.

Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.

Starter

$29.00

18,000credits

  • Top up from $1.61 / 1k if you run out
  • Up to 25 monitors
Most popular

Growth

$79.00

50,000credits

  • Top up from $1.58 / 1k if you run out
  • 5 team seats
  • Up to 100 monitors

Scale

$225.00

150,000credits

  • 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.”

Daniel Reeve · Founder, Social Crow
  • “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. 1. Create an API key

    Sign up at Social Fetch and copy a key (sfk_…). New accounts get 100 free credits.

  2. 2. Ask for a series or a search

    Send GET /v1/economy/consumer-spend?country=DE,FR&category=total,transport or GET /v1/economy/government-contracts?recipient=Lockheed%20Martin with x-api-key.

  3. 3. Page, filter and credit

    Follow page.nextCursor on contract search, and show source.attribution where 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