📊 Yahoo Finance Scraper

Up to 59 data points per ticker — quotes, deep fundamentals and full price history in one run. Plus a stock screener with your own filters, and full options chains with Greeks. No login, no API key, no rate-limit headaches.

Feed it a list of symbols — stocks, ETFs, indices, currencies or crypto — and get back a clean structured record per ticker: the live quote with pre- and post-market prices, the 50- and 200-day moving averages, the analyst vote broken down (not just "buy"), insider and institutional ownership, the next earnings date, and full OHLCV candles going back as far as Yahoo has them. Or switch mode and screen thousands of stocks with any filter you like, or pull option chains with implied volatility and Greeks.

⚡ Fast	Quotes are batched and details run in parallel — hundreds of symbols in seconds.
📊 Deep	31 quote fields, plus a 55-field fundamentals block with analyst rating changes, forward estimates, top institutional holders and insider trades.
🔎 Your own screener	Filter by sector, industry, market cap, P/E, dividend yield, price, volume, today's move — or any of 100+ extra fields such as return on equity or short interest. Or use one of 20 ready-made screens.
🧾 Options chains	Every contract with bid/ask, volume, open interest, implied volatility and delta, gamma, theta, vega, rho.
🌍 Anything Yahoo lists	Stocks, ETFs, funds, indices (^GSPC), FX (EURUSD=X), crypto (BTC-USD).
📈 Full history	OHLCV from 1 day to max, daily / weekly / monthly candles.
🛡 Resilient	A dead proxy or one bad symbol degrades that record — it never takes the run down.
🔓 No credentials	Nothing to sign up for, no key to rotate.

---

What data does it extract?

💵 Quote

Identity: symbol, shortName, longName, currency, financialCurrency, exchange, exchangeTimezone, quoteType, quoteSourceName

Price & session: price, change, changePercent, previousClose, open, dayHigh, dayLow, volume, marketState

Extended hours: preMarketPrice, preMarketChange, preMarketChangePercent, postMarketPrice, postMarketChange, postMarketChangePercent

Order book: bid, ask, bidSize, askSize

Moving averages: fiftyDayAverage, fiftyDayAverageChangePercent, twoHundredDayAverage, twoHundredDayAverageChangePercent

52-week context: fiftyTwoWeekHigh, fiftyTwoWeekLow, fiftyTwoWeekChangePercent, fiftyTwoWeekHighChangePercent, fiftyTwoWeekLowChangePercent

Volume & shares: averageDailyVolume3Month, averageDailyVolume10Day, sharesOutstanding

Valuation: marketCap, trailingPE, forwardPE, priceToBook, bookValue, eps, epsForward, epsCurrentYear

Dividends & events: dividendYield, dividendRate, dividendDate, earningsDate

🏢 Fundamentals (optional — 55 fields)

Company: sector, industry, country, website, fullTimeEmployees

Profitability: profitMargins, grossMargins, operatingMargins, returnOnEquity, returnOnAssets

Financials: totalRevenue, revenueGrowth, earningsGrowth, totalCash, totalDebt, debtToEquity, currentRatio, freeCashflow, enterpriseValue, beta, pegRatio

Analyst coverage: recommendationKey, numberOfAnalystOpinions, targetMeanPrice, targetHighPrice, targetLowPrice, and the vote itself — analystStrongBuy, analystBuy, analystHold, analystSell, analystStrongSell

A "buy" backed by 41 analysts is a different signal from one backed by 2. The breakdown is why this block exists.

Ownership & insiders: insidersPercentHeld, institutionsPercentHeld, insiderBuyShares6m, insiderSellShares6m, insiderNetShares6m

Earnings: nextEarningsDate, isEarningsDateEstimate, exDividendDate, dividendPayDate, lastEpsActual, lastEpsEstimate, lastEpsSurprisePercent

Rating changes — ratingChanges: the last 10 analyst actions, each with the firm, the grade it moved from and to, and the price target before and after.

Forward estimates — estimates: next quarter and next year, with EPS average/low/high, how many analysts contributed, expected growth and revenue estimate.

Top institutional holders — topInstitutions: the 10 largest, with percent held, share count, position value and report date.

Insider trades — insiderTrades: the 10 most recent, with the insider's name, their role, the transaction description, shares and value.

Quarterly history — quarterlyEarnings (EPS actual vs estimate and surprise %) and quarterlyRevenue (revenue and earnings per quarter).

📉 Historical (optional)

OHLCV candles — date, open, high, low, close, adjClose, volume — from 1d to max, at daily, weekly or monthly resolution.

📑 Financial statements (optional)

Add statements to the data types for 4 years of annual and the latest quarters of the three statements, one record per period (newest first) with periodEnd and currency:

Income statement: totalRevenue, costOfRevenue, grossProfit, operatingExpense, researchAndDevelopment, sellingGeneralAndAdministration, operatingIncome, interestExpense, pretaxIncome, taxProvision, netIncome, netIncomeCommonStockholders, basicEPS, dilutedEPS, basicAverageShares, dilutedAverageShares, EBIT, EBITDA, normalizedEBITDA, totalExpenses

Balance sheet: totalAssets, currentAssets, cashAndCashEquivalents, cashCashEquivalentsAndShortTermInvestments, receivables, inventory, netPPE, goodwill, totalLiabilitiesNetMinorityInterest, currentLiabilities, currentDebt, longTermDebt, totalDebt, netDebt, stockholdersEquity, retainedEarnings, workingCapital, tangibleBookValue, ordinarySharesNumber

Cash flow: operatingCashFlow, investingCashFlow, financingCashFlow, capitalExpenditure, freeCashFlow, repurchaseOfCapitalStock, cashDividendsPaid, depreciationAndAmortization, stockBasedCompensation, endCashPosition

Banks and insurers report a different structure, so items such as gross profit are simply absent for them.

🧺 ETF / fund data (optional)

Add etf for funds: family, category, legalType, expenseRatio, holdingsTurnover, totalAssets, yield, navPrice, inceptionDate, positions (stock / bond / cash / preferred / convertible / other), topHoldings (symbol, name, weight), sectorWeights, trailingReturns (YTD, 1M, 3M, 1Y, 3Y, 5Y, 10Y), annualReturns per year and risk statistics (alpha, beta, Sharpe ratio, standard deviation, R², Treynor) over 3, 5 and 10 years. For a regular stock the block is null.

📰 News (optional)

Add news for the latest headlines on each symbol — up to 50 per symbol (newsCount), each with title, publisher, link, publishedAt, type and relatedTickers.

Fields come back null when Yahoo genuinely has no value: an ETF has no P/E, a stock that pays no dividend has no ex-date. Nothing is guessed or padded.

🔎 Screener mode

Set What to fetch to Screener ("mode": "screener"). Each matching stock comes back with the same quote fields listed above, plus rank and screener.

Your own filters (all combine): region (24 markets), sector, industry, market cap range, P/E range, minimum dividend yield, price range, minimum average volume and today's % change — plus More filters for anything else Yahoo screens on, written one per line:

returnonequity.lasttwelvemonths > 20
short_percentage_of_float.value >= 15
beta between 0.5 and 1.2
pctheldinst > 60

Every field is checked before the run starts: if one is misspelled, the run stops and tells you, instead of quietly returning every stock. Sort by market cap, today's change, volume, P/E, dividend yield, 52-week change, short interest, return on equity or revenue growth.

Or one of 20 ready-made screens: day gainers and losers, most active, most shorted, undervalued growth and large caps, growth technology, aggressive small caps, small-cap gainers, portfolio anchors, top mutual funds, high-yield bond funds, all cryptocurrencies, crypto gainers/losers and more.

🧾 Options chains

Set What to fetch to Options ("mode": "options") and list your symbols. One row per contract:

symbol, contractSymbol, optionType (call/put), expiration, daysToExpiration, strike, lastPrice, bid, ask, midPrice, change, changePercent, volume, openInterest, impliedVolatility, inTheMoney, lastTradeDate, underlyingPrice, currency — and the Greeks delta, gamma, theta (per day), vega and rho (per 1 percentage point), computed with Black-Scholes from the implied volatility and the current 13-week Treasury yield.

Choose calls, puts or both, how many upcoming expirations (or one specific date), and optionally only strikes within ±X% of the share price.

---

Who uses this, and for what

Who	What they run it for
📈 Quant researchers	Pull OHLCV history and factor data across a universe, free of API quotas
🤖 Algo & bot builders	Feed live quotes, moving averages and extended-hours prices into strategies
💼 Analysts & PMs	Track holdings against analyst targets, earnings dates and insider flow
🏗 Fintech builders	Back a dashboard or app without paying for a market-data vendor
📰 Finance media	Generate market tables and earnings previews on a schedule
🎓 Students & educators	Build coursework datasets at no cost

---

Quick start — copy an input and run

Live quotes for a watchlist (fastest, good first run)

{ "symbols": ["AAPL", "MSFT", "NVDA"], "dataTypes": ["quote"] }

Full fundamentals with the analyst breakdown

{ "symbols": ["AAPL", "KO"], "dataTypes": ["quote", "fundamentals"] }

Five years of daily candles

{ "symbols": ["TSLA"], "dataTypes": ["historical"], "range": "5y", "interval": "1d" }

Everything, for one ticker

{
  "symbols": ["NVDA"],
  "dataTypes": ["quote", "fundamentals", "historical"],
  "range": "1y",
  "interval": "1wk"
}

Financial statements and news for a watchlist

{ "symbols": ["AAPL", "MSFT"], "dataTypes": ["quote", "statements", "news"], "newsCount": 20 }

ETF holdings, expense ratio and returns

{ "symbols": ["SPY", "QQQ", "VTI"], "dataTypes": ["quote", "etf"] }

Beyond stocks — index, FX and crypto in one run

{ "symbols": ["^GSPC", "EURUSD=X", "BTC-USD"], "dataTypes": ["quote"] }

Screener: profitable large-cap tech at a reasonable price

{ "mode": "screener", "screenSector": "Technology", "screenMinMarketCapB": 10, "screenMaxPE": 25, "maxResults": 200 }

Screener: high-dividend stocks, highest yield first

{ "mode": "screener", "screenMinDividendYield": 5, "screenMinMarketCapB": 5, "screenSortBy": "dividendYield" }

Screener: today's top gainers (ready-made screen)

{ "mode": "screener", "screenPreset": "day_gainers", "maxResults": 100 }

Options: the next 3 expirations, strikes within 10% of the price

{ "mode": "options", "symbols": ["AAPL", "SPY"], "optionsExpirations": 3, "optionsStrikeRangePct": 10 }

---

How to use

1. Pick What to fetch: Symbols (default), Screener or Options.
2. Symbols: enter one or more tickers and pick your data types — quote, fundamentals, historical, statements, etf, news, any combination. For historical, choose a range (1d → max) and an interval (1d, 1wk, 1mo).
3. Screener: pick a ready-made screen, or set your own filters and sort order.
4. Options: enter tickers and choose calls/puts, expirations and strike range.
5. Run, then export as JSON, CSV or Excel — or pull it from the Apify API.

Agent-ready (x402)

Agent-ready via x402: AI agents can run this actor directly with USDC on Base — no Apify account needed. See the x402 protocol docs.

---

Output example

{
  "symbol": "AAPL",
  "shortName": "Apple Inc.",
  "exchange": "NasdaqGS",
  "price": 305.59,
  "changePercent": 0.42,
  "marketState": "POSTPOST",
  "postMarketPrice": 305.15,
  "bid": 303.47,
  "ask": 307.98,
  "fiftyDayAverage": 309.19,
  "twoHundredDayAverage": 280.48,
  "fiftyTwoWeekChangePercent": 32.5,
  "sharesOutstanding": 14594180000,
  "priceToBook": 41.52,
  "epsForward": 9.51,
  "dividendRate": 1.08,
  "earningsDate": "2026-10-29",
  "fundamentals": {
    "sector": "Technology",
    "recommendationKey": "buy",
    "numberOfAnalystOpinions": 41,
    "analystStrongBuy": 6, "analystBuy": 21, "analystHold": 14,
    "analystSell": 3, "analystStrongSell": 2,
    "targetMeanPrice": 305.4, "targetHighPrice": 400, "targetLowPrice": 215,
    "institutionsPercentHeld": 0.6648,
    "insidersPercentHeld": 0.0165,
    "lastEpsActual": 2.02,
    "lastEpsEstimate": 1.89,
    "lastEpsSurprisePercent": 0.0674,
    "nextEarningsDate": "2026-10-29",
    "ratingChanges": [
      { "date": "2026-08-10", "firm": "Jefferies", "fromGrade": "Hold", "toGrade": "Underperform",
        "action": "down", "priorPriceTarget": 285.56, "currentPriceTarget": 263.66 }
    ],
    "estimates": [
      { "period": "0q", "endDate": "2026-09-30", "epsAvg": 1.98, "epsLow": 1.93,
        "epsHigh": 2.07, "epsAnalysts": 28, "growth": 0.0703 }
    ],
    "topInstitutions": [
      { "organization": "Blackrock Inc.", "reportDate": "2026-06-30",
        "percentHeld": 0.0797, "shares": 1162996939 }
    ],
    "insiderTrades": [
      { "date": "2026-08-11", "insider": "NEWSTEAD JENNIFER", "relation": "General Counsel",
        "description": "Sale at price 307.75 per share.", "shares": 1439, "value": 442852 }
    ],
    "quarterlyEarnings": [
      { "quarter": "3Q2025", "epsActual": 1.85, "epsEstimate": 1.77, "surprisePercent": 4.52 }
    ]
  },
  "scrapedAt": "2026-08-18T00:00:00.000Z"
}

Options mode (one contract)

{
  "symbol": "AAPL", "contractSymbol": "AAPL261104C00347500", "optionType": "call",
  "expiration": "2026-11-04", "daysToExpiration": 7, "strike": 347.5,
  "lastPrice": 7.27, "bid": 7.05, "ask": 7.4, "midPrice": 7.23,
  "volume": 278, "openInterest": 139, "impliedVolatility": 0.3705, "inTheMoney": false,
  "underlyingPrice": 347.1, "delta": 0.5079, "gamma": 0.0214, "theta": -0.5025, "vega": 0.2004, "rho": 0.0354
}

---

Performance & cost

Quotes are fetched in batches of 50, and the per-symbol detail calls run in parallel, so a large watchlist stays fast.

Results	Estimated cost
10	$0.01
100	$0.10
1,000	$1.00
10,000	$10.00

Pay per result — $0.001 per result. A result is one symbol in Symbols mode (with all the data types you asked for), one stock in Screener mode, or one option contract in Options mode. Use Max results to cap screener and options runs. Symbols Yahoo has no data for are skipped and not charged. The Apify Free plan includes $5 of free usage to get started.

Input parameters

Parameter	Type	Default	Description
mode	string	symbols	symbols, screener or options
symbols	array	—	Ticker symbols (Symbols and Options mode)
dataTypes	array	["quote"]	Any of quote, historical, fundamentals, statements, etf, news
newsCount	integer	10	Headlines per symbol when news is selected (1-50)
range	string	1mo	1d,5d,1mo,3mo,6mo,1y,2y,5y,10y,max
interval	string	1d	1d, 1wk, 1mo
maxResults	integer	100	Row cap for Screener and Options mode
screenPreset	string	—	One of the 20 ready-made screens (overrides custom filters)
screenRegion / screenSector / screenIndustry	string	us / any / any	Market, sector and industry
screenMinMarketCapB / screenMaxMarketCapB	number	—	Market cap range, USD billions
screenMinPE / screenMaxPE	number	—	Trailing P/E range
screenMinDividendYield	number	—	Minimum forward dividend yield, %
screenMinPrice / screenMaxPrice	number	—	Share price range
screenMinAvgVolume	number	—	Minimum 3-month average volume
screenMinChangePercent / screenMaxChangePercent	number	—	Today's % change range
screenFilters	array	—	Extra conditions, e.g. "returnonequity.lasttwelvemonths > 20"
screenSortBy / screenSortOrder	string	marketCap / desc	Order of the results
optionsType	string	both	both, calls or puts
optionsExpirations	integer	1	Upcoming expirations per symbol
optionsExpirationDate	string	—	One specific expiration, YYYY-MM-DD
optionsStrikeRangePct	number	0	Only strikes within ±X% of the price (0 = all)
includeGreeks	boolean	true	Delta, gamma, theta, vega, rho
proxyConfiguration	object	Apify Proxy	Datacenter is fine; Residential only if rate-limited

FAQ

Do I need a Yahoo Finance API key or account? No. No login, no key, nothing to rotate.

Which symbols are supported? Anything Yahoo Finance lists: stocks, ETFs, mutual funds, indices (^GSPC), currencies (EURUSD=X) and crypto (BTC-USD).

How fresh is the price data? Quotes reflect Yahoo's real-time / near-real-time regular market price at the moment of the run. Outside trading hours marketState tells you the session, and the pre/post-market fields carry the extended-hours price.

Can I run many tickers at once? Yes. Quotes go out in batches of 50 and the detail calls run in parallel, so large lists finish quickly.

What if a symbol is invalid? It is skipped and you are not charged for it. The run's status message and log name every symbol Yahoo returned no data for.

Can I screen stocks without knowing the tickers? Yes — use Screener mode with your own filters or one of the 20 ready-made screens. A misspelled filter stops the run with a clear message rather than returning the whole market.

Are the option Greeks from Yahoo? The implied volatility is Yahoo's. Delta, gamma, theta, vega and rho are calculated from it with the Black-Scholes model, using the current 13-week Treasury yield and the stock's dividend yield. Contracts without a usable implied volatility get null Greeks rather than a guess.

Why is a field null? Because Yahoo has no value for it — an ETF has no P/E, a non-paying stock has no ex-dividend date, and a company with no analyst coverage has no target price. Nothing is invented to fill the gap.

Other actors you may like

• FinViz Stock Screener — screen the US market with 92 data points per stock.
• SEC EDGAR Scraper — filings, Form 4 insider trades, XBRL financials and 13F holdings.
• Dividend & ETF Scraper — dividend history, ETF holdings, expense ratio and yield.
• Financial Calendar Scraper — earnings, dividends, splits and IPO calendars.
• Zacks Rank Stock Scraper — Zacks Rank (1-5) plus a full quote snapshot.
• Congressional Stock Trades Scraper — House member trades disclosed under the STOCK Act.
• TradingView Screener — screen global markets by technical and fundamental filters.

Legal disclaimer

This actor extracts publicly available, factual market data and does not access any private, authenticated or personal data. Market figures (prices, volumes, ratios) are facts and are not subject to copyright. Use the data in compliance with Yahoo's terms and applicable law. You are responsible for how you use the extracted data; this tool is intended for research, analysis and lawful business use. Nothing here is investment advice.

Changelog

Version	Date	Changes
1.4	2026-10-28	Three new data types, still one result per symbol: financial statements (4 years of annual plus recent quarters of income statement, balance sheet and cash flow — 49 line items), ETF / fund data (top holdings, sector weights, expense ratio, asset mix, trailing and annual returns, risk statistics) and news headlines (up to 50 per symbol).
1.3	2026-10-27	New Screener mode: your own filters (region, sector, industry, market cap, P/E, dividend yield, price, volume, today's move, plus 100+ extra fields) or 20 ready-made screens, up to thousands of stocks per run. New Options mode: full option chains with bid/ask, volume, open interest, implied volatility and Greeks. Symbols Yahoo has no data for are now skipped and no longer charged. Price lowered from $0.005 to $0.001 per result.
1.2	2026-08-18	22 → 59 fields per ticker: pre/post-market, bid/ask, 50- and 200-day averages, shares outstanding, price-to-book, forward EPS, dividend and earnings dates; fundamentals gains the analyst vote breakdown, high/low targets, insider and institutional ownership, and last-quarter EPS surprise. Detail calls now run in parallel, and a transport failure degrades one record instead of ending the run. Adds analyst rating-change history, forward EPS/revenue estimates, top institutional holders, recent insider trades and quarterly earnings/revenue.
1.1	2026-07-01	x402 agent-ready support; pricing table
1.0	2026-06-10	Initial release — quotes, historical OHLCV and fundamentals with cookie+crumb session handling and batch quote fetching

---

Keywords: yahoo finance scraper, yahoo finance api, stock data scraper, stock price api, historical stock data, company fundamentals, financial data extraction, stock market data, ticker scraper, OHLCV data, P/E ratio scraper, dividend data, equities data api, analyst ratings scraper, pre market data, insider ownership data, stock screener, custom stock screener, options chain scraper, option greeks, implied volatility data, most shorted stocks, financial statements, income statement, balance sheet, cash flow, etf holdings, stock news.