Yahoo Finance Scraper — Quotes, Historicals, Fundamentals, Options & News

Extract all of Yahoo Finance with one actor — live quotes with 60+ fields, historical OHLCV candles, full financial statements (income, balance sheet, cash flow), analyst ratings and price targets, complete options chains, ticker news, symbol search, and Yahoo's market screeners. Works with stocks, ETFs, crypto, forex, indices, and futures. One clean JSON row per record, exportable to JSON, CSV, or Excel.

No API key, no login, no browser. The actor talks to Yahoo's own JSON endpoints over plain HTTP with browser-grade TLS and built-in residential proxies — it handles Yahoo's session cookie + crumb authentication for you, automatically.

Why use this Yahoo Finance Scraper?

• Eight data products in one actor. Quotes, candles, financial statements, analyst data, options, news, search, and screeners — no need to stitch five different scrapers together.
• Every asset class. Equities (AAPL), ETFs (SPY), crypto (BTC-USD), forex (EURUSD=X), indices (^GSPC), and futures (GC=F) all work with the same input.
• Real fundamentals, not screenshots. Up to ~10 years of annual and quarterly income-statement, balance-sheet, and cash-flow lines as numeric fields — revenue, EBITDA, EPS, free cash flow, total debt, and 25+ more metrics per period.
• Analyst intelligence included. Recommendation trends, price targets (mean/median/high/low), EPS estimate trends, upgrade/downgrade history, and Yahoo's research insights.
• Options chains, contract by contract. One row per call/put with strike, bid/ask, volume, open interest, and implied volatility — across as many expirations as you ask for.
• Schedule-friendly. Designed for recurring runs: point a daily/hourly schedule at your watchlist and feed dashboards, models, or alerts.

Overview

Yahoo Finance is the world's most-visited market-data site, covering essentially every listed instrument globally. Since 2023 its API requires a browser-grade TLS fingerprint plus a rotating cookie + crumb handshake, which breaks most scrapers and libraries.

This actor performs that handshake automatically, then reads Yahoo's structured JSON directly — no HTML parsing, no headless browser. Pick one of eight operations, pass tickers or a query, and get clean rows.

Supported inputs

Operation	Input	One row per
quotes	tickers	ticker — 60+ snapshot fields
historical	tickers + range/interval	candle (plus optional dividend/split rows)
fundamentals	tickers	statement period (annual & quarterly)
analysis	tickers	ticker — ratings, targets, trends, insights
options	tickers (+ expirations count)	option contract
news	tickers or query	article
search	query	matching symbol
screener	screener id	screened instrument

Tickers accept plain symbols or full Yahoo URLs (https://finance.yahoo.com/quote/AAPL/).

Use cases

• Portfolio dashboards — schedule quotes on your watchlist and pipe fresh prices, valuations, and analyst targets into Sheets or BI tools.
• Backtesting & quant research — pull years of daily or intraday OHLCV with historical, including dividends and splits for total-return math.
• Fundamental screening — combine fundamentals rows across tickers to rank by revenue growth, margins, or debt.
• Options analytics — snapshot full chains with options to track IV, open interest, and unusual volume.
• News monitoring & sentiment — poll news per ticker and feed headlines to an LLM for sentiment scoring.
• Market movers alerts — run screener (day gainers/losers, most actives) on a schedule and alert on new entrants.

How it works

1. Open a Yahoo session — the actor obtains the A1/A3 session cookie and the matching API crumb, exactly like a real browser.
2. Call Yahoo's JSON API for your operation — quoteSummary, chart, timeseries, options, search, or screener endpoints.
3. Process tickers in parallel with a sliding window, one consistent session per run.
4. Normalize — unwrap Yahoo's {raw, fmt} values to plain numbers, convert epoch timestamps to ISO dates.
5. Auto-recover — on a rate limit or expired crumb, the actor rotates its residential exit IP and re-establishes the session mid-run.
6. Push one row per record to the dataset.

Input configuration

Field	Type	Default	Description
operation	string	quotes	One of quotes, historical, fundamentals, analysis, options, news, search, screener
tickers	array of strings	—	Symbols or Yahoo quote URLs
query	string	—	Free text for search (also usable for news)
range	string	1mo	Historical lookback: 1d … 10y, ytd, max
interval	string	1d	Candle size: 1m … 3mo
startDate / endDate	string	—	Explicit YYYY-MM-DD window (overrides range)
includeEvents	boolean	false	Emit dividend & split rows too
optionsExpirations	integer	1	Expiration dates per ticker for options
screenerId	string	day_gainers	Predefined screener to pull
maxItems	integer	—	Hard cap on rows for the run
proxy	object	Residential built-in	Optional override

Example input

{
  "operation": "quotes",
  "tickers": ["AAPL", "MSFT", "BTC-USD", "^GSPC"]
}

{
  "operation": "historical",
  "tickers": ["TSLA"],
  "range": "5y",
  "interval": "1d",
  "includeEvents": true
}

Output overview

Every dataset item is one record of the chosen operation — one quote snapshot, one candle, one statement period, one option contract, one article, one screened instrument. No padding rows; you are only charged for rows actually delivered.

Output samples

quotes (truncated — 60+ fields per row):

{
  "symbol": "AAPL",
  "longName": "Apple Inc.",
  "quoteType": "EQUITY",
  "currency": "USD",
  "exchange": "NasdaqGS",
  "marketState": "REGULAR",
  "regularMarketPrice": 333.74,
  "regularMarketChangePercent": 1.02,
  "marketCap": 3160000000000,
  "trailingPE": 32.9,
  "forwardPE": 28.4,
  "fiftyTwoWeekHigh": 360.1,
  "dividendYield": 0.0051,
  "beta": 1.21,
  "totalRevenue": 416160000000,
  "grossMargins": 0.469,
  "freeCashflow": 98767000000,
  "recommendationKey": "buy",
  "numberOfAnalystOpinions": 43,
  "targetMeanPrice": 318.25,
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "website": "https://www.apple.com"
}

historical:

{
  "symbol": "AAPL",
  "type": "candle",
  "date": "2026-06-18T13:30:00.000Z",
  "open": 298.11,
  "high": 300.57,
  "low": 295.62,
  "close": 298.01,
  "adjClose": 298.01,
  "volume": 85962200,
  "interval": "1d",
  "currency": "USD"
}

fundamentals:

{
  "symbol": "AAPL",
  "period": "annual",
  "endDate": "2025-09-30",
  "currency": "USD",
  "totalRevenue": 416160000000,
  "grossProfit": 195234000000,
  "netIncome": 112010000000,
  "eBIT": 133050000000,
  "freeCashFlow": 98767000000,
  "totalDebt": 106629000000,
  "stockholdersEquity": 73733000000,
  "capitalExpenditure": -12715000000
}

options:

{
  "symbol": "AAPL",
  "underlyingPrice": 333.74,
  "type": "call",
  "contractSymbol": "AAPL260720C00205000",
  "expiration": "2026-07-20T00:00:00.000Z",
  "strike": 205,
  "lastPrice": 127.1,
  "bid": 127.35,
  "ask": 130.5,
  "volume": 2,
  "openInterest": 2,
  "impliedVolatility": 2.83
}

news:

{
  "query": "TSLA",
  "title": "Tesla Remains One of the Last Great Founder-Led Tech Giants…",
  "publisher": "Motley Fool",
  "link": "https://finance.yahoo.com/m/…/elon-musk%27s-tesla-remains-one.html",
  "publishedAt": "2026-07-19T19:25:00.000Z",
  "relatedTickers": ["TSLA", "MSFT", "NVDA"]
}

Key output fields

Field	Operation	Description
regularMarketPrice / marketCap / trailingPE	quotes	Live price and valuation snapshot
targetMeanPrice / recommendationKey	quotes, analysis	Analyst consensus target and rating
open high low close adjClose volume	historical	OHLCV per candle, adjusted close included
type = dividend / split	historical	Corporate action rows when includeEvents is on
period + endDate	fundamentals	annual or quarterly statement period
totalRevenue … freeCashFlow	fundamentals	30+ statement line items per period
strike / impliedVolatility / openInterest	options	Per-contract options data
earningsTrend / upgradeDowngradeHistory	analysis	EPS estimate revisions and rating changes
publishedAt / relatedTickers	news	Article metadata

FAQ

Do I need a Yahoo account or API key? No. The actor establishes a guest session (cookie + crumb) automatically, the same way a browser does.

Which markets are covered? Everything Yahoo Finance lists — US, European, and Asian equities and ETFs, crypto pairs, forex, world indices, commodities futures, and mutual funds. Use the ticker exactly as it appears on Yahoo (e.g. BMW.DE, 7203.T, BTC-USD).

How far back does historical data go? Daily candles: decades (use range: "max"). Intraday is limited by Yahoo itself — roughly 30 days of 1-minute data and ~2 years of hourly.

Are financial statements available for every symbol? Statements exist for operating companies. Crypto, forex, and indices have quotes and candles but no fundamentals — the actor tells you when a symbol has none.

What about the pre/post-market price? quotes rows include preMarketPrice and postMarketPrice when the market is in those sessions.

Why do some option contracts show null bid/ask? Illiquid contracts often have no standing quotes on Yahoo — the fields are passed through honestly rather than invented.

Can I run this on a schedule? Yes — that's the intended use. Create an Apify Schedule (e.g. every 15 minutes for quotes, daily for fundamentals) and connect the dataset to Sheets, a webhook, or your own pipeline.

Support

Found a bug or need another Yahoo endpoint (earnings calendar, holders, ESG)? Open an issue on the actor's Issues tab in the Apify Console — requests are usually turned around quickly.

Additional services

Need a custom output shape, delivery to your own database/webhook, or a merged multi-operation pipeline (e.g. quotes + news + sentiment in one run)? These can be added on request.

Explore more scrapers

This actor is part of a large portfolio of data-extraction actors — market data, company registries, job boards, real estate, and lead generation. Check the publisher's other actors on the Apify Store.

🤖 For AI Agents & LLM Apps

This actor is agent-friendly: a single operation switch, flat JSON rows, and stable field names make it easy to call as a tool. Typical agent patterns:

• Financial research agent — search to resolve a company name to a ticker, then quotes + analysis + news for a full briefing.
• RAG over fundamentals — pull fundamentals rows and let your LLM answer questions grounded in real statement data.
• Signal watcher — poll screener and quotes, let the agent decide when a threshold merits a notification.

Connect it via the Apify MCP server or call it with the Apify API from any agent framework (LangChain, LlamaIndex, CrewAI, n8n, Make).

⚠️ Disclaimer

This actor collects publicly available market data from Yahoo Finance for legitimate purposes such as research, analytics, and personal portfolio tracking. Market data may be delayed per exchange rules. Nothing this actor outputs is investment advice. Users are responsible for complying with Yahoo's Terms of Service and any exchange or data-vendor regulations that apply to their use of the data. This actor is not affiliated with, endorsed by, or connected to Yahoo.

SEO Keywords

Yahoo Finance scraper, yahoo finance API, stock price scraper, historical stock data, OHLCV download, financial statements scraper, income statement API, balance sheet data, cash flow data, analyst ratings scraper, price target data, options chain scraper, implied volatility data, stock news scraper, stock screener API, day gainers scraper, crypto price scraper, forex data scraper, market data without API key, yfinance alternative, finance data for LLM agents.