Earnings Calendar Search API
Query the US earnings calendar for upcoming and recent report dates, EPS and revenue estimates, and before/after-market timing from one endpoint. Pre-shaped JSON for event-driven trading and AI-driven financial research.
What is Earnings Calendar Search API?
Semantic search over the US earnings calendar. Returns ranked report events with estimates and timing, ready for downstream LLMs.
- Endpoint
- POST /api/search/earnings-calendar
- Authentication
- API key · x-api-key header
- Cost
- 120 credits / call
- Rate limit
- 30 req / min
- Response
- Structured JSON
Try Earnings Calendar Search Live
Enter your API key and run a real query against the live endpoint.
Don't have an API key?
Sign in to your account to create and manage your API keys.
Integration guide
Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and Python.
/api/search/earnings-calendarhttps://www.apipick.comSemantic search over the US earnings calendar. Returns ranked report events with estimates and timing, ready for downstream LLMs.
querystringrequiredNatural-language search query
max_num_resultsintegeroptional1–5, default 5
relevance_thresholdnumberoptional0.0–1.0 quality filter
country_codestringoptionalISO country code (e.g. US, GB)
start_datestringoptionalISO date YYYY-MM-DD
end_datestringoptionalISO 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
}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.
30req/min
Per API key, per endpoint. Sliding 60-second window.
3concurrent
Max simultaneous in-flight requests per API key.
X-RateLimit-LimitMaximum requests allowed per minuteX-RateLimit-RemainingRequests remaining in the current windowX-RateLimit-ResetSeconds until the current window resetsRetry-AfterSeconds to wait before retrying (only on 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
}Frequently Asked Questions
Why is this 120 credits per call?
Earnings-calendar data is proprietary, structured, and continuously updated, priced by the upstream at a premium; at 120 credits (≈ $0.12 per call) it stays well below dedicated market-data terminals.
What does it return?
Upcoming and recent quarterly report dates, EPS and revenue estimates, and reporting time (before or after market) for US-listed companies, ranked by relevance to your query.
How is this different from SEC search?
SEC Search retrieves historical filings and transcripts; the Earnings Calendar is forward-looking — it tells you when a company is expected to report and what the Street expects.
Date filtering?
Yes. Pass start_date and end_date in YYYY-MM-DD to scope results to a specific reporting window.
Tool schema for OpenAI / Claude?
GET /api/search/earnings-calendar/tool-schema returns ready-to-paste OpenAI function and Claude tool-use definitions.
Explore other search APIs
Real-time semantic web search built for LLM tool calling. Returns ranked titles, URLs, and clean snippets pre-shaped for agent consumption. Country and date filters supported.
Real-time news search across major outlets. Date-range and country filtering for time-sensitive queries. Built for morning briefings, market-news agents, and RAG pipelines.
Extract clean readable content from up to 25 URLs per call. Strips ads, nav, and boilerplate; returns markdown-flavoured text ready for LLM ingestion. 2 credits per URL.
Search peer-reviewed papers and pre-prints across arXiv, PubMed, bioRxiv, and medRxiv from one endpoint. Built for AI-driven literature review, RAG over scientific corpora, and citation extraction.
Search clinical trials, FDA drug labels, and ChEMBL bioactivity. Built for medical research, drug repurposing, and AI-driven clinical decision support workflows.
Search SEC filings (10-K, 10-Q, 8-K), US earnings call transcripts, and equity statistics. Built for AI-driven due diligence, fundamental analysis, and financial RAG pipelines.
Semantic search over global patent filings across USPTO, EPO, WIPO, and major national offices. Built for prior-art research, IP landscaping, and AI-driven competitive intelligence.
Search Polymarket and Kalshi prediction-market contracts on politics, economics, sports, and current events. Built for crowd-forecast retrieval and probability-grounded LLM answers.
Semantic search across UK case law and primary legislation from one endpoint. Built for legal research, compliance review, statutory interpretation, and AI-driven legal-tech workflows.
Search CISA Known Exploited Vulnerabilities, NVD CVE records, EPSS exploit scores, and MITRE ATT&CK techniques. Built for AI-driven vulnerability triage, threat intelligence, and security operations.
Search global and US equities, crypto, forex, ETFs, mutual funds, commodities, and US market movers. Built for AI-driven price lookups, market-data retrieval, and trading research.
Search FRED, US Bureau of Labor Statistics, World Bank indicators, IMF macro data, US federal spending, and German labour statistics. Built for AI-driven macroeconomic research and analysis.
Search US public-company balance sheets, income statements, cash flow statements, dividends, and insider transactions. Built for AI-driven fundamental analysis and due diligence.
Search ChEMBL bioactivity, PubChem chemical structures, and Open Targets target-disease associations. Built for AI-driven drug discovery, cheminformatics, and biomedical research.
Search NCBI Gene, dbSNP, ClinVar, dbVar, MedGen, and GTR for genes, variants, and clinical significance. Built for AI-driven genomics and variant-interpretation research.
Search NCBI Nucleotide, Protein, Genome, Assembly, CDD, and Structure for sequences, assemblies, and protein domains. Built for AI-driven bioinformatics.
Search NCBI SRA, GEO, BioSample, BioProject, dbGaP, and Taxonomy for sequencing runs, expression datasets, and organism data. Built for AI-driven omics data discovery.
Search WHO global health statistics, NIH research grants, and openFDA drug adverse-event reports. Built for AI-driven public-health research, grant discovery, and pharmacovigilance.
Search UK Parliament debates, written questions, and member activity (Hansard). Built for AI-driven civic-tech tools, legislative monitoring, and policy research.
Search licensed Wiley finance journals and textbooks. Built for AI-driven academic-grade financial research, literature review, and investment analysis.