GETPopular/v2/earnings

Company Earnings

Retrieve historical and upcoming earnings events for a single symbol.

Historical access

Free plans can access the most recent 24 months of historical data. Pro plans can access all available history.

Available earnings history starts at 2018-01-01, subject to your plan’s historical access. Reported results may be updated as new information becomes available. Unavailable values are null. Applies to epsEstimate, revenueEstimate, eps, and revenue. Free updates values once daily for events dated today or later. Pro updates values every 5 minutes. Today is determined in America/New_York at request time, using each event's official date. Earlier events return the same latest available values on both plans, subject to historical access limits. Event schedules remain available; values not yet available in the Free daily update are null, not zero. This difference applies only to the fields listed here, not all API data.

Request

GET https://api.earningsapi.com/v2/earnings?symbol=AAPL&apikey=YOUR_API_KEY
RequestPython
import requests

response = requests.get("https://api.earningsapi.com/v2/earnings?symbol=AAPL", params={"apikey": "YOUR_API_KEY"}, timeout=30)
response.raise_for_status()
print(response.json())

Query parameters

NameTypeRequiredDescription
symbolstringYesStock ticker symbol (e.g., "AAPL")

Response fields

FieldTypeDescription
datestringEarnings date in YYYY-MM-DD format
symbolstringStock ticker symbol (e.g., "AAPL")
namestring | nullCompany name, or null when not available
timestring | nullReporting session: time-pre-market, time-after-hours, or null when unavailable.
epsEstimatenumber | nullEstimated EPS per share (numeric, e.g., 1.73) or null if not available
epsnumber | nullReported EPS per share; may be updated. Null when unavailable.
revenuenumber | nullReported revenue amount, unscaled; may be updated. Null when unavailable.
revenueEstimatenumber | nullEstimated revenue amount, unscaled, or null when unavailable.

Response example

JSON response
[
  {
    "date": "2026-11-02",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "time": "time-after-hours",
    "epsEstimate": 1.983514,
    "eps": 2.05,
    "revenue": 114477000000,
    "revenueEstimate": 113378166980
  },
  {
    "date": "2026-07-30",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "time": "time-after-hours",
    "epsEstimate": 1.889297,
    "eps": 2.02,
    "revenue": 109417000000,
    "revenueEstimate": 108962934623
  }
]

Data API quota and limits

Compare plan limits and historical data access.

Free

  • 60 requests / minute
  • 100 requests / day
  • 1,000 requests / month
  • The most recent 24 months of historical data on supported endpoints
  • Earnings & economic values: Once daily

Pro

Price increasing soon
  • 300 requests / minute
  • Unlimited daily requests
  • Unlimited monthly requests
  • All available history on supported endpoints
  • Earnings & economic values: Every 5 minutes

Get Pro before the price goes up.

Upgrade to Pro

Earnings & economic values for today and upcoming dates. Past dates use the latest available values on both plans. Dates use New York time. Free daily and monthly quotas reset in New York time. Historical access applies to endpoints marked Historical access.

View usage and plans