GETPopular
/v1/earningsCompany Earnings
Retrieve historical and upcoming earnings data for a specific symbol.
Request
GET https://api.earningsapi.com/v1/earnings?symbol=AAPL&apikey=YOUR_API_KEYRequestPython
import requests
response = requests.get("https://api.earningsapi.com/v1/earnings?symbol=AAPL", params={"apikey": "YOUR_API_KEY"}, timeout=30)
response.raise_for_status()
print(response.json())Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Stock ticker symbol (e.g., "AAPL") |
Response fields
| Field | Type | Description |
|---|---|---|
date | string | Earnings date in YYYY-MM-DD format |
symbol | string | Stock ticker symbol (e.g., "AAPL") |
name | string | null | Company name, or null when not available |
time | string | null | Reporting time (e.g., "time-after-hours", "time-pre-market") or null if not available |
epsEstimate | number | null | Estimated EPS per share (numeric, e.g., 1.73) or null if not available |
eps | number | null | Reported EPS per share (numeric, e.g., 1.85) or null if not reported |
revenue | number | null | Actual revenue in dollars or null if not reported |
revenueEstimate | number | null | Estimated revenue in dollars or null if not available |
Response example
JSON response
[
{
"date": "2026-05-07",
"symbol": "AAPL",
"name": null,
"time": "time-after-hours",
"epsEstimate": 1.95,
"eps": null,
"revenue": null,
"revenueEstimate": 108916700000
},
{
"date": "2026-01-29",
"symbol": "AAPL",
"name": "Apple Inc.",
"time": "time-after-hours",
"epsEstimate": 2.65,
"eps": 2.84,
"revenue": 143756000000,
"revenueEstimate": 138391007589
},
{
"date": "2025-10-30",
"symbol": "AAPL",
"name": "Apple Inc.",
"time": "time-after-hours",
"epsEstimate": 1.73,
"eps": 1.85,
"revenue": 102466000000,
"revenueEstimate": 102227074560
},
...
]