Yahoo Finance Fundamentals Scraper 📈 — Statements, Ratios & Quotes

Pull company fundamentals from Yahoo Finance as clean, structured JSON — income statement, balance sheet and cash flow (annual & quarterly), plus key statistics, valuation ratios, analyst price targets and live quotes — for stocks, ETFs, indices, crypto and FX, worldwide.

Built API-first for reliability and speed (no fragile page-rendering), with automatic session handling and proxy rotation so it keeps working at scale.

💡 Why this actor? Most "Yahoo Finance" scrapers only return prices, or wrap a library that breaks when Yahoo rotates its auth. This one delivers complete financial statements + valuation + analyst data in one normalized record, and is engineered to survive Yahoo's auth/rate-limit gating.

---

📋 Table of contents

• What does it do?
• Use cases
• How to use it
• Input parameters
• Input examples
• Output — data fields
• Sample output record
• Coverage
• Tips & best practices
• Frequently asked questions
• Changelog

---

What does it do?

Give it tickers (or pick a screener) and it returns, per symbol:

• 🧾 Financial statements — income statement, balance sheet, cash flow (annual + quarterly), with normalized field names.
• 📊 Key statistics & valuation — market cap, P/E, forward P/E, PEG, price/book, price/sales, EV, EV/EBITDA, beta, EPS, shares outstanding.
• 💹 Profitability & growth — gross/operating/profit margins, ROE, ROA, revenue & earnings growth, free & operating cash flow, debt, cash, current/quick ratio.
• 🎯 Analyst data — mean/high/low price targets, recommendation, number of analysts.
• 💵 Dividends — rate, yield, payout ratio, ex-dividend date.
• 📈 Live quote & 52-week range, and optional historical OHLCV price data.

Export to JSON, CSV, Excel, XML or HTML, or pull from the Apify API.

---

Use cases

📊 Equity research & screening

• Compare valuation and profitability across a watchlist or a whole screener.
• Build fundamental models from full statement history.

🤖 Quant & data teams

• Feed normalized fundamentals + price history into models and dashboards.
• Track quarterly results across many tickers.

💼 Investors & analysts

• Pull P/E, PEG, EV/EBITDA, margins, ROE and analyst targets in one batch.
• Monitor dividends and payout ratios.

📰 Fintech & media

• Power stock dashboards, newsletters and alerts with reliable structured data.

---

How to use it (step by step)

No coding required.

1. Click Try for free / Start.
2. Add Symbols (e.g. AAPL, MSFT, BTC-USD) — or pick a Screener (e.g. "Most actives") to discover tickers automatically.
3. Choose Statement frequency (annual / quarterly / both) and toggle Include financial statements / Include price history.
4. Set Max symbols.
5. Click Save & Start, then export the results.

---

Input parameters

Field	Type	Description
symbols	array	Tickers (e.g. AAPL, MSFT, BTC-USD, ^GSPC, EURUSD=X).
screener	string	Optional Yahoo predefined screener to discover tickers (most_actives, day_gainers, undervalued_large_caps, …).
statementFrequency	string	both, annual, or quarterly.
includeStatements	boolean	Include income/balance/cash-flow statements. Default true.
includePriceHistory	boolean	Include historical OHLCV. Default false.
priceRange	string	Range for price history (1mo–max).
maxItems	integer	Max symbols. 0 = no limit. Default 100.
proxyConfiguration	object	Proxy settings. Default: Apify Proxy on.
maxConcurrency	integer	Max parallel requests. Default 5.

---

Input examples

1) A few tickers with full statements

{
  "symbols": ["AAPL", "MSFT", "GOOGL"],
  "statementFrequency": "both"
}

2) Discover & scrape the most active stocks

{
  "screener": "most_actives",
  "maxItems": 50
}

3) Quotes + key stats only (fast, no statements)

{
  "symbols": ["TSLA", "NVDA", "AMD"],
  "includeStatements": false
}

4) With price history

{
  "symbols": ["AAPL"],
  "includePriceHistory": true,
  "priceRange": "5y"
}

---

Output — data fields

One record per symbol. Top-level fields include:

Group	Fields
Identity	symbol, name, exchange, currency, quoteType, sector, industry, country, website, employees, businessSummary
Quote	price, marketCap, previousClose, dayHigh, dayLow, fiftyTwoWeekHigh, fiftyTwoWeekLow, volume, averageVolume
Valuation	trailingPE, forwardPE, pegRatio, priceToBook, priceToSales, enterpriseValue, enterpriseToRevenue, enterpriseToEbitda, beta, bookValue, trailingEps, forwardEps, sharesOutstanding, floatShares
Profitability	profitMargins, grossMargins, operatingMargins, returnOnEquity, returnOnAssets, revenueGrowth, earningsGrowth, totalRevenueTTM, ebitdaTTM, totalCash, totalDebt, currentRatio, quickRatio, freeCashflowTTM, operatingCashflowTTM
Dividends	dividendRate, dividendYield, payoutRatio, exDividendDate
Analyst	targetMeanPrice, targetHighPrice, targetLowPrice, recommendationKey, numberOfAnalystOpinions
Statements	financials.incomeStatement[], financials.balanceSheet[], financials.cashFlow[]
Price history	priceHistory[] (when enabled)

Each statement row: { date, frequency, periodType, currency, ...lineItems } — e.g. income rows carry totalRevenue, grossProfit, operatingIncome, ebitda, netIncome, dilutedEPS, …; balance rows carry totalAssets, stockholdersEquity, totalDebt, cashAndCashEquivalents, …; cash-flow rows carry operatingCashFlow, freeCashFlow, capitalExpenditure, …

---

Sample output record

{
  "symbol": "AAPL",
  "name": "Apple Inc.",
  "exchange": "NMS",
  "currency": "USD",
  "sector": "Technology",
  "marketCap": 4571145961472,
  "price": 311.23,
  "trailingPE": 37.72,
  "forwardPE": 32.39,
  "priceToBook": 42.87,
  "enterpriseValue": 4587349606400,
  "returnOnEquity": 1.4147,
  "profitMargins": 0.2715,
  "targetMeanPrice": 310.5,
  "recommendationKey": "buy",
  "dividendYield": 0.0035,
  "financials": {
    "incomeStatement": [
      { "date": "2025-09-30", "frequency": "annual", "currency": "USD", "totalRevenue": 416161000000, "netIncome": 99000000000, "dilutedEPS": 7.46, "ebitda": 144748000000 }
    ],
    "balanceSheet": [
      { "date": "2025-09-30", "frequency": "annual", "totalAssets": 359241000000, "stockholdersEquity": 66000000000 }
    ],
    "cashFlow": [
      { "date": "2025-09-30", "frequency": "annual", "operatingCashFlow": 120000000000, "freeCashFlow": 98767000000 }
    ]
  },
  "scrapedAt": "2026-06-05T10:00:00.000Z"
}

---

Coverage

• Stocks (global exchanges), ETFs, indices (^GSPC), crypto (BTC-USD), FX (EURUSD=X).
• Full financial statements apply to equities; indices/FX/crypto return quote & price data.
• Discover symbols with the built-in screeners, or supply your own ticker list.

---

Tips & best practices

• 🧪 Start with a few symbols to confirm the output shape.
• ⚡ Disable statements for a fast quotes + key-stats run when you don't need full history.
• 🧱 Use a screener to scan a whole segment (e.g. most actives, undervalued large caps).
• 🐢 Keep concurrency moderate and proxy on — Yahoo rate-limits aggressive bursts.
• 💾 Use the Apify API / integrations to push results into Google Sheets, a database, or a webhook, and schedule runs to track quarterly results.

---

Frequently asked questions

Which statements are included? Income statement, balance sheet and cash flow — annual and/or quarterly, with normalized field names and multiple years of history.

Does it cover non-US companies? Yes — any symbol available on Yahoo Finance, across global exchanges, plus ETFs, indices, crypto and FX.

Can I discover tickers automatically? Yes — pick a predefined screener (most actives, day gainers, undervalued large caps, etc.).

Do I get analyst price targets and dividends? Yes — mean/high/low targets, recommendation, analyst count, and dividend rate/yield/payout.

What export formats are supported? JSON, CSV, Excel, XML, HTML table, RSS — plus the Apify API and integrations.

---

Changelog

0.1.0

• Initial release: full income/balance/cash-flow statements (annual + quarterly), key stats, valuation ratios, profitability, dividends, analyst targets and live quotes.
• Symbol list or screener discovery; optional OHLCV price history.
• API-first with resilient session handling and proxy rotation.