Collect Yahoo Finance quote pages, market data, historical prices, screeners, calendars, and ticker research modules as structured JSON for dashboards, watchlists, and agent-native workflows.
Structured output
Use Crawlora's Yahoo Finance Scraper API to transform supported public Yahoo Finance pages and API-backed modules into structured JSON. Crawlora handles endpoint-specific request shaping, response normalization, documented errors, Playground examples, and credit-based usage metadata.
Finance workflows
Yahoo Finance coverage helps teams collect public quote, search, history, calendar, screener, market summary, and ticker module data without maintaining separate scrapers for each finance page or response shape.
Finance market data workflowsRequest schema
These parameters come from the active Yahoo Finance ticker quote catalog entry.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| symbol | string | Yes | Yahoo Finance symbol such as AAPL | AAPL |
Example JSON
This example is rendered from the active endpoint catalog so the page stays aligned with Docs and Playground.
{
"code": 200,
"msg": "OK",
"data": {
"symbols": [
"AAPL"
],
"quotes": [
{
"symbol": "AAPL",
"regularMarketPrice": 211
}
]
}
}Endpoint catalog
/yahoo-finance/ticker/{symbol}/quoteReturns 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.
MCP tool yahoo_finance_ticker_quote
/yahoo-finance/searchSearches 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.
MCP tool yahoo_finance_search
/yahoo-finance/ticker/{symbol}/historyReturns 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`.
MCP tool yahoo_finance_ticker_history
/yahoo-finance/ticker/{symbol}/infoReturns 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.
MCP tool yahoo_finance_ticker_info
/yahoo-finance/trending/{region}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.
MCP tool yahoo_finance_trending
/yahoo-finance/market/{market}/summaryReturns 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`.
MCP tool yahoo_finance_market_summary
/yahoo-finance/market/{market}/statusReturns 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.
MCP tool yahoo_finance_market_status
/yahoo-finance/screener/{id}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`.
MCP tool yahoo_finance_screener
/yahoo-finance/screenersLists 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}`.
MCP tool yahoo_finance_screeners
/yahoo-finance/ticker/{symbol}/newsReturns 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: []`.
MCP tool yahoo_finance_ticker_news
/yahoo-finance/ticker/{symbol}/financialsReturns 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`.
MCP tool yahoo_finance_ticker_financials
/yahoo-finance/ticker/{symbol}/earningsReturns 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.
MCP tool yahoo_finance_ticker_earnings
/yahoo-finance/ticker/{symbol}/optionsReturns 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.
MCP tool yahoo_finance_ticker_options
/yahoo-finance/calendarsLists the Yahoo Finance calendar types available through the API: `earnings`, `ipo`, `economic-events` and `splits`. The list is static. Takes no parameters.
MCP tool yahoo_finance_calendars
/yahoo-finance/calendars/{type}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`.
MCP tool yahoo_finance_calendar_results
/yahoo-finance/downloadReturns 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.
MCP tool yahoo_finance_download
/yahoo-finance/sectorsLists 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.
MCP tool yahoo_finance_sectors
/yahoo-finance/sectors/{key}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`.
MCP tool yahoo_finance_sector
/yahoo-finance/industriesLists 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.
MCP tool yahoo_finance_industries
/yahoo-finance/industries/{key}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`.
MCP tool yahoo_finance_industry
/yahoo-finance/ticker/{symbol}/actionsReturns 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`.
MCP tool yahoo_finance_ticker_actions
/yahoo-finance/ticker/{symbol}/dividendsReturns 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.
MCP tool yahoo_finance_ticker_dividends
/yahoo-finance/ticker/{symbol}/splitsReturns 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.
MCP tool yahoo_finance_ticker_splits
/yahoo-finance/ticker/{symbol}/capital-gainsReturns 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.
MCP tool yahoo_finance_ticker_capital_gains
/yahoo-finance/ticker/{symbol}/analystsReturns 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.
MCP tool yahoo_finance_ticker_analysts
/yahoo-finance/ticker/{symbol}/holdersReturns 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.
MCP tool yahoo_finance_ticker_holders
/yahoo-finance/ticker/{symbol}/sustainabilityReturns 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.
MCP tool yahoo_finance_ticker_sustainability
/yahoo-finance/ticker/{symbol}/fundsReturns 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.
MCP tool yahoo_finance_ticker_funds
/yahoo-finance/ticker/{symbol}/isinReturns 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.
MCP tool yahoo_finance_ticker_isin
/yahoo-finance/ticker/{symbol}/sec-filingsReturns 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.
MCP tool yahoo_finance_ticker_sec_filings
/yahoo-finance/ticker/{symbol}/sharesReturns 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`.
MCP tool yahoo_finance_ticker_shares
/yahoo-finance/ticker/{symbol}/shares-fullReturns 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`.
MCP tool yahoo_finance_ticker_shares_full
/yahoo-finance/ticker/{symbol}/valuationReturns 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.
MCP tool yahoo_finance_ticker_valuation
/yahoo-finance/ticker/{symbol}/earnings-datesReturns 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.
MCP tool yahoo_finance_ticker_earnings_dates
/yahoo-finance/ticker/{symbol}/calendarReturns 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.
MCP tool yahoo_finance_ticker_calendar
/yahoo-finance/ticker/{symbol}/history-metadataReturns 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.
MCP tool yahoo_finance_ticker_history_metadata
/yahoo-finance/ticker/{symbol}/options/{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`.
MCP tool yahoo_finance_ticker_options_expiration
/yahoo-finance/lookupLooks 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.
MCP tool yahoo_finance_lookup
/yahoo-finance/screenerRuns 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.
MCP tool yahoo_finance_screener_custom
Managed execution
Crawlora exposes supported Yahoo Finance public data surfaces through documented API endpoints with auth metadata, schemas, Playground examples, credit costs, and structured failure behavior.
Endpoint-specific request handling for quote, history, search, screener, calendar, market, and ticker pages
Normalized JSON responses with documented schemas and examples where available
Generated Docs and Playground pages from the active API catalog
Credit-based usage tied to backend billing weights
Clear upstream failure context instead of silent bad data
API-key protected production routes for backend integrations
Build or buy
Use this comparison to decide whether to maintain scraping infrastructure internally or call a managed endpoint.
| Requirement | Building internally | Crawlora |
|---|---|---|
| Endpoint coverage | Maintain separate collectors for quotes, history, calendars, screeners, and ticker pages. | Use documented Yahoo Finance endpoint families from one API surface. |
| Parser maintenance | Update selectors and response handling as public pages change. | Use endpoint-specific extraction maintained behind Crawlora APIs. |
| Schema normalization | Normalize mixed quote, market, calendar, and ticker modules into your own model. | Receive structured JSON from documented endpoint schemas. |
| Developer testing | Build your own request console and examples. | Use Docs and Playground pages generated from the active catalog. |
| Usage billing | Build endpoint weighting, credits, and limits yourself. | Use credit-based usage with published endpoint weights. |
| Failure handling | Classify empty pages, upstream changes, and unavailable modules yourself. | Receive documented errors for unusable upstream responses. |
Crawlora provides structured public web data extraction for supported Yahoo Finance pages and modules. Crawlora is not the official Yahoo Finance API. Crawlora is not a broker, investment adviser, exchange data vendor, or real-time trading data provider. Data may be delayed, incomplete, or change when upstream pages change. Do not use Crawlora as the sole source for trading, investment, compliance, tax, accounting, or risk decisions. Customers are responsible for ensuring their use complies with applicable laws, third-party rights, platform terms, and Crawlora terms.
Related APIs
Connect this endpoint with adjacent Crawlora search, monitoring, docs, and pricing pages.
Pair Yahoo Finance data with Google Finance quote, chart, market, and news coverage.
OpenConnect public market research with startup launch and product discovery data.
OpenAdd website and competitive intelligence signals.
OpenCollect company intelligence for supported public profiles.
OpenReview plans, credits, limits, and usage options.
OpenBrowse the full active endpoint catalog.
OpenHow to scrape Yahoo Finance
Crawlora's Yahoo Finance endpoints are GETs (plus two POST batch routes) that turn the public Yahoo Finance ticker, market and screener pages into JSON. Per symbol: /yahoo-finance/ticker/{symbol}/quote, /yahoo-finance/ticker/{symbol}/info, /yahoo-finance/ticker/{symbol}/history (OHLCV by period or start and end, with interval), /yahoo-finance/ticker/{symbol}/financials (income, balance sheet or cash flow by period), plus options, dividends, splits, earnings, analysts, holders, news, sustainability, valuation, shares and SEC filing summaries. Market-wide: /yahoo-finance/search, /yahoo-finance/lookup, /yahoo-finance/trending/{region}, /yahoo-finance/market/{market}/summary and status, the predefined and custom screeners, the calendars, and sector and industry pages. POST /yahoo-finance/download returns history for up to 25 symbols in one call.
GET /yahoo-finance/search?q=<company> or /yahoo-finance/lookup?query=<text>&type=<equity, etf …> returns matching instruments with their Yahoo symbols. Store the symbol; it is the key for every ticker route.
GET /yahoo-finance/ticker/{symbol}/quote for fast quote fields, /yahoo-finance/ticker/{symbol}/info for profile, statistics and summary modules, and /yahoo-finance/ticker/{symbol}/history?period=1y&interval=1d (or start and end) for normalized OHLCV points with include_actions for dividends and splits. POST /yahoo-finance/download to fetch history for up to 25 symbols at once.
GET /yahoo-finance/ticker/{symbol}/financials?statement=income&period=annual (or quarterly), plus /yahoo-finance/ticker/{symbol}/earnings, /yahoo-finance/ticker/{symbol}/analysts, /yahoo-finance/ticker/{symbol}/holders, /yahoo-finance/ticker/{symbol}/options and /yahoo-finance/ticker/{symbol}/dividends for the research modules Yahoo shows on the ticker pages.
GET /yahoo-finance/screeners lists the predefined screens (day_gainers, most_actives …) and /yahoo-finance/screener/{id} runs one; POST /yahoo-finance/screener runs a custom query in Yahoo's screener JSON shape. /yahoo-finance/calendars/{type} returns earnings, IPO, economic and split calendars, and /yahoo-finance/trending/{region} and /yahoo-finance/market/{market}/summary give the daily market view.
FAQ
Answers for developers evaluating Crawlora for supported public Yahoo Finance data workflows.
Yes. Crawlora provides Yahoo Finance endpoints for supported public Yahoo Finance pages and modules, including quotes, search, history, market summaries, calendars, screeners, and ticker modules.
No. Crawlora is not the official Yahoo Finance API. Crawlora provides structured public web data extraction endpoints for supported Yahoo Finance surfaces.
The active catalog includes quote, search, historical prices, history metadata, news, market status, market summary, trending symbols, calendars, sectors, industries, predefined and custom screeners, financials, earnings, analysts, holders, options, dividends, splits, shares, sustainability, valuation, and related ticker modules where supported.
No. Crawlora is not a real-time trading data provider. Data may be delayed, incomplete, or change when upstream pages change. Do not use Crawlora as the sole source for trading, investment, compliance, tax, accounting, or risk decisions.
No. Crawlora does not provide investment advice, brokerage services, exchange data licenses, trading recommendations, or risk decisions.
Yes. Open the Yahoo Finance platform page or endpoint-specific Playground pages to inspect parameters, cURL examples, sample JSON, docs links, and credit costs.
Crawlora surfaces documented errors for unusable upstream responses. Customers should handle retries, empty states, and upstream availability changes in their integrations.
Yahoo shut down its official Finance API in 2017. Most alternatives, including the popular yfinance Python library, reverse-engineer Yahoo's public pages and can break silently whenever Yahoo changes its layout or rate-limits requests. Crawlora maintains Yahoo Finance as a documented, versioned API with schemas, credit-based billing, and structured error handling instead of a self-maintained scraper.
GET /yahoo-finance/ticker/{symbol}/quote for the quote, /yahoo-finance/ticker/{symbol}/history for OHLCV and /yahoo-finance/ticker/{symbol}/financials for statements, plus the other ticker routes for options, dividends, earnings, analysts, holders and news; resolve an unknown symbol first with Crawlora's /yahoo-finance/search endpoint. Everything returns normalized JSON.
It covers the same public Yahoo Finance modules (quote, info, history, financials, options, actions, holders, analysts, sustainability, ISIN and more) as hosted endpoints, so you get yfinance-style fields without running scrapers that break when Yahoo changes its page or blocks your IP.
Yes. POST Crawlora's /yahoo-finance/download endpoint with up to 25 symbols and a period or date range to get historical price data for all of them in one call.
Yes. the /yahoo-finance/screener/{id} endpoint runs Yahoo's predefined screeners such as day_gainers or most_actives, /yahoo-finance/screener runs a custom query, and /yahoo-finance/calendars/{type} returns the earnings, IPO, economic-events and splits calendars with date and market-cap filters.
It is the public page data Yahoo shows, with whatever delay Yahoo applies, not a licensed exchange feed. Use it for research, dashboards and monitoring rather than execution or compliance.
Guides
Read Crawlora guides and comparisons that use the Yahoo Finance API.
Test Yahoo Finance ticker quote in Playground, inspect the current response schema in Docs, and compare credit-based usage on the pricing page.