Earnings API

Retrieve historical and upcoming earnings data for a specific stock symbol.

GET /v1/earnings

Quick Copy & Paste

https://api.earningsapi.com/v1/earnings?symbol=AAPL&apikey=YOUR_API_KEY

Parameters

Query

Parameter	Type	Required	Description
`symbol`	string	Yes	Stock ticker symbol (e.g. AAPL)
`apikey`	string	Yes	Your API key

Response Example

[
  {
    "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
  },
  ...
]

Response Fields

The response is an array of earnings events. Fields may be null when data is not available yet.

Field	Type	Description
`date`	string	Earnings date in YYYY-MM-DD format
`symbol`	string	Stock ticker symbol
`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

cURL Example

curl "https://api.earningsapi.com/v1/earnings?symbol=AAPL&apikey=YOUR_API_KEY"

Rate Limiting

Free tier: 1,000 requests / month
429 returned when limit is exceeded