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 | - |
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 normalized fast quote fields for one Yahoo Finance symbol.
MCP tool yahoo_finance_ticker_quote
/yahoo-finance/searchReturns normalized Yahoo Finance quotes, news, lists, and optional research reports for a query.
MCP tool yahoo_finance_search
/yahoo-finance/ticker/{symbol}/historyReturns normalized OHLCV points for a symbol. Use either period or start/end.
MCP tool yahoo_finance_ticker_history
/yahoo-finance/ticker/{symbol}/infoReturns normalized profile, quote type, price, statistics, and summary modules for a symbol.
MCP tool yahoo_finance_ticker_info
/yahoo-finance/trending/{region}Returns trending Yahoo Finance symbols for a region.
MCP tool yahoo_finance_trending
/yahoo-finance/market/{market}/summaryReturns Yahoo Finance market summary rows for a market such as US.
MCP tool yahoo_finance_market_summary
/yahoo-finance/market/{market}/statusReturns Yahoo Finance open/close status for a market such as US.
MCP tool yahoo_finance_market_status
/yahoo-finance/screener/{id}Runs a predefined Yahoo Finance screener such as day_gainers or most_actives.
MCP tool yahoo_finance_screener
/yahoo-finance/screenersLists the predefined screeners supported by the Yahoo Finance integration.
MCP tool yahoo_finance_screeners
/yahoo-finance/ticker/{symbol}/newsReturns Yahoo Finance news search results for a symbol.
MCP tool yahoo_finance_ticker_news
/yahoo-finance/ticker/{symbol}/financialsReturns annual, quarterly, or supported trailing income, balance sheet, or cash flow statement data.
MCP tool yahoo_finance_ticker_financials
/yahoo-finance/ticker/{symbol}/earningsReturns Yahoo Finance earnings modules for a symbol.
MCP tool yahoo_finance_ticker_earnings
/yahoo-finance/ticker/{symbol}/optionsReturns option expiration dates and the current option chain for a symbol.
MCP tool yahoo_finance_ticker_options
/yahoo-finance/calendarsLists global Yahoo Finance calendar types supported by this integration.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"calendars":["earnings","economic-events","ipo","splits"]}} ```
MCP tool yahoo_finance_calendars
/yahoo-finance/calendars/{type}Returns global Yahoo Finance calendar rows for earnings, IPOs, economic events, or splits.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"type":"earnings","limit":5,"offset":0,"rows":[{"Symbol":"AAPL","Company":"Apple Inc."}]}} ```
MCP tool yahoo_finance_calendar_results
/yahoo-finance/downloadReturns historical price data for up to 25 symbols.
MCP tool yahoo_finance_download
/yahoo-finance/sectorsLists Yahoo Finance sector keys that can be queried with the sector endpoint.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"items":[{"key":"technology","name":"Technology"}]}} ```
MCP tool yahoo_finance_sectors
/yahoo-finance/sectors/{key}Returns overview, top companies, ETFs, mutual funds, industries, and research reports for a sector key.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"key":"technology","name":"Technology","industries":[{"key":"semiconductors","name":"Semiconductors"}]}} ```
MCP tool yahoo_finance_sector
/yahoo-finance/industriesLists Yahoo Finance industry keys that can be queried with the industry endpoint.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"items":[{"key":"semiconductors","name":"Semiconductors"}]}} ```
MCP tool yahoo_finance_industries
/yahoo-finance/industries/{key}Returns overview, sector linkage, top companies, growth companies, and research reports for an industry key.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"key":"semiconductors","name":"Semiconductors","sector_key":"technology"}} ```
MCP tool yahoo_finance_industry
/yahoo-finance/ticker/{symbol}/actionsReturns dividends, splits, and capital gains for a symbol.
MCP tool yahoo_finance_ticker_actions
/yahoo-finance/ticker/{symbol}/dividendsReturns dividend events for a symbol.
MCP tool yahoo_finance_ticker_dividends
/yahoo-finance/ticker/{symbol}/splitsReturns split events for a symbol.
MCP tool yahoo_finance_ticker_splits
/yahoo-finance/ticker/{symbol}/capital-gainsReturns capital gain events for ETF or mutual fund symbols when Yahoo provides them.
MCP tool yahoo_finance_ticker_capital_gains
/yahoo-finance/ticker/{symbol}/analystsReturns recommendations, upgrades/downgrades, price targets, and estimate modules where Yahoo provides them.
MCP tool yahoo_finance_ticker_analysts
/yahoo-finance/ticker/{symbol}/holdersReturns major, institutional, fund, and insider holder modules for a symbol.
MCP tool yahoo_finance_ticker_holders
/yahoo-finance/ticker/{symbol}/sustainabilityReturns ESG and sustainability modules for a symbol.
MCP tool yahoo_finance_ticker_sustainability
/yahoo-finance/ticker/{symbol}/fundsReturns fund profile, top holdings, equity/bond holdings, and sector weighting modules for ETF and mutual fund symbols.
MCP tool yahoo_finance_ticker_funds
/yahoo-finance/ticker/{symbol}/isinReturns the experimental yfinance-compatible ISIN lookup result for a symbol.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"symbol":"AAPL","isin":"US0378331005"}} ```
MCP tool yahoo_finance_ticker_isin
/yahoo-finance/ticker/{symbol}/sec-filingsReturns Yahoo Finance SEC filing summaries for a symbol.
MCP tool yahoo_finance_ticker_sec_filings
/yahoo-finance/ticker/{symbol}/sharesReturns current share-count fields from Yahoo key statistics.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"symbol":"AAPL","shares":{"sharesOutstanding":15000000000}}} ```
MCP tool yahoo_finance_ticker_shares
/yahoo-finance/ticker/{symbol}/shares-fullReturns historical shares-out rows from Yahoo fundamentals timeseries.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"symbol":"AAPL","points":[{"timestamp":1716422400,"datetime":"2024-05-23T00:00:00Z","shares_out":15000000000}]}} ```
MCP tool yahoo_finance_ticker_shares_full
/yahoo-finance/ticker/{symbol}/valuationReturns the valuation table from the Yahoo Finance key statistics page when Yahoo serves the table.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"symbol":"AAPL","headers":["Market Cap","Current"],"rows":[{"Market Cap":"3.0T"}]}} ```
MCP tool yahoo_finance_ticker_valuation
/yahoo-finance/ticker/{symbol}/earnings-datesReturns standalone earnings-date rows from Yahoo Finance calendar HTML when Yahoo serves the table.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"symbol":"AAPL","limit":12,"offset":0,"rows":[{"Earnings Date":"October 30, 2025 at 4 PM EDT"}]}} ```
MCP tool yahoo_finance_ticker_earnings_dates
/yahoo-finance/ticker/{symbol}/calendarReturns Yahoo Finance calendar events for a symbol.
MCP tool yahoo_finance_ticker_calendar
/yahoo-finance/ticker/{symbol}/history-metadataReturns Yahoo Finance chart metadata for a symbol.
Response notes
Example response: ```json {"code":200,"msg":"OK","data":{"symbol":"AAPL","meta":{"currency":"USD","exchangeName":"NMS"}}} ```
MCP tool yahoo_finance_ticker_history_metadata
/yahoo-finance/ticker/{symbol}/options/{expiration}Returns calls and puts for a specific Unix expiration timestamp.
MCP tool yahoo_finance_ticker_options_expiration
/yahoo-finance/lookupReturns Yahoo Finance instrument matches for a query, optionally filtered by instrument type.
MCP tool yahoo_finance_lookup
/yahoo-finance/screenerRuns a constrained Yahoo Finance custom screener query using Yahoo's public screener JSON shape.
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.
OpenFAQ
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.
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.