财报日历搜索 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 驱动的学术级金融研究、文献综述和投资分析而构建。