SEC 공시 & 미국 재무 검색 API
한 엔드포인트로 SEC 공시(10-K, 10-Q, 8-K), 미국 실적 발표 트랜스크립트, 주식 통계를 쿼리. AI 기반 실사, 펀더멘털 분석, 금융 RAG를 위한 미리 정형화된 JSON.
API Integration Guide
Learn how to integrate this API into your applications with code examples and detailed documentation.
/api/search/secBase URL
https://www.apipick.comFull Endpoint
https://www.apipick.com/api/search/secqueryNatural-language search query
max_num_results1–5, default 5
relevance_threshold0.0–1.0 quality filter
country_codeISO country code (e.g. US, GB)
start_dateISO date YYYY-MM-DD
end_dateISO date YYYY-MM-DD
cURL Request
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"
}'YOUR_API_KEY with your actual API keyJSON 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
}✓Best Practices
- • Always include x-api-key header
- • Always handle errors gracefully
- • Validate input data before sending
- • Use HTTPS for secure communication
- • Cache responses when appropriate
ℹResponse Headers
- • Content-Type: application/json
- • x-api-key: Required for authentication
- • Status codes: 200 (success), 400 (error), 401 (unauthorized)
- • No rate limiting applied
Rate Limits
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
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
}자주 묻는 질문
왜 호출당 120 크레딧인가요(웹 검색은 15)?
SEC EDGAR 공시, 미국 실적 트랜스크립트, 주식 통계는 독점 데이터로 라이선스 비용이 비싸고 지속적인 인덱스 유지가 필요합니다. 120 크레딧(약 호출당 $0.12)은 그것을 반영하며 — 그래도 전용 SEC 분석 플랫폼의 API 시트 비용에 비하면 일부에 불과합니다.
어떤 공시 유형이 포함되나요?
모든 EDGAR 공시 — 10-K, 10-Q, 8-K, S-1, 위임장 등 — 미국 실적 발표 트랜스크립트와 계산된 주식 통계까지. 티커, 기업명, 자연어 쿼리를 전달하세요.
공시 전문도 가져올 수 있나요?
결과에는 출처 URL과 본문 단락이 포함됩니다. 전체 문서가 필요하면 URL에 POST /api/extract를 이어 호출하면 LLM 흡수에 적합한 깔끔한 마크다운을 받을 수 있습니다.
날짜 필터링은요?
네. start_date와 end_date를 YYYY-MM-DD로 전달해 결과를 특정 공시 윈도우로 한정할 수 있습니다.
OpenAI / Claude용 도구 스키마는?
GET /api/search/sec/tool-schema가 바로 붙여 넣을 수 있는 OpenAI 함수와 Claude 도구 사용 정의를 반환합니다.