# Economy Data API (https://www.socialcrawl.dev/platforms/economy)

> Economy API: official EU household and travel spending, US federal spending and contract awards, and a US importer's overseas suppliers, as JSON on one key. Eurostat and USAspending.gov are the named origins.

TL;DR: SocialCrawl's Economy API exposes 5 endpoints, 1 to 20 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Consumer Spend | GET | `/v1/economy/consumer-spend` | 1 | Get household spending by country and category |
| Tourism Spend | GET | `/v1/economy/tourism-spend` | 1 | Get travel spending by country and category |
| Government Spend | GET | `/v1/economy/government-spend` | 1 | Get US federal spending by state, county or country |
| Government Contracts | GET | `/v1/economy/government-contracts` | 1 | Search US federal contract awards |
| Imports | GET | `/v1/economy/imports` | 20 | Get a US importer's suppliers and shipments |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/economy/consumer-spend" \
  --data-urlencode "country_code=DE,FR" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs Calling each source directly

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

## FAQ

### What is the SocialCrawl Economy API?

It is 5 endpoints that return official economic data as JSON on the same key as the social endpoints: household and travel spending by country, US federal spending and contract awards, and a US importer's overseas suppliers. Eurostat and USAspending.gov are the data origin for the first four, and US customs bill-of-lading records back the importer lookup.

### Is there an API for Eurostat consumer spending data?

Yes. GET /v1/economy/consumer-spend takes one or more country codes and returns annual household spending by COICOP category, such as food, housing and transport, as a series of year and value points. Choose euro millions, euro per capita or share of total. A year Eurostat has not published is null, never 0.

### How do I find how much US federal money goes to an industry?

Call GET /v1/economy/government-spend with a NAICS code, for example naics=4811 for scheduled air transportation. You get spending by state, county or country, largest first, with a total for the window. Narrow it with psc, keyword, a date range or award_type, and it defaults to the last full US federal fiscal year.

### Can I search individual US federal contract awards?

Yes. GET /v1/economy/government-contracts needs one of recipient, keyword, naics or psc and returns award rows with recipient, amount, awarding agency, NAICS, description, dates and place of performance. Paginate with page or the cursor. A search with no match returns an empty list and is not billed.

### Can I see who a US company imports from?

Yes. GET /v1/economy/imports takes a company name and returns its top overseas suppliers with shipment counts, the HS headings it ships, and the latest bills of lading. The brand name Nike resolves to the filer Nike Usa, and the selection field says how the match was chosen. Only US ocean-freight imports are covered.

### How much does the Economy API cost?

Spending and contract endpoints cost 1 credit per call, and the importer lookup costs 20 credits whatever the limit. New accounts get 100 free credits with no card. A search that finds nothing returns 404 or an empty list and is refunded, and exact repeats within the cache window cost 0 credits.

### How current is the Economy data?

It follows each source's own publishing schedule. Eurostat figures are annual and the latest years are often provisional, USAspending.gov reflects awards as agencies report them, and customs manifests post in daily batches with a lag of days. Responses are cached for up to a day, and the response carries the dataset and source note so you can see what you received.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- Is there an API for Eurostat household spending data?
- How do I get US federal contract awards as JSON?
- How to find which overseas suppliers a US company imports from
- What is the best API for official economic data?