Yahoo Finance

Get Yahoo Finance earnings

Get Yahoo Finance quarterly and yearly earnings, estimates and history.

GET/v1/yahoo-finance/instruments/{symbol}/earnings
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
symbolstringrequiredpath

Ticker symbol, case-insensitive, e.g. `AAPL`, `^GSPC`, `EURUSD=X`, `BTC-USD`, `7203.T`.

min 1 chars · max 40 chars · pattern: ^[A-Za-z0-9^=.-]+$

Response fields
14

Endpoint-specific response payload.

datalookupStatus
string

Whether the entity was found. HTTP 200 for both outcomes; branch on this field.

one of: found, not_found

datasymbol
string

Ticker symbol the sections belong to.

datasources
object

Status of each optional part of the result.

dataearnings
objectnullable

Quarterly and yearly earnings and revenue, with estimates and reported figures. Null when it is not available.

dataearningsHistory
objectnullable

Recent quarters with estimate, actual, difference and surprise percentage. Null when it is not available.

dataearningsTrend
objectnullable

Forward earnings and revenue estimates by period, with growth and analyst revisions. Null when it is not available.

dataearningsGaap
objectnullable

GAAP earnings and revenue by quarter and year. Null when it is not available.

dataearningsNonGaap
objectnullable

Non-GAAP earnings and revenue by quarter and year. Null when it is not available.

datacalendarEvents
objectnullable

Next earnings date, earnings estimate range and dividend dates. Null when it is not available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/yahoo-finance/instruments/AAPL/earnings" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Yahoo Finance earnings and calendar events.