apipick
[ search · endpoint ]검색 API · 경제

경제 지표 검색 API

FRED, 미국 노동통계국, 세계은행 지표, IMF 거시 데이터, 미국 연방 지출, 독일 노동 통계를 단일 엔드포인트로 조회. AI 기반 거시경제 리서치와 분석을 위한 미리 정형화된 JSON.

●50 크레딧 / 호출●60 요청 / 분POST /api/search/economic
[ 01 · live ]

경제 데이터 검색 라이브 체험

API 키를 입력하고 라이브 엔드포인트에 실제 쿼리를 실행하세요.

auth · x-api-key

API 키가 없으신가요?

계정에 로그인하여 API 키를 생성하고 관리하세요.

로그인API 키 관리
5개 샘플 쿼리 — 클릭하여 불러오기
[ 02 · integrate ]

Integration guide

Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and Python.

spec
POST/api/search/economic
base
https://www.apipick.com

FRED, BLS, 세계은행, IMF, USAspending, Destatis 전반의 시맨틱 검색. 다운스트림 LLM에 바로 사용 가능한 순위화된 레코드와 출처 URL 반환.

parameters
querystringrequired

Natural-language search query

max_num_resultsintegeroptional

1–5, default 5

relevance_thresholdnumberoptional

0.0–1.0 quality filter

country_codestringoptional

ISO country code (e.g. US, GB)

start_datestringoptional

ISO date YYYY-MM-DD

end_datestringoptional

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/economic" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "US unemployment rate over the past two years",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
● 200 · response
{
  "query": "US unemployment rate over the past two years",
  "results": [
    {
      "title": "Example result",
      "url": "https://example.com/article",
      "snippet": "Short excerpt of the page content…",
      "source_type": "web",
      "published_at": "2026-04-15",
      "score": 0.92
    }
  ],
  "result_count": 1,
  "credits_used": 50,
  "remaining_credits": 99
}
[ 03 · limits ]

Rate limits

Throttling is per API key, sliding 60-second window. Hit the limit and you get a clean 429 with a Retry-After header.

request rate

60req/min

Per API key, per endpoint. Sliding 60-second window.

concurrency

3concurrent

Max simultaneous in-flight requests per API key.

response headers
X-RateLimit-LimitMaximum requests allowed per minute
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetSeconds until the current window resets
Retry-AfterSeconds to wait before retrying (only on 429)
● 429 · too many requests
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 60 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}
[ faq ]

자주 묻는 질문

01

왜 호출당 50크레딧인가요?

이 여섯 개의 정부·기관 데이터셋은 집계와 인덱스 유지보수가 필요하므로 엔드포인트는 50크레딧(호출당 약 $0.05)으로 책정됩니다. 전용 거시 데이터 단말기보다 훨씬 저렴합니다.

02

어떤 소스가 포함되나요?

미국 연방준비제도 경제 데이터(FRED), 미국 노동통계국(BLS), 세계은행 개발 지표, IMF 거시·금융 지표, 미국 연방 지출(USAspending), 독일 노동 통계(Destatis). 모두 병렬로 조회됩니다.

03

특정 시리즈를 조회할 수 있나요?

예. 시리즈명 또는 '2024년 미국 실업률', '세계은행 인도 1인당 GDP' 같은 자연어 쿼리를 전달하면 엔드포인트가 가장 관련성 높은 레코드를 순위화합니다.

04

날짜 필터링은요?

예. start_date와 end_date를 YYYY-MM-DD 형식으로 전달하면 특정 기간으로 좁힐 수 있습니다.

05

OpenAI / Claude용 도구 스키마는요?

GET /api/search/economic/tool-schema가 바로 붙여넣을 수 있는 OpenAI 함수 및 Claude 도구 사용 정의를 반환합니다.