采集 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 | - |
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 通过文档化的 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 中查看当前的响应架构，并在价格页面比较基于额度的用量。