> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/economy>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/economy.mdx>

---

# 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

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.

## What you can get

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

## Economy endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Consumer spending | GET /v1/economy/consumer-spend | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/economy/consumer-spend/get) |
| Tourism spending | GET /v1/economy/tourism-spend | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/economy/tourism-spend/get) |
| Government spending | GET /v1/economy/government-spend | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/economy/government-spend/get) |
| Government contracts | GET /v1/economy/government-contracts | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/economy/government-contracts/get) |
| Importer shipments | GET /v1/economy/imports | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/economy/imports/get) |

## How to start

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,transport` or `GET /v1/economy/government-contracts?recipient=Lockheed%20Martin` with `x-api-key`.
3. **Page, filter and credit.** Follow `page.nextCursor` on contract search, and show `source.attribution` where you publish the figures.

## Pricing

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.

## Compared with the official 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.

## FAQ

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

## Related

- [Consumer Spending API](https://www.socialfetch.dev/platforms/economy/consumer-spend): Household spending by country and category (`GET /v1/economy/consumer-spend`).
- [Tourism Spending API](https://www.socialfetch.dev/platforms/economy/tourism-spend): Travel spending by country and category (`GET /v1/economy/tourism-spend`).
- [Government Spending API](https://www.socialfetch.dev/platforms/economy/government-spend): US federal spending by region (`GET /v1/economy/government-spend`).
- [Government Contracts API](https://www.socialfetch.dev/platforms/economy/government-contracts): US federal contract awards (`GET /v1/economy/government-contracts`).
- [Import Data API](https://www.socialfetch.dev/platforms/economy/imports): A US importer's suppliers and shipments (`GET /v1/economy/imports`).
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call the Economy tools from Cursor or Claude with the same credit metering as REST.
