What it returns
US company earnings by date from Nasdaq's public earnings calendar.
Each row: date, symbol, name, timeOfDay (pre-market, after-hours, or null when the company has not said), epsForecast (consensus), numEstimates, eps and surprisePct (once reported), fiscalQuarterEnding, marketCap, lastYearReportDate, lastYearEps.
Input: dateFrom, dateTo (up to 92 days per run), symbols, timeOfDay, minMarketCap, maxItems. Charged per event returned.
Request
POST https://api.pushbuild.com/earnings-calendar/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
dateFrom | string | YYYY-MM-DD. Default: today. |
dateTo | string | YYYY-MM-DD, at most 92 days after the start. Default: 6 days after the start. |
symbols | list of strings | Only these tickers. Leave empty for all. |
timeOfDay | string: any, pre-market, after-hours | Keep only reports at this time of day. Default: "any". |
minMarketCap | integer | e.g. 10000000000 for large caps only. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/earnings-calendar/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.24 per 1,000 earnings events. No charge for errors or empty searches.
Use it from Claude, ChatGPT or Cursor
This API is also an MCP server: https://api.pushbuild.com/mcp/earnings-calendar. Add it to any assistant that supports remote MCP servers, with your key in the X-API-Key header. Same prices. Setup for each app.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.comWant this data inside your own app or CRM? API integrations and data sync