Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Earnings API

Reported earnings, estimate history, trends and the next event for one ticker.

GET /v1/yahoo-finance/instruments/{symbol}/earnings

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/yahoo-finance/instruments/{symbol}/earnings returns data.earnings, data.earningsHistory, data.earningsTrend, data.earningsGaap, data.earningsNonGaap and data.calendarEvents. The earnings section carries quarterly and yearly rows with date, actual and estimate. The history rows carry epsActual, epsEstimate, epsDifference and surprisePercent. Trend rows carry period, endDate, growth, epsEstimate, epsTrend and epsRevisions.

calendarEvents reports the next event with earningsDate, earningsAverage, earningsLow, earningsHigh, revenueAverage, revenueLow and revenueHigh. GAAP and non-GAAP sections are separate, so read the one you need. An instrument kind without a section returns null for it.

Yahoo Finance Earnings API FAQ

What is the difference between earningsGaap and earningsNonGaap?

They are separate sections for the two accounting bases. Read the one that matches your model; either can be null when there are no figures for that ticker.

Does the route include the next earnings date?

Yes, under data.calendarEvents. It lists the upcoming earnings date and the average, low and high estimates for EPS and revenue.

Why is a section null?

The instrument kind does not have that section. The rest of the response is still complete, and data.sources records which optional parts are available.

How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Yahoo Finance endpoints