📊 Yahoo Finance Scraper — Quotes, History, Fundamentals & News

Get structured Yahoo Finance data for any list of tickers — real-time quotes, historical OHLCV candles, financial statements, dividends & splits, latest news, and symbol search — as clean, flat JSON built for spreadsheets, dashboards, and LLM/agent pipelines. Pick only the data blocks you need: fewer blocks = faster and cheaper runs.

No API key, no login, no crumb tokens. Works for stocks, ETFs, indices, crypto, forex, and futures across international exchanges.

Why this scraper?

• ⚡ Fast & lean — HTTP-only (no headless browser), runs in seconds at 256 MB.
• 🎯 Selective — request quote, history, dividends, splits, fundamentals, or news per run instead of paying to fetch everything every time.
• 🧱 Stable by design — built exclusively on Yahoo's open JSON endpoints. It does not depend on the fragile cookie/crumb session flow that regularly breaks other tools.
• 🤖 Agent-ready output — flat, typed fields; raw numbers (no "394.33B" strings); ISO-8601 dates; absolute URLs; explicit granularity fields.
• 🌍 Any asset class — AAPL, 7203.T, PETR4.SA, SPY, ^GSPC, BTC-USD, EURUSD=X, GC=F.
• 🛡️ Graceful errors — an invalid or delisted symbol produces a per-ticker error item (never charged) while the rest of the batch completes normally.

Input

{
  "tickers": ["AAPL", "MSFT", "BTC-USD"],
  "dataBlocks": ["quote", "history", "news"],
  "range": "1y",
  "interval": "1d"
}

Field	Description
tickers	Yahoo Finance symbols, one output item each
dataBlocks	Any of quote, history, dividends, splits, fundamentals, news (default ["quote"])
range / interval	History window (1d…max) and candle size (1m…3mo)
startDate / endDate	Custom history window (YYYY-MM-DD), overrides range
fundamentalsGranularity	annual, quarterly, or both
searchQueries	Free-text names to resolve into tickers (e.g. "petrobras")

Output

One item per ticker (plus one per search query). Example (quote + history):

{
  "type": "ticker",
  "ticker": "AAPL",
  "error": null,
  "quote": {
    "symbol": "AAPL",
    "long_name": "Apple Inc.",
    "currency": "USD",
    "exchange": "NMS",
    "full_exchange": "NasdaqGS",
    "instrument_type": "EQUITY",
    "market_price": 327.5,
    "previous_close": 325.9,
    "day_high": 328.1,
    "day_low": 324.7,
    "volume": 41855600,
    "fifty_two_week_high": 328.73,
    "fifty_two_week_low": 201.5,
    "market_time": "2026-07-15T20:00:00.000Z",
    "timezone": "America/New_York",
    "sector": "Technology",
    "industry": "Consumer Electronics"
  },
  "history": {
    "range": "1y",
    "interval": "1d",
    "start": "2025-07-16T13:30:00.000Z",
    "end": "2026-07-15T13:30:00.000Z",
    "timezone": "America/New_York",
    "candles": [
      { "date": "2025-07-16T13:30:00.000Z", "open": 234.2, "high": 236.1, "low": 233.8, "close": 235.5, "adjclose": 234.9, "volume": 39120400 }
    ]
  },
  "scraped_at": "2026-07-16T14:02:11.512Z"
}

The fundamentals block returns financial-statement line items (TotalRevenue, NetIncome, BasicEPS, EBITDA, TotalAssets, StockholdersEquity, OperatingCashFlow, FreeCashFlow, and more) as flat rows with as_of_date, granularity, currency, and raw numeric value.

Pricing

Pay per result: one ticker-result event per delivered item. Error items (bad symbols) are free. Batch hundreds of tickers in one run.

Use cases

• 📈 Portfolio & watchlist tracking — schedule a daily run over your holdings.
• 🔬 Quant research / backtesting — bulk OHLCV history across asset classes.
• 🏦 Fundamental screening — statement line items as tidy rows, annual or quarterly.
• 🤖 AI & LLM apps — clean typed JSON for agents, RAG pipelines, and MCP tools.
• 📰 Market monitoring — per-ticker news headlines with publisher and timestamp.

FAQ

Do I need a Yahoo account or API key? No. The actor reads publicly accessible data.

Which symbols work? Anything Yahoo Finance quotes: equities (including international suffixes like .T, .SA, .L, .NS), ETFs, indices (^GSPC), crypto (BTC-USD), FX pairs (EURUSD=X), and futures (GC=F). Use searchQueries to resolve names to symbols first.

How far back does history go? As far as Yahoo has data (decades for major stocks with range: "max"). Intraday intervals are limited by Yahoo to recent windows.

What about options chains or analyst recommendations? Not included — those live behind Yahoo's session gate and are deliberately out of scope for reliability. If you need them, tell us in the Issues tab.

Is this legal? The actor retrieves publicly accessible market data. Use it responsibly and respect Yahoo's Terms of Service and applicable laws in your jurisdiction.

---

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Yahoo. "Yahoo" and "Yahoo Finance" are trademarks of Yahoo Inc. Data is provided by Yahoo Finance and is intended for research and informational purposes; it is not investment advice.