# Economy Government Spend API (https://www.socialcrawl.dev/platforms/economy/government-spend)

> Returns how much the US federal government spent, by geography, for an industry, a product or service, or a topic. Data comes from USAspending.gov, the official US government source for federal spending. Narrow it with `naics` (industry), `psc` (product or service code) and `keyword`, or send none to see all spending. The window defaults to the most recent US federal fiscal year that ended at least 90 days ago (agencies report with a lag, so a year that just ended is only partly reported), and any window since 2007-10-01 is allowed. `award_type` is `contracts` by default, with `grants` and `all` available. `geo` picks the layer: `state` (USPS codes, with DC and territories), `county` (5 digit FIPS codes) or `country` (ISO alpha-3 codes, which is how foreign place of performance appears). `scope` chooses whether spending is placed where the work is done (`place_of_performance`, the default) or where the recipient is based (`recipient_location`). Amounts are US dollars of federal obligations recorded in the window. The response is `data.regions[]`, sorted by amount, largest first, each `{ code, name, amount, population, per_capita }` (the last two when the source publishes them), plus `data.total_amount`, `data.geo_layer` and a `data.filters` echo of what was applied. A combination with no spending returns 404 and is not billed.

TL;DR: `GET /v1/economy/government-spend` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `naics` | no | Industry filter: one or more NAICS codes, comma-separated (up to 20). Each code must be 2, 4 or 6 digits, and a shorter code matches the whole family, so `4811` covers scheduled air transportation and `48` covers all transportation. |
| `psc` | no | Product or service code filter: one or more codes, comma-separated (up to 20), 1 to 4 characters each. A shorter code matches the family, so `V` is all transportation, travel and relocation services and `V301` is travel agent services. |
| `keyword` | no | Free-text match against award descriptions, 3 to 120 characters. Use it for a topic such as `travel` that no single industry code captures. |
| `from_date` | no | Start of the window, `YYYY-MM-DD`, no earlier than 2007-10-01. Defaults to the first day of the most recent US federal fiscal year (1 October to 30 September) that ended at least 90 days ago, because agencies report with a lag and a year that just ended is only partly reported. Send only this and the window runs to today. |
| `to_date` | no | End of the window, `YYYY-MM-DD`. Defaults to the last day of the most recent US federal fiscal year that ended at least 90 days ago (30 September). Send only this and the window starts one year earlier. |
| `geo` | no | Geography layer: `state` (default), `county` or `country`. (state \| county \| country) |
| `scope` | no | `place_of_performance` (default) places spending where the work is done. `recipient_location` places it where the recipient is based. (place_of_performance \| recipient_location) |
| `award_type` | no | `contracts` (default) is purchase orders, delivery orders, definitive contracts and blanket purchase agreement calls. `grants` is grants and cooperative agreements. `all` is every award type. (contracts \| grants \| all) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/economy/government-spend" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I see US federal spending by state for an industry?

Send GET /v1/economy/government-spend with a NAICS code, for example naics=4811. The response lists states largest first, each with a code, name and amount, plus a total for the window. The window defaults to the last full US federal fiscal year.

### What is an example result from government-spend?

For NAICS 4811, scheduled air transportation, fiscal year 2025, Washington comes first at about $7.07 million and Georgia second at about $6.90 million. Amounts are US dollars of federal obligations recorded in the window.

### Can I get spending by county or country instead of state?

Yes. Set geo=county for 5 digit FIPS codes or geo=country for ISO alpha-3 codes, which is how foreign place of performance appears. The default is state.

### What is the difference between place of performance and recipient location?

scope=place_of_performance, the default, puts spending where the work is done. scope=recipient_location puts it where the recipient is based. The two can differ a lot for national contractors.

### Does it cover grants as well as contracts?

Yes. award_type is contracts by default. Set grants for grants and cooperative agreements, or all for every award type. Any window since 2007-10-01 is allowed.

### How much does one government-spend call cost?

1 credit on the standard tier. A combination with no spending returns 404 and is not billed. New accounts get 100 free credits with no card, and a repeat within the cache window costs 0 credits.

See the full Economy API: https://www.socialcrawl.dev/platforms/economy

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

- How much does the US government spend on an industry by state?
- Is there an API for USAspending.gov data?
- How to get federal spending by NAICS code