Yahoo Finance APIyahoofinance.com ↗
Access real-time stock quotes, OHLCV history, company profiles, and financial news from Yahoo Finance. 6 endpoints covering global equities and ETFs.
What is the Yahoo Finance API?
The Yahoo Finance API provides 6 endpoints covering real-time quotes, historical OHLCV data, company fundamentals, and news for global equities and ETFs. The get_quote endpoint returns a full market snapshot — including regularMarketPrice, marketCap, bid/ask, and volume — for one or more tickers in a single batch request. Alongside live data, get_historical_data delivers timestamped price records across intervals from 1-minute intraday to monthly candlesticks.
curl -X GET 'https://api.parse.bot/scraper/4bf1943d-6bf2-4dcc-bc83-994300c2633d/get_quote?symbols=AAPL%2CMSFT' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve real-time stock quotes including current price, bid/ask, volume, market cap, and market status for one or more tickers. Supports batch lookups via comma-separated symbols. Each quote carries the full market snapshot visible on the Yahoo Finance quote page.
| Param | Type | Description |
|---|---|---|
| symbolsrequired | string | Comma-separated list of stock ticker symbols (e.g., AAPL,MSFT,TSLA). |
{
"type": "object",
"fields": {
"quotes": "array of Quote objects with real-time market data including regularMarketPrice, regularMarketChange, regularMarketVolume, marketCap, bid, ask, and symbol"
},
"sample": {
"data": {
"quotes": [
{
"ask": 291.94,
"bid": 292.11,
"symbol": "AAPL",
"currency": "USD",
"exchange": "NMS",
"marketCap": 4282539048960,
"shortName": "Apple Inc.",
"marketState": "POST",
"regularMarketPrice": 291.58,
"regularMarketChange": 1.03,
"regularMarketVolume": 49237715
}
]
},
"status": "success"
}
}About the Yahoo Finance API
Market Data and Quotes
The get_quote endpoint accepts a comma-separated symbols parameter and returns an array of Quote objects. Each object carries regularMarketPrice, regularMarketChange, regularMarketVolume, and marketCap, giving you the same snapshot visible on a Yahoo Finance quote page. Batch lookups reduce round-trips when monitoring a portfolio of tickers.
Historical Price Data
get_historical_data takes a required symbol plus optional range and interval parameters. The response includes an array of PriceRecord objects with timestamp, open, high, low, close, and volume, as well as the currency of the prices. Intraday intervals (1m through 90m) are constrained to shorter ranges (1d–5d); daily, weekly, and monthly intervals work across any supported range. For pinpoint single-day lookups, get_closing_price returns one record per call with both close and adj_close (dividend- and split-adjusted), interpreted in the listing exchange's local timezone via exchange_timezone.
Company Fundamentals
get_company_profile returns four structured modules for a given symbol. assetProfile includes sector, industry, longBusinessSummary, and companyOfficers. financialData exposes totalRevenue, profitMargins, and recommendationKey. summaryDetail adds dividendRate, dividendYield, trailingPE, and the 52-week range. defaultKeyStatistics covers enterpriseValue, forwardPE, pegRatio, sharesOutstanding, and bookValue.
News and Ticker Search
get_stock_news returns up to a configurable count of NewsArticle objects for a ticker, each with title, publisher, link, providerPublishTime, and relatedTickers. search_tickers accepts a free-text query and returns TickerMatch objects with symbol, shortname, longname, exchange, quoteType, sector, and industry — useful for resolving company names to exchange-listed symbols across global markets.
The Yahoo Finance API is a managed, monitored endpoint for yahoofinance.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when yahoofinance.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official yahoofinance.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a portfolio tracker that polls
get_quotein batch to display live prices and market cap for a watchlist. - Feed
get_historical_dataat daily intervals into a backtesting engine for technical-indicator strategies. - Populate a stock screener with
get_company_profilefields likeprofitMargins,trailingPE, andrecommendationKey. - Resolve ambiguous company names to ticker symbols using
search_tickersbefore passing them to other endpoints. - Aggregate
get_stock_newsheadlines withproviderPublishTimeto build a sentiment timeline around earnings dates. - Use
get_closing_pricewithadj_closeto compute total-return metrics that account for dividends and splits. - Enrich a financial dashboard with executive names from
companyOfficersin theassetProfilemodule.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Yahoo Finance offer an official developer API?+
What does `get_closing_price` return differently from `get_historical_data`?+
get_closing_price is scoped to exactly one ticker and one calendar date per request. It returns close, adj_close (adjusted for dividends and splits), open, high, low, volume, the exchange full name, and exchange_timezone. get_historical_data covers ranges with multiple records but does not return adj_close or exchange_timezone. Use get_closing_price when you need the adjusted figure for a specific date.Are intraday intervals available for any date range in `get_historical_data`?+
Does the API cover options chains or futures contracts?+
Can I retrieve financial statements such as income statements or balance sheets?+
get_company_profile endpoint exposes high-level metrics like totalRevenue, profitMargins, and enterpriseValue, but full line-item financial statements are not returned. You can fork this API on Parse and revise it to add an endpoint targeting income statement, balance sheet, or cash flow data.