apipick
[ search · endpoint ]검색 API · 재무

기업 재무 검색 API

미국 상장기업의 재무상태표, 손익계산서, 현금흐름표, 배당, 내부자 거래를 단일 엔드포인트로 조회. AI 기반 기본적 분석, 실사, 투자 리서치를 위한 미리 정형화된 JSON.

●200 크레딧 / 호출●30 요청 / 분POST /api/search/financials
[ 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/financials
base
https://www.apipick.com

미국 기업의 재무상태표, 손익계산서, 현금흐름표, 배당, 내부자 거래 전반의 시맨틱 검색. 다운스트림 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/financials" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Apple balance sheet for the latest quarter",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
● 200 · response
{
  "query": "Apple balance sheet for the latest quarter",
  "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": 200,
  "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

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

구조화된 기업 펀더멘털 — 재무상태표, 손익계산서, 현금흐름, 배당, 내부자 신고 — 는 라이선스와 정규화 비용이 가장 높은 데이터셋이므로 엔드포인트는 200크레딧(호출당 약 $0.20)으로 책정됩니다. 그래도 펀더멘털 단말기 좌석의 일부에 불과합니다.

02

어떤 재무제표가 포함되나요?

미국 상장기업의 재무상태표, 손익계산서, 현금흐름표, 배당 이력, 내부자 거래. 티커 또는 자연어 쿼리를 전달하면 모두 병렬로 조회됩니다.

03

어떤 기업인가요?

미국 상장기업입니다. 티커(예: AAPL) 또는 기업명을 전달하세요. 제출 서류 본문과 실적 발표 녹취록은 SEC 제출 서류 검색 엔드포인트를 이용하세요.

04

날짜 필터링은요?

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

05

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

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