Economy Government Spend API
산업, 품목 코드, 주제별 미국 연방 지출을 주, 카운티, 국가 단위로 합산해 금액이 큰 순서로 돌려줍니다.
GET /v1/economy/government-spendEconomy Government Spend API는 언제 쓰나요
항공 여행 같은 산업에 연방 예산이 어느 지역으로 흘러가는지 보거나 지역별 지출을 비교할 때 사용합니다.
API 레퍼런스 영문 원문
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.
75개 플랫폼을 하나의 API로 제공합니다
Government Spend API로 무엇을 할 수 있을까요
Government Spend 엔드포인트가 통합 스키마와 계산 필드를 담은 Economy 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.
요청 예시
# GET /v1/economy/government-spend: 1 credit per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 60: the API's own time limit for this endpoint.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 60 --retry 3 -o response.json \
-H "x-api-key: YOUR_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://www.socialcrawl.dev/v1/economy/government-spend?naics=4811&from_date=2024-10-01&to_date=2025-09-30" && cat response.json# GET /v1/economy/government-spend: 1 credit per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid
import requests
API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 60 # the API's own time limit for this endpoint.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/economy/government-spend"
def backoff(attempt):
# Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
return 2 ** attempt * (0.5 + random.random() / 2)
def socialcrawl(params):
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
idempotency_key = str(uuid.uuid4())
for attempt in range(MAX_RETRIES + 1):
try:
res = requests.get(
URL,
params=params,
headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
timeout=TIMEOUT_S,
)
body = res.json()
except (requests.RequestException, ValueError):
# A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if attempt == MAX_RETRIES:
raise
time.sleep(backoff(attempt))
continue
if body["success"]:
return body
error = body["error"]
# Branch on error["type"], never on the message text.
if error["type"] == "RESOURCE_NOT_FOUND":
return None # refunded: nothing to read
retry_after = res.headers.get("Retry-After")
# SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
# Retry-After (seconds) wins; otherwise back off.
time.sleep(float(retry_after) if retry_after else backoff(attempt))
params = {
"naics": "4811",
"from_date": "2024-10-01",
"to_date": "2025-09-30",
}
body = socialcrawl(params)
if body is not None:
print(body["data"])// GET /v1/economy/government-spend: 1 credit per call. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 60_000; // the API's own time limit for this endpoint.
const MAX_RETRIES = 3;
type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
| { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
| { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);
async function socialcrawl(url: URL) {
// One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
const idempotencyKey = crypto.randomUUID();
for (let attempt = 0; ; attempt++) {
let res: Response;
let body: SocialCrawlResponse;
try {
res = await fetch(url, {
headers: {
"x-api-key": API_KEY,
"Idempotency-Key": idempotencyKey,
},
signal: AbortSignal.timeout(TIMEOUT_MS),
});
body = (await res.json()) as SocialCrawlResponse;
} catch (error) {
// A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if (attempt >= MAX_RETRIES) throw error;
await sleep(backoffMs(attempt));
continue;
}
if (body.success) return body;
// Branch on error.type, never on the message text.
if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
const retryAfter = res.headers.get("Retry-After");
// SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
}
// Retry-After (seconds) wins; otherwise back off.
await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
}
}
const url = new URL("https://www.socialcrawl.dev/v1/economy/government-spend");
url.searchParams.set("naics", "4811");
url.searchParams.set("from_date", "2024-10-01");
url.searchParams.set("to_date", "2025-09-30");
const body = await socialcrawl(url);
if (body) console.log(body.data);파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
| 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. |
| 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. |
| 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. |
| geo | 아니오 | Geography layer: `state` (default), `county` or `country`. (state | county | country) |
| scope | 아니오 | `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 | 아니오 | `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) |
Economy Government Spend API는 무엇을 돌려주나요
모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.
응답 예시 보기
{
"success": true,
"platform": "economy",
"endpoint": "/v1/economy/government-spend",
"data": {
"filters": {
"from_date": "2024-10-01",
"to_date": "2025-09-30",
"scope": "place_of_performance",
"award_type": "contracts",
"naics": [
"4811"
]
},
"geo_layer": "state",
"total_amount": 40801593.11,
"regions": [
{
"code": "WA",
"name": "Washington",
"amount": 7069768.11,
"population": 7705281,
"per_capita": 0.92
},
{
"code": "GA",
"name": "Georgia",
"amount": 6901096.24,
"population": 10711908,
"per_capita": 0.64
}
]
},
"credits_used": 0,
"request_id": "req_example000000",
"cached": true,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-03T18:35:27.619Z",
"redacted": true
}통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.
Economy Government Spend API는 어떻게 동작하나요
API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.
메서드
GET
응답 형식
JSON
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 75개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 75개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 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, 요금제, 기능에 대한 질문과 답변입니다.
문의하기산업별 미국 연방 정부 지출을 주 단위로 보려면 어떻게 하나요?
결과 예시를 볼 수 있나요?
주 말고 카운티나 국가별로도 볼 수 있나요?
수행 장소와 수혜자 소재지는 어떻게 다른가요?
계약뿐 아니라 보조금도 볼 수 있나요?
호출 한 번에 요금이 얼마인가요?
AI에게 SocialCrawl을 물어보세요
Economy Government Spend 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 Economy 데이터를 받아 가세요.
