Yahoo Finance Scraper API Documentation

Yahoo Finance calendar types

Lists the Yahoo Finance calendar types available through the API: `earnings`, `ipo`, `economic-events` and `splits`. The list is static. Takes no parameters.

Takes no parameters.

Open in Playground

Yahoo Finance calendar results

Returns Yahoo Finance calendar rows for the path `type`: `earnings`, `ipo`, `economic-events` or `splits`. Narrow with `start` and `end` (YYYY-MM-DD, RFC3339 or Unix seconds) and page with `limit` (max 100) and `offset`. For `earnings` only, `market_cap` sets a minimum and `filter_most_active` (default true) filters. The response echoes the window and paging with the `rows`.

Required: type (4 allowed values: earnings, ipo, economic-events, splits). Optional: start, end, limit, offset, market_cap, filter_most_active.

Open in Playground

Yahoo Finance batch historical prices

Returns historical prices for up to 25 symbols in one POST. The body requires `symbols`; `period`, `start`, `end`, `interval`, `include_prepost` and `include_actions` are optional. Each result is one symbol, with price points (open, high, low, close, adjusted close, volume) and dividend, split and capital-gain events, or an `error` for that symbol.

Required: request.

Sampled 14 Oct 2026: 2 items. Filled in every item: symbol, history. In the sample: symbol: “AAPL” and 1 other value.

Open in Playground

Yahoo Finance industries

Lists the Yahoo Finance industries, each with a `key` and a `name`. It takes no parameters. Pass a returned `key` to `/yahoo-finance/industries/{key}` for that industry's detail.

Takes no parameters.

Sampled 14 Oct 2026: 145 items. Filled in every item: key, name. In the sample: name: “Advertising Agencies” and 144 other values.

Open in Playground

Yahoo Finance industry detail

Returns Yahoo Finance detail for one industry `key` such as `semiconductors`: name, overview, its parent sector (`sector_key`, `sector_name`), top companies, top performing companies, top growth companies and research reports. Valid keys come from `/yahoo-finance/industries`.

Required: key.

Sampled 14 Oct 2026: 48 items. Filled in every item: market_weight, symbol. Not in every item: name (47), rating (46). In the sample: rating: Strong Buy (20), Buy (17), Hold (9); market_weight: 0 to 0.45, median 0; name: “NVIDIA Corporation” and 46 other values; symbol: “NVDA” and 47 other values.

Open in Playground

Yahoo Finance lookup

Looks up instruments on Yahoo Finance by ticker symbol or company name, optionally filtered to one type: equity, ETF, mutual fund, index, future, currency or cryptocurrency. Page with `count` and `start`. Returns the matching instruments, each with its symbol, short name, quote type and exchange, and the total.

Required: query. Optional: type (8 allowed values: all, equity, etf, mutualfund, index, future, currency, cryptocurrency), count, start.

Sampled 14 Oct 2026: 20 items. Filled in every item: exchange, fulldayChange, fulldayChangePercent, fulldayPrice, quoteType, rank, regularMarketChange, regularMarketPercentChange and 3 more. Not in every item: industryLink (12), industryName (12). In the sample: industryName: Technology (10), Real Estate (1), Consumer Cyclical (1); fulldayChange: 0 to 540, median 2.54; exchange: “NMS” and 15 other values; industryLink: finance.yahoo.com; fulldayChangePercent: 0 to 46.08, median 1.2; fulldayPrice: 0.19 to 1,089,860, median 307.35; quoteType: equity (12), etf (4), future (2) and 1 more; rank: 20,015 to 361,633, median 20,034.

Open in Playground

Yahoo Finance market status

Returns whether a Yahoo Finance market is open or closed, for the path `market` such as `US`. The response has `market` and a `status` object with the market id, name and its current open or closed state.

Required: market.

Sampled 14 Oct 2026: 1 item. Filled in every item: hrs, mins.

Open in Playground

Yahoo Finance market summary

Returns the market summary rows for a Yahoo Finance `market` such as `US`, as a `summary` list of instruments, each with fields such as `symbol` and `shortName`.

Required: market.

Sampled 14 Oct 2026: 7 items. Filled in every item: cryptoTradeable, customPriceAlertConfidence, exchange, exchangeDataDelayedBy, exchangeTimezoneName, exchangeTimezoneShortName, firstTradeDateMilliseconds, fullExchangeName and 21 more. Not in every item: priceHint (6), quoteSourceName (4), contractSymbol (1), headSymbol (1), headSymbolAsString (1). In the sample: customPriceAlertConfidence: LOW (6), NONE (1); exchangeDataDelayedBy: 0 to 15, median 10; exchange: “SNP” and 6 other values; cryptoTradeable: true in 0 of 7; exchangeTimezoneName: America/New_York (5), America/Chicago (2); exchangeTimezoneShortName: EDT (5), CDT (2); firstTradeDateMilliseconds: -1,325,583,000,000 to 967,608,000,000, median 558,279,000,000; fullExchangeName: “SNP” and 5 other values.

Open in Playground

Yahoo Finance custom screener

Runs a custom Yahoo Finance screen from a JSON body. `query` is a tree of `operator` and `operands`: combine conditions with `AND` or `OR`, and compare a field to a value with operators such as `EQ` or `GT`. Screen equities (default), ETFs or mutual funds with `quote_type`, and page and sort with `count`, `offset`, `sort_field` and `sort_asc`. Returns the matching quotes and the total.

Required: request.

Sampled 14 Oct 2026: 25 items. Filled in every item: cryptoTradeable, currency, customPriceAlertConfidence, esgPopulated, exchange, exchangeDataDelayedBy, exchangeTimezoneName, exchangeTimezoneShortName and 16 more. Not in every item: ask (23), askSize (23), bid (23), bidSize (22), fiftyTwoWeekHigh (23), fiftyTwoWeekHighChange (23), fiftyTwoWeekHighChangePercent (23), fiftyTwoWeekLow (23) and 8 more. In the sample: customPriceAlertConfidence: LOW (21), HIGH (4); ask: 0 to 1,005,000, median 13.74; fiftyTwoWeekRange: “500.0 - 500.0” and 22 other values; cryptoTradeable: true in 0 of 25; askSize: 0 to 1,200, median 100; bid: 0 to 995,000, median 10.57; bidSize: 0 to 10,000, median 100; esgPopulated: true in 0 of 25.

Open in Playground

Yahoo Finance predefined screener results

Runs a predefined Yahoo Finance screener by `id`, such as `day_gainers` or `most_actives`. `count` and `offset` page the results; `sort_field` and `sort_asc` change the order. The response has the screener `title`, `description`, `total`, `meta` and the matching `quotes`. Valid ids come from `/yahoo-finance/screeners`.

Required: id. Optional: count, offset, sort_field, sort_asc.

Sampled 14 Oct 2026: 5 fields returned with a value. In the sample: total: 57; title: “Day Gainers”; quotes: 20 entries; description: “Discover the equities with the greatest gains in the tradin…”.

Open in Playground

Yahoo Finance predefined screeners

Lists the predefined Yahoo Finance screeners that can be run, such as `day_gainers`, `day_losers` and `most_actives`, as a `screeners` list of ids. It takes no parameters. Pass an id to `/yahoo-finance/screener/{id}`.

Takes no parameters.

Open in Playground

Yahoo Finance search

Searches Yahoo Finance for the required `q`, a ticker symbol or company name, and returns matching `quotes`, `news` and `lists`, plus `research` reports when `include_research` is set and Yahoo returns them. `quotes_count`, `news_count` and `lists_count` set how many of each; `enable_fuzzy_query` turns on fuzzy matching.

Required: q. Optional: quotes_count, news_count, lists_count, include_research, enable_fuzzy_query.

Sampled 14 Oct 2026: 5 items. Filled in every item: index, isYahooFinance. Not in every item: dispSecIndFlag (1), exchDisp (3), exchange (3), industry (1), industryDisp (1), longname (2), quoteType (3), score (3) and 7 more. In the sample: score: 30,007 to 361,633, median 30,089; exchDisp: “NASDAQ” and 1 other value; dispSecIndFlag: true in 1 of 1; exchange: “NMS” and 1 other value; industry: “Consumer Electronics”; industryDisp: “Consumer Electronics”; isYahooFinance: true in 3 of 5; longname: “Apple Inc.” and 1 other value.

Open in Playground

Yahoo Finance sectors

Lists the Yahoo Finance sectors, each with a `key` and a `name`. It takes no parameters. Use a returned `key` with `/yahoo-finance/sectors/{key}` to get that sector's companies, funds and industries.

Takes no parameters.

Sampled 14 Oct 2026: 11 items. Filled in every item: key, name. In the sample: name: “Basic Materials” and 10 other values.

Open in Playground

Yahoo Finance sector detail

Returns Yahoo Finance detail for one sector `key` such as `technology`: name, overview, top companies, top ETFs, top mutual funds, the sector's industries and research reports. Valid keys come from `/yahoo-finance/sectors`.

Required: key.

Sampled 14 Oct 2026: 50 items. Filled in every item: market_weight, name, symbol. Not in every item: rating (49). In the sample: rating: Buy (26), Strong Buy (19), Hold (4); market_weight: 0 to 0.18, median 0.01; name: “NVIDIA Corporation” and 49 other values; symbol: “NVDA” and 49 other values.

Open in Playground

Yahoo Finance corporate actions

Returns the corporate actions for a Yahoo Finance `symbol` such as `AAPL`: `dividends`, `splits` and `capital_gains`. Dividend and capital-gain entries carry a Unix timestamp and an amount; split entries carry a ratio such as `4:1`.

Required: symbol.

Sampled 14 Oct 2026: 92 items. Filled in every item: amount, date, timestamp. In the sample: amount: 0 to 0.27, median 0.12; date: 547,738,200 to 1,786,368,600, median 1,423,146,600; timestamp: 541,573,200 to 1,780,286,400, median 1,417,410,000.

Open in Playground

Yahoo Finance analyst data

Returns analyst data for a Yahoo Finance `symbol` such as `AAPL`, as `modules` keyed by Yahoo module name: recommendation trend, upgrade and downgrade history, price targets and estimates, where Yahoo provides them.

Required: symbol.

Sampled 14 Oct 2026: 972 items. Not in every item: action (500), currentPriceTarget (500), epochGradeDate (500), firm (500), fromGrade (450), priceTargetAction (485), priorPriceTarget (500), toGrade (500). In the sample: action: main (300), reit (148), down (27) and 2 more; currentPriceTarget: 0 to 400, median 240; firm: “JP Morgan” and 50 other values; epochGradeDate: 1,671,536,813 to 1,791,830,866, median 1,729,504,489; fromGrade: “Overweight” and 12 other values; priceTargetAction: Raises (193), Maintains (189), Lowers (75) and 1 more; priorPriceTarget: 0 to 400, median 225; toGrade: “Overweight” and 14 other values.

Open in Playground

Yahoo Finance calendar

Returns the calendar events Yahoo Finance holds for a `symbol` such as `AAPL`, under `modules.calendarEvents`. The response echoes the `symbol`, and the symbol is the only input.

Required: symbol.

Sampled 14 Oct 2026: 2 fields returned with a value. In the sample: symbol: “AAPL”.

Open in Playground

Yahoo Finance capital gains

Returns capital gain events for a Yahoo Finance `symbol`, mainly ETFs and mutual funds such as `SPY`, each with a Unix timestamp and an amount, when Yahoo provides them. The response object also has `dividends` and `splits` fields.

Required: symbol.

Open in Playground

Yahoo Finance dividends

Returns the dividend events for a Yahoo Finance `symbol` such as `AAPL`, each with a Unix timestamp and an amount. The response object also has `splits` and `capital_gains` fields.

Required: symbol.

Sampled 14 Oct 2026: 92 items. Filled in every item: amount, date, timestamp. In the sample: amount: 0 to 0.27, median 0.12; date: 547,738,200 to 1,786,368,600, median 1,423,146,600; timestamp: 541,573,200 to 1,780,286,400, median 1,417,410,000.

Open in Playground

Yahoo Finance earnings dates

Returns earnings-date rows for a Yahoo Finance `symbol`, taken from Yahoo's earnings calendar table. `limit` (max 100) and `offset` page the rows. Each row is keyed by the table's column names, such as `Earnings Date`. Returns an upstream error when Yahoo does not serve the table.

Required: symbol. Optional: limit, offset.

Open in Playground

Yahoo Finance earnings

Returns the Yahoo Finance earnings modules for a `symbol` such as `AAPL`, including `earnings` and `earningsTrend`, under `modules`. The response echoes the `symbol`, and the symbol is the only input.

Required: symbol.

Sampled 14 Oct 2026: 4 items. Filled in every item: currency, epsActual, epsDifference, epsEstimate, maxAge, period, quarter, surprisePercent. In the sample: epsActual: 1.85 to 2.84, median 2.01; period: “-4q” and 3 other values; epsDifference: 0.07 to 0.17, median 0.08; epsEstimate: 1.77 to 2.67, median 1.89; quarter: 1,759,190,400 to 1,782,777,600, median 1,767,139,200; surprisePercent: 0.03 to 0.07, median 0.05.

Open in Playground

Yahoo Finance financial statements

Returns financial statement data for a Yahoo Finance `symbol`. `statement` picks `income`, `balance-sheet` or `cash-flow` (aliases `income-statement`, `balance` and `cashflow` also work) and `period` picks `annual`, `quarterly` or `trailing`; trailing is supported for income and cash flow only. The response echoes `statement` and `period`, with the data under `modules`.

Required: symbol. Optional: statement (6 allowed values: income, income-statement, balance-sheet, balance, cash-flow, cashflow), period (3 allowed values: annual, quarterly, trailing).

Sampled 14 Oct 2026: 4 items. Filled in every item: costOfRevenue, ebit, endDate, grossProfit, incomeTaxExpense, maxAge, netIncome, totalOperatingExpenses and 1 more. Not in every item: discontinuedOperations (0), effectOfAccountingCharges (0), extraordinaryItems (0), incomeBeforeTax (0), interestExpense (0), minorityInterest (0), netIncomeApplicableToCommonShares (0), netIncomeFromContinuingOps (0) and 7 more. In the sample: endDate: 1,664,496,000 to 1,759,190,400, median 1,696,032,000; netIncome: 93,736,000,000 to 112,010,000,000, median 96,995,000,000; totalRevenue: 383,285,000,000 to 416,161,000,000, median 391,035,000,000.

Open in Playground

Yahoo Finance fund data

Returns fund data for an ETF or mutual fund `symbol` such as `SPY`, under `modules`: the fund profile, top holdings, equity holdings, bond holdings and sector weightings.

Required: symbol.

Sampled 14 Oct 2026: 11 items. Not in every item: realestate (1), consumer_cyclical (1), basic_materials (1), consumer_defensive (1), technology (1), communication_services (1), financial_services (1), utilities (1) and 3 more.

Open in Playground

Yahoo Finance history metadata

Returns the chart metadata Yahoo Finance holds for a `symbol` such as `AAPL`, in `meta`, for example `currency` and `exchangeName`. The symbol is the only input.

Required: symbol.

Open in Playground

Yahoo Finance historical prices

Returns price points for a Yahoo Finance `symbol`: open, high, low, close, adjusted close and volume with timestamps. Use `period` (default `1mo`, up to `max`) or `start` and `end`, which override it. `interval` sets the candle size (default `1d`; intraday covers recent ranges only). `include_actions` adds dividend, split and capital-gain `events`.

Required: symbol. Optional: period, start, end, interval, include_prepost, include_actions, auto_adjust, back_adjust, keepna, rounding.

Sampled 14 Oct 2026: 22 items. Filled in every item: timestamp, datetime, open, high, low, close, adj_close, volume. In the sample: timestamp: 2026-09-14 to 2026-10-13; open: 330 to 344.67, median 335.28; datetime: 2026-09-14 to 2026-10-13; high: 331.78 to 348.15, median 338.61; low: 325.81 to 341.12, median 331.65; close: 329.4 to 343.45, median 336.13; adj_close: 329.4 to 343.45, median 336.13; volume: 21,403,588 to 86,588,200, median 34,400,900.

Open in Playground

Yahoo Finance holders

Returns holder data for a Yahoo Finance `symbol` such as `AAPL`, under `modules`: the major holders breakdown (`majorHoldersBreakdown`), institutional ownership, and the fund and insider holder modules.

Required: symbol.

Sampled 14 Oct 2026: 82 items. Filled in every item: filerName, filerRelation, maxAge, ownership, shares, startDate. Not in every item: transactionText (42), value (42), filerUrl (0), moneyText (0). In the sample: filerRelation: Director (22), Officer (21), General Counsel (16) and 4 more; shares: 116 to 374,541, median 8,000; filerName: “NEWSTEAD JENNIFER” and 16 other values; ownership: D (81), I (1); startDate: 1,728,950,400 to 1,791,244,800, median 1,769,731,200; transactionText: “Sale at price 332.01 per share.” and 35 other values; value: 0 to 71,189,722, median 933,955.

Open in Playground

Yahoo Finance ticker info

Returns profile and quote information for a Yahoo Finance `symbol` such as `AAPL`, under `modules`: the profile, quote type (`quoteType`), price, statistics and summary modules. The symbol is the only input.

Required: symbol.

Sampled 14 Oct 2026: 10 items. Filled in every item: exercisedValue, fiscalYear, maxAge, name, title, unexercisedValue. Not in every item: age (8), totalPay (5), yearBorn (8). In the sample: age: 44 to 64, median 55; name: “Mr. Timothy D. Cook” and 9 other values; title: “Executive Chairman of the Board” and 9 other values; totalPay: 4,034,174 to 16,759,518, median 5,022,482; yearBorn: 1,961 to 1,981, median 1,967.

Open in Playground

Yahoo Finance ticker ISIN

Returns the ISIN for a Yahoo Finance `symbol`, for example `US0378331005` for `AAPL`. The lookup is experimental, and the `isin` field is `-` when none can be found.

Required: symbol.

Sampled 14 Oct 2026: 2 fields returned with a value. In the sample: symbol: “AAPL”; isin: “US0378331005”.

Open in Playground

Yahoo Finance ticker news

Returns the Yahoo Finance news stream for the ticker in the `symbol` path parameter, such as `AAPL`. `count` limits the items (default 8, max 250) and `tab` picks `news` (default), `all` or `press_releases`. Stories have title, provider, dates and URLs. A valid empty stream returns `news: []`.

Required: symbol. Optional: count, tab.

Sampled 14 Oct 2026: 20 items. Filled in every item: content, id.

Open in Playground

Yahoo Finance options chain

Returns the option expiration dates (`expiration_dates`, as Unix timestamps) and the current option chain for a Yahoo Finance `symbol` such as `AAPL`. Each `options` entry has an `expiration_date` with its `calls` and `puts`; `underlying` describes the underlying security.

Required: symbol.

Sampled 14 Oct 2026: 4 fields returned with a value. In the sample: symbol: “AAPL”; expiration_dates: 23 entries; options: 1 entry.

Open in Playground

Yahoo Finance options chain by expiration

Returns the calls and puts for one expiration of a Yahoo Finance `symbol`. `expiration` is a Unix timestamp, and the options endpoint lists the available ones in `expiration_dates`. The result is an `options` entry with `expiration_date`, `calls` and `puts`.

Required: symbol, expiration.

Sampled 14 Oct 2026: 4 fields returned with a value. In the sample: symbol: “AAPL”; expiration_dates: 23 entries; options: 1 entry.

Open in Playground

Yahoo Finance ticker quote

Returns fast quote fields for one Yahoo Finance `symbol` such as `AAPL`, for example `regularMarketPrice`, in a `quotes` list alongside the requested `symbols`. The symbol is the only input.

Required: symbol.

Open in Playground

Yahoo Finance SEC filings

Returns the SEC filing summaries Yahoo Finance lists for a `symbol` such as `AAPL`, under `modules.secFilings`. The response echoes the `symbol`, and the symbol is the only input.

Required: symbol.

Sampled 14 Oct 2026: 80 items. Filled in every item: date, edgarUrl, epochDate, maxAge, title, type. Not in every item: exhibits (77). In the sample: date: 2022-01-27 to 2026-09-01; epochDate: 1,643,241,600 to 1,788,220,800, median 1,711,497,600; title: “Corporate Changes & Voting Matters” and 9 other values; edgarUrl: finance.yahoo.com; exhibits: median 3 entries; type: “8-K/A” and 13 other values.

Open in Playground

Yahoo Finance historical share counts

Returns the historical shares-outstanding series for a Yahoo Finance `symbol`. `start` and `end` accept YYYY-MM-DD, RFC3339 or Unix seconds; without them the last 18 months are returned. Each point has `timestamp`, `datetime` and `shares_out`.

Required: symbol. Optional: start, end.

Sampled 14 Oct 2026: 58 items. Filled in every item: datetime, shares_out, timestamp. In the sample: datetime: 2025-04-16 to 2026-08-05; shares_out: 14,594,180,000 to 15,319,199,744, median 14,935,799,808; timestamp: 2025-04-16 to 2026-08-05.

Open in Playground

Yahoo Finance share counts

Returns the current share-count fields for a Yahoo Finance `symbol` such as `AAPL`, for example `sharesOutstanding`, in `shares`. The symbol is the only input, and the response echoes it as `symbol`.

Required: symbol.

Sampled 14 Oct 2026: 4 fields returned with a value. In the sample: shares.floatShares: 14,568,786,127; symbol: “AAPL”; shares.impliedSharesOutstanding: 14,594,180,000; shares.sharesOutstanding: 14,594,180,000.

Open in Playground

Yahoo Finance splits

Returns the stock split events for a Yahoo Finance `symbol` such as `AAPL`, each with a Unix timestamp and a split ratio such as `4:1`. The response object also has `dividends` and `capital_gains` fields.

Required: symbol.

Sampled 14 Oct 2026: 5 items. Filled in every item: date, denominator, numerator, splitRatio, timestamp. In the sample: splitRatio: 2:1 (3), 7:1 (1), 4:1 (1); date: 550,848,600 to 1,598,880,600, median 1,109,601,000; numerator: 2 to 7, median 2; timestamp: 549,518,400 to 1,590,984,000, median 1,101,877,200.

Open in Playground

Yahoo Finance sustainability

Returns ESG and sustainability scores for a Yahoo Finance `symbol` such as `AAPL`, under `modules.esgScores`. When Yahoo recognises the ticker but has no ESG data, `esgScores` comes back empty instead of an error.

Required: symbol.

Sampled 14 Oct 2026: 1 fields returned with a value, 1 empty (modules.esgScores). In the sample: symbol: “AAPL”.

Open in Playground

Yahoo Finance valuation measures

Returns the valuation measures table from Yahoo Finance key statistics for a `symbol` such as `AAPL`, as `headers` and `rows` keyed by column, for example Market Cap. Returns an upstream error when Yahoo does not serve the table.

Required: symbol.

Open in Playground

Yahoo Finance trending symbols

Returns the symbols Yahoo Finance lists as trending in a `region` such as `US`. `count` sets how many. The response has `region`, `count`, the `symbols`, and the `job_timestamp` and `start_interval` fields.

Required: region. Optional: count.

Sampled 14 Oct 2026: 5 fields returned with a value. In the sample: job_timestamp: 2026-10-13; count: 20; region: “US”; symbols: 20 entries; start_interval: 202,610,131,600.

Open in Playground