scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTQuote
  • POSTFundamentals
  • POSTChart
  • POSTNews
  • POSTOptions
  • POSTSearch

Yahoo Finance Fundamentals

1 credit

Get financial statements, analyst data, and ownership information.

POST/api/v1/tools/yahoo-finance/fundamentals

Parameters

symbolstringrequired

Ticker symbol (e.g. AAPL, MSFT, GOOGL).

fieldsstring[]

Fields to include in response. Omit or pass ["*"] for all fields.

Response Schema

dataobject

Yahoo Finance fundamentals result

incomeobject[]

Income statement entries by period

balanceSheetobject[]

Balance sheet entries by period

cashFlowobject[]

Cash flow statement entries by period

analystobject

Analyst data including recommendation trends, upgrades/downgrades, earnings, and SEC filings

ownershipobject

Ownership data including insider holders, institutional ownership, and major holders breakdown

metaobject

Request metadata

toolstring

Tool name (yahoo-finance-fundamentals)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/yahoo-finance/fundamentals \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"symbol": "AAPL"
}'

Response Example

{
"data": {
"income": [
{
"asOfDate": "2024-09-28",
"periodType": "12M",
"currencyCode": "USD",
"TotalRevenue": 391035000000,
"NetIncome": 93736000000
}
],
"analyst": {
"recommendationTrend": {
"trend": [
{
"period": "0m",
"strongBuy": 12,
"buy": 20,
"hold": 8,
"sell": 2,
"strongSell": 0
}
]
}
},
"ownership": {
"majorHoldersBreakdown": {
"insidersPercentHeld": 0.0007,
"institutionsPercentHeld": 0.6148,
"institutionsCount": 6218
}
}
},
"meta": {
"tool": "yahoo-finance-fundamentals",
"creditsUsed": 1,
"requestId": "req_abc123"
}
}