財報行事曆搜尋 API
在單一端點查詢美股財報行事曆，取得即將與近期的公布日期、EPS 與營收預估，以及盤前/盤後時段。預先成型的 JSON，適用於事件驅動交易與 AI 驅動的金融研究。
什麼是 財報行事曆搜尋 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 秒滑動視窗。觸發限制時會回傳乾淨的 429，並帶 Retry-After 回應標頭。
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 搜尋擷取的是歷史申報與法說會逐字稿；財報行事曆則是前瞻性的——它會告訴你公司預計何時公布財報，以及市場的預期。
支援日期篩選嗎？
支援。以 YYYY-MM-DD 格式傳入 start_date 與 end_date，即可將結果限定在特定的財報公布區間。
OpenAI / Claude 的工具 schema？
GET /api/search/earnings-calendar/tool-schema 會回傳可直接貼上的 OpenAI 函式與 Claude 工具呼叫定義。
探索其他搜尋 API
為 LLM 工具呼叫而生的即時語意網頁搜尋。回傳排序過的標題、URL 與乾淨摘要,已預先成型供智慧代理消費。支援國家與日期篩選。
涵蓋主流媒體的即時新聞搜尋。日期範圍與國家篩選,適合時效性查詢。為晨間簡報、市場新聞智慧代理與 RAG 管線而生。
單次呼叫從最多 25 個 URL 擷取乾淨易讀內容。剝離廣告、導覽與樣板;回傳類 Markdown 文字,可供 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 答案的機率支撐而生。
透過單一端點對英國判例法與初級立法進行語意搜尋。為法律研究、法遵審查、法令解釋與 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 驅動的學術級金融研究、文獻回顧與投資分析而生。