실적 발표 캘린더 검색 API
미국 실적 발표 캘린더에서 예정·최근 보고일, EPS 및 매출 추정치, 장전/장후 발표 시점을 하나의 엔드포인트로 조회. 이벤트 기반 트레이딩과 AI 기반 금융 리서치를 위한 미리 정형화된 JSON.
실적 발표 캘린더 검색 API란?
미국 실적 발표 캘린더 전반의 시맨틱 검색. 다운스트림 LLM에 바로 사용 가능하도록 추정치와 발표 시점이 담긴 순위화된 보고 이벤트 반환.
- 엔드포인트
- POST /api/search/earnings-calendar
- 인증
- API 키 · x-api-key 헤더
- 비용
- 120 크레딧 / 호출
- 속도 제한
- 30 요청 / 분
- 응답
- 구조화된 JSON
통합 가이드
스니펫을 복사하고 API 키를 교체한 뒤 실행하세요. 모든 HTTP 클라이언트에서 작동합니다 — 아래에 cURL, JavaScript, Python 예제가 있습니다.
/api/search/earnings-calendarhttps://www.apipick.com미국 실적 발표 캘린더 전반의 시맨틱 검색. 다운스트림 LLM에 바로 사용 가능하도록 추정치와 발표 시점이 담긴 순위화된 보고 이벤트 반환.
querystring필수Natural-language search query
max_num_resultsinteger선택1–5, default 5
relevance_thresholdnumber선택0.0–1.0 quality filter
country_codestring선택ISO country code (e.g. US, GB)
start_datestring선택ISO date YYYY-MM-DD
end_datestring선택ISO date YYYY-MM-DD
curl -X POST "https://www.apipick.com/api/search/earnings-calendar" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"query": "Nvidia upcoming earnings date",
"max_num_results": 5,
"country_code": "US",
"start_date": "2026-01-01"
}'{
"query": "Nvidia upcoming earnings date",
"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
}요청 제한
스로틀링은 API 키 단위, 60초 슬라이딩 윈도우입니다. 한도에 도달하면 Retry-After 헤더가 포함된 깔끔한 429를 받습니다.
30req/min
API 키별, 엔드포인트별. 60초 슬라이딩 윈도우.
3concurrent
API 키당 동시에 처리 중인 최대 요청 수.
X-RateLimit-Limit분당 허용되는 최대 요청 수X-RateLimit-Remaining현재 윈도우에 남은 요청 수X-RateLimit-Reset현재 윈도우가 초기화되기까지의 초Retry-After재시도 전 대기 초 (429일 때만)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크레딧인가요?
실적 발표 캘린더 데이터는 독점적이고 구조화되어 있으며 지속적으로 업데이트되고 상위 공급처에서 프리미엄으로 책정됩니다. 120크레딧(호출당 약 $0.12)으로도 전용 시장 데이터 터미널보다 훨씬 저렴합니다.
무엇을 반환하나요?
미국 상장 기업의 예정·최근 분기 보고일, EPS 및 매출 추정치, 보고 시점(장전 또는 장후)을 쿼리 관련성 순으로 반환합니다.
SEC 검색과 무엇이 다른가요?
SEC 검색은 과거 공시와 실적 발표 녹취록을 조회합니다. 실적 발표 캘린더는 미래 지향적입니다 — 기업이 언제 보고할 것으로 예상되며 시장(Street)이 무엇을 기대하는지 알려줍니다.
날짜 필터링은요?
예. start_date와 end_date를 YYYY-MM-DD 형식으로 전달하면 특정 보고 기간으로 범위를 좁힐 수 있습니다.
OpenAI / Claude용 도구 스키마는요?
GET /api/search/earnings-calendar/tool-schema가 바로 붙여넣을 수 있는 OpenAI 함수 및 Claude 도구 사용 정의를 반환합니다.
다른 검색 API 살펴보기
LLM 도구 호출을 위해 제작된 실시간 시맨틱 웹 검색. 에이전트 소비용으로 미리 정형화된 순위 제목, URL, 깔끔한 스니펫을 반환. 국가·날짜 필터 지원.
주요 매체에 걸친 실시간 뉴스 검색. 시간 민감 쿼리를 위한 날짜 범위·국가 필터링. 아침 브리핑, 시장 뉴스 에이전트, RAG 파이프라인을 위해 제작.
한 번의 호출로 최대 25개 URL에서 깔끔하고 읽기 쉬운 콘텐츠를 추출. 광고·내비·보일러플레이트 제거 후 LLM이 바로 소비할 수 있는 마크다운풍 텍스트 반환. URL당 2 크레딧.
단일 엔드포인트로 arXiv, PubMed, bioRxiv, medRxiv의 동료 평가 논문과 프리프린트를 검색. AI 기반 문헌 검토, 과학 코퍼스 RAG, 인용 추출을 위해 제작.
임상시험, FDA 약물 라벨, ChEMBL 생물활성을 검색. 의학 연구, 약물 재포지셔닝, AI 기반 임상 의사결정 지원 워크플로를 위해 제작.
SEC 공시(10-K, 10-Q, 8-K), 미국 실적 발표 트랜스크립트, 주식 통계를 검색. AI 기반 실사, 펀더멘털 분석, 금융 RAG 파이프라인을 위해 제작.
USPTO, EPO, WIPO, 주요 국가 특허청에 걸친 글로벌 특허 출원 시맨틱 검색. 선행기술 조사, IP 풍경 분석, AI 기반 경쟁 인텔리전스를 위해 제작.
정치, 경제, 스포츠, 시사에 대한 Polymarket과 Kalshi 예측 시장 계약을 검색. 군중 예측 검색과 LLM 답변의 확률 근거 제공을 위해 제작.
단일 엔드포인트로 영국 판례법과 1차 입법을 시맨틱 검색. 법률 리서치, 컴플라이언스 검토, 법령 해석, AI 기반 리걸테크 워크플로를 위해 제작.
CISA 알려진 악용 취약점(KEV), NVD CVE 레코드, EPSS 악용 점수, MITRE ATT&CK 기법을 검색. AI 기반 취약점 분류, 위협 인텔리전스, 보안 운영을 위해 제작.
글로벌 및 미국 주식, 암호화폐, 외환, ETF, 펀드, 원자재, 미국 마켓 무버를 검색. AI 기반 가격 조회, 시장 데이터 검색, 트레이딩 리서치를 위해 제작.
FRED, 미국 노동통계국, 세계은행 지표, IMF 거시 데이터, 미국 연방 지출, 독일 노동 통계를 검색. AI 기반 거시경제 리서치와 분석을 위해 제작.
미국 상장기업의 재무상태표, 손익계산서, 현금흐름표, 배당, 내부자 거래를 검색. AI 기반 기본적 분석과 실사를 위해 제작.
ChEMBL 생물활성, PubChem 화학 구조, Open Targets 표적-질환 연관성을 검색. AI 기반 신약 개발, 케모인포매틱스, 생의학 연구를 위해 제작.
NCBI Gene, dbSNP, ClinVar, dbVar, MedGen, GTR에서 유전자, 변이, 임상적 의의를 검색. AI 기반 유전체 및 변이 해석 연구를 위해 제작.
NCBI Nucleotide, Protein, Genome, Assembly, CDD, Structure에서 서열, 어셈블리, 단백질 도메인을 검색. AI 기반 생명정보학을 위해 제작.
NCBI SRA, GEO, BioSample, BioProject, dbGaP, Taxonomy에서 시퀀싱 런, 발현 데이터셋, 생물종 데이터를 검색. AI 기반 오믹스 데이터 탐색을 위해 제작.
WHO 글로벌 보건 통계, NIH 연구비, openFDA 약물 이상사례 보고를 검색. AI 기반 공중보건 연구, 연구비 탐색, 약물감시를 위해 제작.
영국 의회 토론, 서면 질의, 의원 활동(Hansard)을 검색. AI 기반 시빅테크 도구, 입법 모니터링, 정책 연구를 위해 제작.
라이선스가 부여된 Wiley 금융 저널과 교과서를 검색. AI 기반 학술 수준의 금융 연구, 문헌 검토, 투자 분석을 위해 제작.