采集 Yahoo Finance 的行情页面、市场数据、历史价格、筛选器、日历和股票研究模块，转换为结构化 JSON，用于仪表盘、关注列表和智能体原生工作流。
Structured output
使用 Crawlora 的 Yahoo Finance 数据抓取 API，将支持的公开 Yahoo Finance 页面及其背后的 API 模块转化为结构化 JSON。Crawlora 负责处理端点专属的请求构造、响应规范化、文档化错误、Playground 示例以及基于额度的用量元数据。
金融工作流
Yahoo Finance 的覆盖范围可以帮助团队采集公开的行情、搜索、历史、日历、筛选器、市场概览和股票模块数据，而无需为每个金融页面或每种响应结构分别维护抓取器。
金融市场数据工作流Request 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 通过文档化的 API 端点暴露支持的 Yahoo Finance 公开数据接口，配有认证元数据、架构、Playground 示例、额度成本和结构化的故障处理。
针对行情、历史、搜索、筛选器、日历、市场和股票页面的端点专属请求处理
在可用时提供带文档化架构和示例的规范化 JSON 响应
由活跃 API 目录生成的 Docs 和 Playground 页面
与后端计费权重挂钩的额度计费
在数据异常时提供清晰的上游故障背景，而非静默返回错误数据
面向后端集成、受 API 密钥保护的生产路由
Build or buy
Use this comparison to decide whether to maintain scraping infrastructure internally or call a managed endpoint.
| Requirement | Building internally | Crawlora |
|---|---|---|
| 端点覆盖范围 | 需要为行情、历史、日历、筛选器和股票页面分别维护采集器。 | 通过一个 API 界面使用文档化的 Yahoo Finance 端点系列。 |
| 解析器维护 | 需要随公开页面的变化更新选择器和响应处理逻辑。 | 使用 Crawlora API 背后维护的端点专属提取逻辑。 |
| 架构规范化 | 需要将混杂的行情、市场、日历和股票模块规范化为自己的模型。 | 从文档化的端点架构中获取结构化 JSON。 |
| 开发者测试 | 需要自建请求控制台和示例。 | 使用由当前活跃目录生成的 Docs 和 Playground 页面。 |
| 用量计费 | 需要自行构建端点权重、额度和限制。 | 使用已发布端点权重的基于额度的用量计费。 |
| 故障处理 | 需要自行区分空页面、上游变化和不可用模块。 | 针对不可用的上游响应获取文档化的错误。 |
Crawlora 为支持的 Yahoo Finance 页面和模块提供结构化网络公开数据提取。Crawlora 并非 Yahoo Finance 官方 API。Crawlora 不是经纪商、投资顾问、交易所数据供应商或实时交易数据提供方。数据可能存在延迟、不完整，或因上游页面变化而调整。请勿将 Crawlora 作为交易、投资、合规、税务、会计或风险决策的唯一依据。客户需自行确保其使用符合适用法律、第三方权利、平台条款及 Crawlora 条款。
Related APIs
Connect this endpoint with adjacent Crawlora search, monitoring, docs, and pricing pages.
How to scrape Yahoo Finance
Crawlora 的 Yahoo Finance 端点是 GET 请求（另外还有两个 POST 批量路由），将公开的 Yahoo Finance 股票、市场和筛选器页面转化为 JSON。按代码维度：/yahoo-finance/ticker/{symbol}/quote、/yahoo-finance/ticker/{symbol}/info、/yahoo-finance/ticker/{symbol}/history（按 period 或 start 和 end 获取 OHLCV，支持 interval）、/yahoo-finance/ticker/{symbol}/financials（按 period 获取利润表、资产负债表或现金流量表），此外还有期权、股息、拆股、盈利、分析师、持股方、新闻、可持续性、估值、股本和 SEC 文件摘要。市场维度：/yahoo-finance/search、/yahoo-finance/lookup、/yahoo-finance/trending/{region}、/yahoo-finance/market/{market}/summary 及 status、预定义和自定义筛选器、日历，以及行业和板块页面。POST /yahoo-finance/download 可在一次调用中返回最多 25 个代码的历史数据。
GET /yahoo-finance/search?q=<公司名> 或 /yahoo-finance/lookup?query=<文本>&type=<equity、etf 等> 会返回匹配的证券及其 Yahoo 代码。请存储该代码；它是其余所有股票路由所需要的键。
GET /yahoo-finance/ticker/{symbol}/quote 获取快速行情字段，/yahoo-finance/ticker/{symbol}/info 获取概览、统计和摘要模块，/yahoo-finance/ticker/{symbol}/history?period=1y&interval=1d（或 start 和 end）获取规范化的 OHLCV 数据点，配合 include_actions 参数可获取股息和拆股信息。POST /yahoo-finance/download 可一次性获取最多 25 个代码的历史数据。
GET /yahoo-finance/ticker/{symbol}/financials?statement=income&period=annual（或 quarterly），此外还有 /yahoo-finance/ticker/{symbol}/earnings、/yahoo-finance/ticker/{symbol}/analysts、/yahoo-finance/ticker/{symbol}/holders、/yahoo-finance/ticker/{symbol}/options 和 /yahoo-finance/ticker/{symbol}/dividends，获取 Yahoo 在股票页面上展示的各项研究模块。
GET /yahoo-finance/screeners 列出预定义的筛选器（day_gainers、most_actives 等），/yahoo-finance/screener/{id} 运行其中一个；POST /yahoo-finance/screener 以 Yahoo 筛选器的 JSON 格式运行自定义查询。/yahoo-finance/calendars/{type} 返回盈利、IPO、经济和拆股日历，/yahoo-finance/trending/{region} 和 /yahoo-finance/market/{market}/summary 提供每日市场概览。
FAQ
面向正在评估 Crawlora 是否适用于支持的公开 Yahoo Finance 数据工作流的开发者的解答。
是的。Crawlora 为支持的公开 Yahoo Finance 页面和模块提供端点，包括行情、搜索、历史、市场概览、日历、筛选器和股票模块。
不是。Crawlora 并非 Yahoo Finance 官方 API。Crawlora 为支持的 Yahoo Finance 数据接口提供结构化网络公开数据提取端点。
当前目录包括行情、搜索、历史价格、历史元数据、新闻、市场状态、市场概览、热门股票、日历、板块、行业、预定义及自定义筛选器、财务数据、盈利、分析师、持股方、期权、股息、拆股、股本、可持续性、估值，以及在支持范围内的相关股票模块。
不可以。Crawlora 不是实时交易数据提供方。数据可能存在延迟、不完整，或因上游页面变化而调整。请勿将 Crawlora 作为交易、投资、合规、税务、会计或风险决策的唯一依据。
不提供。Crawlora 不提供投资建议、经纪服务、交易所数据授权、交易建议或风险决策。
可以。打开 Yahoo Finance 平台页面或端点专属的 Playground 页面，即可查看参数、cURL 示例、示例 JSON、文档链接和额度成本。
Crawlora 会为不可用的上游响应提供文档化的错误。客户应在自己的集成中处理重试、空状态和上游可用性变化。
Yahoo 已于 2017 年关闭了其官方的 Finance API。大多数替代方案，包括常用的 yfinance Python 库，都是对 Yahoo 公开页面进行逆向工程，一旦 Yahoo 更改页面布局或对请求限流，就可能静默失效。Crawlora 将 Yahoo Finance 维护为一个文档化、带版本管理的 API，配有架构、基于额度的计费和结构化的错误处理，而不是一个自行维护的抓取器。
用 GET /yahoo-finance/ticker/{symbol}/quote 获取行情，/yahoo-finance/ticker/{symbol}/history 获取 OHLCV 数据，/yahoo-finance/ticker/{symbol}/financials 获取财报，此外还有覆盖期权、股息、盈利、分析师、持股方和新闻的其他股票路由；如果不确定代码，先用 Crawlora 的 /yahoo-finance/search 端点进行解析。所有内容都返回规范化 JSON。
它以托管端点的形式覆盖了同样的公开 Yahoo Finance 模块（行情、概览、历史、财报、期权、股权变动、持股方、分析师、可持续性、ISIN 等），因此你可以获得 yfinance 风格的字段，而无需运行那些在 Yahoo 更改页面或封锁你的 IP 时就会失效的抓取器。
可以。对 Crawlora 的 /yahoo-finance/download 端点发起 POST 请求，传入最多 25 个代码及一个时间段或日期范围，即可在一次调用中获取全部数据的历史价格。
支持。/yahoo-finance/screener/{id} 端点运行 Yahoo 的预定义筛选器（如 day_gainers 或 most_actives），/yahoo-finance/screener 运行自定义查询，/yahoo-finance/calendars/{type} 返回盈利、IPO、经济事件和拆股日历，并支持日期和市值筛选。
它是 Yahoo 在页面上展示的公开数据，带有 Yahoo 所应用的任何延迟，而不是授权的交易所数据。请将其用于研究、仪表盘和监控，而不是用于交易执行或合规场景。
Guides
Read Crawlora guides and comparisons that use the Yahoo Finance API.
在 Playground 中测试 Yahoo Finance ticker quote，在 Docs 中查看当前的响应架构，并在价格页面比较基于额度的用量。