Economy Government Contracts API
API 한 번의 호출로 Economy Government Contracts 데이터를 받아 가세요. 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.
2026년 10월 업데이트SocialCrawl 팀이 직접 관리해요
수령 기업, 금액, 발주 기관, NAICS와 PSC 코드, 기간, 수행 지역이 담긴 미국 연방 계약 건을 한 페이지씩 돌려줍니다.
기업명, 키워드, 산업, 품목 코드로 구매 주문과 계약을 찾을 때 사용합니다. 지역별 합계는 government-spend를 쓰세요.
68개 플랫폼을 병렬로 검색합니다
Government Contracts API로 무엇을 할 수 있을까요
Government Contracts 엔드포인트가 통합 스키마와 계산 필드를 담은 Economy 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.
요청 예시
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();파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
| recipient | 아니오 | 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 | 아니오 | 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 | 아니오 | 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 | 아니오 | 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 | 아니오 | 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 | 아니오 | 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 | 아니오 | 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 | 아니오 | Sort field: `amount` (default), `start_date`, `end_date` or `recipient`. (amount | start_date | end_date | recipient) |
| order | 아니오 | `desc` (default) or `asc`. (asc | desc) |
| limit | 아니오 | Awards per page, 1 to 100. Defaults to 25. |
| page | 아니오 | 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. |
Economy Government Contracts API는 무엇을 돌려주나요
모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.
응답 예시 보기
{
"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
}통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.
Economy Government Contracts API는 어떻게 동작하나요
API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.
메서드
GET
응답 형식
JSON
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 68개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 68개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.
코드 한 줄 쓰기 전에, 데이터부터
Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.
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"
}
}
}자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기기업별 미국 연방 정부 계약은 어떻게 검색하나요?
결과를 받으려면 무엇을 보내야 하나요?
amount 필드는 무엇을 뜻하나요?
다음 페이지는 어떻게 받나요?
어떤 계약 유형이 포함되나요?
한 페이지에 요금이 얼마인가요?
AI에게 SocialCrawl을 물어보세요
Economy Government Contracts 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 Economy 데이터를 받아 가세요.
