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-04-26",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "time": null,
    "epsEstimate": null,
    "eps": null,
    "revenue": null,
    "revenueEstimate": null
  },
  {
    "date": "2026-01-29",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "time": "time-after-hours",
    "epsEstimate": "$2.65",
    "eps": null,
    "revenue": null,
    "revenueEstimate": null
  },
  {
    "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	Company name
`time`	string	Reporting time (e.g., "time-after-hours", "time-pre-market") or null if not available
`epsEstimate`	string	Estimated EPS (e.g., "$1.73") or null if not available
`eps`	string	Actual EPS (e.g., "$1.85") or null if not reported
`revenue`	number	Actual revenue in dollars or null if not reported
`revenueEstimate`	number	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