Earnings API
Documentation
Build with examples when you know the job, or use endpoint reference when you need the exact data contract.
How to use these docs
The left sidebar follows the same basic pattern as modern framework docs: overview first, task-oriented guides next, and reference pages after that.
- Examples show what you can build: alerts, sheet syncs, watchlist monitors, screeners, and scheduled jobs.
- Endpoints show what data is available: request parameters, response fields, and response examples.
- The global Code selector changes every code example on the current page.
Quick start
Start with the earnings calendar if you need a date-based feed. Switch to a symbol endpoint when the user asks about one company.
Quick startPython
import requests
response = requests.get("https://api.earningsapi.com/v1/calendar/earnings?date=2026-01-31", params={"apikey": "YOUR_API_KEY"}, timeout=30)
response.raise_for_status()
print(response.json())Next steps
Resources
Machine-readable files and endpoint-selection guidance live in the Resources section.