[ search · endpoint ]검색 API · SEC

SEC 공시 & 미국 재무 검색 API

한 엔드포인트로 SEC 공시(10-K, 10-Q, 8-K), 미국 실적 발표 트랜스크립트, 주식 통계를 쿼리. AI 기반 실사, 펀더멘털 분석, 금융 RAG를 위한 미리 정형화된 JSON.

120 크레딧 / 호출30 요청 / 분POST /api/search/sec
[ 01 · live ]

SEC 검색 라이브 사용

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

auth · x-api-key

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/sec
base
https://www.apipick.com

SEC EDGAR 공시, 미국 실적 트랜스크립트, 주식 통계 전반의 시맨틱 검색. 다운스트림 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/sec" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Latest Nvidia statistics",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
● 200 · response
{
  "query": "Latest Nvidia statistics",
  "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": 120,
  "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

30req/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: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

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

자주 묻는 질문

01

왜 호출당 120 크레딧인가요(웹 검색은 15)?

SEC EDGAR 공시, 미국 실적 트랜스크립트, 주식 통계는 독점 데이터로 라이선스 비용이 비싸고 지속적인 인덱스 유지가 필요합니다. 120 크레딧(약 호출당 $0.12)은 그것을 반영하며 — 그래도 전용 SEC 분석 플랫폼의 API 시트 비용에 비하면 일부에 불과합니다.

02

어떤 공시 유형이 포함되나요?

모든 EDGAR 공시 — 10-K, 10-Q, 8-K, S-1, 위임장 등 — 미국 실적 발표 트랜스크립트와 계산된 주식 통계까지. 티커, 기업명, 자연어 쿼리를 전달하세요.

03

공시 전문도 가져올 수 있나요?

결과에는 출처 URL과 본문 단락이 포함됩니다. 전체 문서가 필요하면 URL에 POST /api/extract를 이어 호출하면 LLM 흡수에 적합한 깔끔한 마크다운을 받을 수 있습니다.

04

날짜 필터링은요?

네. start_dateend_dateYYYY-MM-DD로 전달해 결과를 특정 공시 윈도우로 한정할 수 있습니다.

05

OpenAI / Claude용 도구 스키마는?

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