Economy Government Contracts API
Scrape Economy Government Contracts data with one API call. Searches individual US federal contract awards (purchase orders, delivery orders, definitive contracts and blanket purchase agreement calls) from USAspending.gov, the official US government source for federal spending. Send at least one of `recipient` (a company name, matched as text), `keyword` (matched against the award description), `naics` or `psc`. The window defaults to the most recent US federal fiscal year that ended at least 90 days ago, and it matches awards with activity in that window, so `start_date` can be earlier and `amount` is the total value obligated to the award so far, not spend inside the window. Results come back under `data.items[]`, each `{ award_id, generated_id, type, recipient_name, recipient_uei, amount, awarding_agency, awarding_sub_agency, naics, psc, description, start_date, end_date, place_of_performance: { state, city, country }, url }`. `type` is `purchase_order`, `delivery_order`, `definitive_contract` or `bpa_call`. A foreign award has a null `place_of_performance.state`. Sorted by `amount`, largest first, unless you set `sort` and `order`. Paginate with `page` (1 based) or the universal `cursor`; the response's `pagination` block carries `has_more` and `next_cursor`. `data.total` is the full number of matching contracts. A search can be paged to 50,000 results (`page` x `limit`); a deeper page is a refunded 400, so narrow the filters to reach the rest. No match is a 200 with an empty `items` and is not billed.
Last updated October 2026Maintained by the SocialCrawl team
Returns individual US federal contract awards with recipient, amount, awarding agency, NAICS and PSC codes, dates and place of performance, one page at a time.
Use it to find purchase orders and contracts for a company, keyword, industry or product code; use government-spend for totals by place.
Searching 68 platforms in parallel
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchWhat can you do with the Government Contracts API?
The Government Contracts endpoint gives you structured Economy data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/economy/government-contracts?naics=4811&type=purchase_order&limit=10"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/economy/government-contracts",
params={
'naics': '4811',
'type': 'purchase_order',
'limit': '10',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/economy/government-contracts?naics=4811&type=purchase_order&limit=10",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| recipient | No | Company or organisation name to match, up to 120 characters, for example `Lockheed Martin`. Matched as text against the recipient name, so a short name also finds related entities. |
| 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. |
| 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. |
| 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. |
| type | No | Limit to one award type: `purchase_order`, `delivery_order`, `definitive_contract` or `bpa_call`. `all` (default) returns all four. (purchase_order | delivery_order | definitive_contract | bpa_call | all) |
| sort | No | Sort field: `amount` (default), `start_date`, `end_date` or `recipient`. (amount | start_date | end_date | recipient) |
| order | No | `desc` (default) or `asc`. (asc | desc) |
| limit | No | Awards per page, 1 to 100. Defaults to 25. |
| page | No | Page number, starting at 1. `page` x `limit` cannot exceed 50,000, so with `limit` 100 the last page is 500 and a deeper page is a refunded 400. The universal `cursor` returned in `pagination.next_cursor` is the simpler way to continue. |
What does the Economy Government Contracts API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "economy",
"endpoint": "/v1/economy/government-contracts",
"data": {
"items": [
{
"award_id": "HT942525P0037",
"generated_id": "CONT_AWD_HT942525P0037_9700_-NONE-_-NONE-",
"type": "purchase_order",
"recipient_name": "ENVIGO GLOBAL SERVICES INC",
"recipient_uei": "QW88E71LU7M4",
"amount": 568510.04,
"awarding_agency": "Department of Defense",
"awarding_sub_agency": "Defense Health Agency",
"naics": {
"code": "481112",
"description": "SCHEDULED FREIGHT AIR TRANSPORTATION"
},
"psc": {
"code": "V111",
"description": "TRANSPORTATION/TRAVEL/RELOCATION- TRANSPORTATION: AIR FREIGHT"
},
"description": "NON-PERSONAL SERVICES FOR THE TESTING AND TRANSPORTATION OF 18 NON-HUMAN PRIMATES",
"start_date": "2025-02-26",
"end_date": "2026-08-25",
"place_of_performance": {
"state": "MD",
"city": "SILVER SPRING",
"country": "USA"
},
"url": "https://www.usaspending.gov/award/CONT_AWD_HT942525P0037_9700_-NONE-_-NONE-"
},
{
"award_id": "693JK423P800006",
"generated_id": "CONT_AWD_693JK423P800006_6901_-NONE-_-NONE-",
"type": "purchase_order",
"recipient_name": "OAG AVIATION WORLDWIDE LLC",
"recipient_uei": "G4TJMJRKJ339",
"amount": 325831.5,
"awarding_agency": "Department of Transportation",
"awarding_sub_agency": "Immediate Office of the Secretary of Transportation",
"naics": {
"code": "481111",
"description": "SCHEDULED PASSENGER AIR TRANSPORTATION"
},
"psc": {
"code": "7A21",
"description": "IT AND TELECOM - BUSINESS APPLICATION SOFTWARE (PERPETUAL LICENSE SOFTWARE)"
},
"description": "THE PURPOSE OF THIS ACQUISITION IS TO OBTAIN AIRLINES SCHEDULE DATA AND SUPPORT (ASDS) FOR THE OFFICE OF AIRLINE INFORMATION (OAI) IS RESPONSIBLE FOR THE U.S. DEPARTMENT OF TRANSPORTATION'S (DOT'S) AVIATION STATISTICS PROGRAM, AS PROVIDED",
"start_date": "2023-04-26",
"end_date": "2027-04-30",
"place_of_performance": {
"state": "DC",
"city": "WASHINGTON",
"country": "USA"
},
"url": "https://www.usaspending.gov/award/CONT_AWD_693JK423P800006_6901_-NONE-_-NONE-"
}
],
"dropped": 0
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoiMiIsImUiOiJlY29ub215L2dvdmVybm1lbnQtY29udHJhY3RzIiwicCI6InBhZ2UifQ",
"has_more": true,
"page_size": 25
},
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-03T18:35:26.895Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the Economy Government Contracts API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I search US federal contract awards by company?
What do I have to send to get results?
What does the amount field mean?
How do I page through results?
Which award types are included?
How much does one page cost?
Ask AI about SocialCrawl
Ready to scrape Economy Government Contracts data?
Get your API key and start pulling Economy data in under 60 seconds.