> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-earnings>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-earnings.mdx>

---

# Yahoo Finance Earnings API

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

`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.

## Request

- **Endpoint:** `GET /v1/yahoo-finance/instruments/{symbol}/earnings`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by ticker
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/yahoo-finance/instruments/symbol/earnings/get)
- **Platform page:** [/platforms/yahoo-finance](https://www.socialfetch.dev/platforms/yahoo-finance)

## 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.