earningshub.com APIearningshub.com ↗
Access upcoming and reported earnings data via the EarningsHub API. Get EPS estimates, actuals, revenue figures, and report timing for public companies.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/2f15267d-2491-4111-ba2c-ce7eb2e52e47/get_upcoming_earnings?end_date=%3CYYYY-MM-DD%3E&start_date=%3CYYYY-MM-DD%3E' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract upcoming earnings data for entries with a report_date between today and 30 days from today. Returns ticker, company_name, report_date, report_time, quarter, eps_estimate, and revenue_estimate for each entry, sorted by report_date then ticker.
No input parameters required.
{
"type": "object",
"fields": {
"count": "integer - total number of upcoming earnings entries",
"date_range": "object with start and end date strings in YYYY-MM-DD format",
"upcoming_earnings": "array of earnings entry objects with ticker, company_name, report_date, report_time, quarter, eps_estimate, revenue_estimate"
},
"sample": {
"data": {
"count": 1306,
"date_range": {
"end": "2026-06-13",
"start": "2026-05-14"
},
"upcoming_earnings": [
{
"ticker": "ABP",
"quarter": "Q1 2026",
"report_date": "2026-05-14",
"report_time": "After Market Close",
"company_name": "ABPRO CORP",
"eps_estimate": null,
"revenue_estimate": null
},
{
"ticker": "ACOG",
"quarter": "Q1 2026",
"report_date": "2026-05-14",
"report_time": "After Market Close",
"company_name": "Alpha Cognition Inc",
"eps_estimate": -0.4,
"revenue_estimate": 4658000
}
]
},
"status": "success"
}
}About the earningshub.com API
The EarningsHub API exposes two endpoints covering the earnings calendar and recent results for publicly traded companies. get_upcoming_earnings returns structured records for companies scheduled to report within the next 30 days, including EPS and revenue estimates, while get_reported_earnings delivers the same fields plus actuals for companies that reported in the past 30 days. Each response includes a count, a date range object, and a sortable array of earnings entries.
Upcoming Earnings Calendar
get_upcoming_earnings returns a upcoming_earnings array covering companies with a report_date between today and 30 days out. Each entry carries ticker, company_name, report_date (YYYY-MM-DD), report_time (indicating before-market, after-market, or unconfirmed), quarter, eps_estimate, and revenue_estimate. The response also includes a top-level count integer and a date_range object with start and end strings, making it straightforward to verify the window covered. Results are sorted by report_date then ticker.
Recently Reported Earnings
get_reported_earnings covers the trailing 30-day window and only includes entries where at least one actual value — eps_actual or revenue_actual — is present. Each object extends the upcoming-earnings shape with those two actuals alongside their corresponding estimate fields (eps_estimate, revenue_estimate). This lets you compute beat/miss figures directly from the response without secondary lookups. The response follows the same envelope structure: count, date_range, and a reported_earnings array.
Data Shape and Coverage
Both endpoints require no input parameters — the 30-day windows are computed server-side relative to the current date. Null values appear for fields not yet populated (for example, eps_estimate may be null for thinly-covered names). Revenue figures are returned as numeric values in consistent units. Neither endpoint paginates; the full window is returned in a single response.
- Build an earnings calendar widget that groups upcoming reports by
report_dateand highlights pre- vs. post-marketreport_time. - Screen for upcoming earnings beats by comparing
eps_estimateagainst historicaleps_actualvalues fromget_reported_earnings. - Alert traders when a tracked
tickerappears in the upcoming earnings array within a configurable number of days. - Calculate EPS surprise percentage using
eps_estimateandeps_actualfields fromget_reported_earnings. - Populate a dashboard comparing
revenue_estimatevs.revenue_actualacross recently reporting companies. - Filter the reported earnings array by
quarterto group results for a specific fiscal period. - Cross-reference
report_timewith trading hours logic to schedule pre-market or after-hours event handling.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does EarningsHub offer an official developer API?+
What does get_reported_earnings return that get_upcoming_earnings does not?+
get_reported_earnings adds eps_actual and revenue_actual to each entry, and only includes records where at least one of those actuals is populated. get_upcoming_earnings contains only estimate fields since results have not yet been released.Can I query earnings data for a specific ticker or date beyond the 30-day windows?+
Are historical earnings results (older than 30 days) available?+
get_reported_earnings covers only the past 30 days where actuals are present. You can fork the API on Parse and revise it to add an endpoint targeting a longer historical window.How fresh is the earnings data, and can estimate values be null?+
get_reported_earnings are only present once EarningsHub records them after a company reports.