Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Yahoo Finance action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Look up stocks and other instruments on Yahoo Finance by ticker, with name, sector, industry, market cap, price, exchange, P/E ratio and dividend yield. | $1.39 per 1,000 requests | Normal |
Historical priceshistory | Pull price history for one Yahoo Finance ticker: date, open, high, low, close, volume, dividends and stock splits. | $1.39 per 1,000 requests | Normal |
Financial statementsfinancials | Get the income statement, balance sheet, cash flow and quarterly income for one Yahoo Finance ticker. | $1.39 per 1,000 requests | Normal |
Newsnews | Track recent news for a Yahoo Finance ticker, each item with headline, snippet, publisher, time and link. | $1.39 per 1,000 requests | Normal |
Analyst ratingsanalyst | See how analysts rate a stock on Yahoo Finance: the recommendation distribution over time and the history of upgrades and downgrades. | $1.39 per 1,000 requests | Normal |
Options chainsoptions | Scan the options chain for one Yahoo Finance ticker, with calls and puts showing strike, last price, bid, ask, volume, open interest and implied volatility. | $1.39 per 1,000 requests | Normal |
Trendingtrending | Get up to 200 movers from a preset Yahoo Finance list, day gainers by default, with price, change, percent change, volume, market cap and 52-week range. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Yahoo Finance action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Look up stocks and other instruments on Yahoo Finance by ticker, with name, sector, industry, market cap, price, exchange, P/E ratio and dividend yield. Pass exact symbols with any exchange suffix, or several in | keyword | tickers | Sync delivery | — | $1.39 per 1,000 requests | id · name · symbol · sector · industry · market_cap · price · currency · quote_type · exchange · pe_ratio · dividend_yield · platform |
historyHistorical prices Pull price history for one Yahoo Finance ticker: date, open, high, low, close, volume, dividends and stock splits. | keyword | interval, period | Sync delivery | — | $1.39 per 1,000 requests | symbol · date · open · high · low · close · volume · dividends · stock_splits · platform |
financialsFinancial statements Get the income statement, balance sheet, cash flow and quarterly income for one Yahoo Finance ticker. Figures are not audited and do not replace the company's own filings. | keyword | — | Sync delivery | — | $1.39 per 1,000 requests | symbol · income · balance_sheet · cash_flow · quarterly_income · platform |
newsNews Track recent news for a Yahoo Finance ticker, each item with headline, snippet, publisher, time and link. Pass one symbol per call rather than a company name; snippets do not replace reading the original article. | keyword | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · text · publisher · posted_at · symbol · platform |
analystAnalyst ratings See how analysts rate a stock on Yahoo Finance: the recommendation distribution over time and the history of upgrades and downgrades. These are third-party opinions for one ticker, not advice from EveryInfra. | keyword | — | Sync delivery | — | $1.39 per 1,000 requests | symbol · recommendation_trend · upgrades_downgrades · platform |
optionsOptions chains Scan the options chain for one Yahoo Finance ticker, with calls and puts showing strike, last price, bid, ask, volume, open interest and implied volatility. There is no expiration parameter, so check | keyword | — | Sync delivery | — | $1.39 per 1,000 requests | contract_symbol · strike · last_price · bid · ask · volume · open_interest · implied_volatility · in_the_money · expiration · symbol · expiration_dates · strikes · calls · puts · platform |
trendingTrending Get up to 200 movers from a preset Yahoo Finance list, day gainers by default, with price, change, percent change, volume, market cap and 52-week range. | screener | Sync delivery | Catalog values: defaultLimit=10, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · symbol · name · price · change · change_percent · volume · market_cap · currency · exchange · pe_ratio · fifty_two_week_range · platform |
What do the Yahoo Finance search parameters mean?
Look up stocks and other instruments on Yahoo Finance by ticker, with name, sector, industry, market cap, price, exchange, P/E ratio and dividend yield. Pass exact symbols with any exchange suffix, or several in tickers; company names are not searched, and quotes may not be real time.
keywordRequired- Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches. The history, financials, news, analyst, and options actions process one ticker per request to retrieve historical market data, financial statements, news items, analyst coverage, or options chains.Yahoo Finance: Ticker Suffixes, Exchange Delays, and Information Use — Official guidance explains that exchange ticker suffixes and data delays vary, defining data strictly for informational purposes. This explains ticker symbol and market data freshness boundaries; it does not prove that this endpoint supports real-time trading. · Checked
tickersOptional- Accepts an array of ticker symbols for the Yahoo Finance search action, overriding single-target keyword inputs. This array does not apply to other actions like history; uppercase ticker symbols with explicit exchange suffixes are recommended.
What do the Yahoo Finance history parameters mean?
Pull price history for one Yahoo Finance ticker: date, open, high, low, close, volume, dividends and stock splits. interval defaults to 1d and period to 1mo; 1m means one minute, and long ranges may not include every data point.
keywordRequired- Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches. The history, financials, news, analyst, and options actions process one ticker per request to retrieve historical market data, financial statements, news items, analyst coverage, or options chains.
intervalOptional- Defines the candlestick time step for the Yahoo Finance history action, defaulting to 1d. Allowed values include minute intervals (1m, 2m, 5m, 15m, 30m, 60m, 90m), hourly (1h), daily (1d, 5d), weekly (1wk), and monthly (1mo, 3mo). Note that 1m represents one minute, not one month, and sub-daily intervals paired with long periods may be subject to historical lookback limits.Yahoo Finance: Historical Prices, Dividends, Splits, and Frequency Selection — The official historical data page distinguishes time spans, data types, and frequency options, outlining available historical ranges and licensing restrictions. This does not indicate that this endpoint provides CSV downloads or identical complete coverage. · Checked
periodOptional- Sets the historical lookback duration for the Yahoo Finance history action, defaulting to 1mo. Supported values include days (1d, 5d), months (1mo, 3mo, 6mo), years (1y, 2y, 5y, 10y), year-to-date (ytd), and maximum available history (max). Selecting max does not guarantee a complete dataset dating back to an asset's initial public offering.Yahoo Finance: Definition of Adjusted Close — Official documentation defines adjusted close as accounting for stock splits and dividend adjustments. Because the current endpoint returns only close, this documentation cannot be used to claim that response values are adjusted. · Checked
What do the Yahoo Finance financials parameters mean?
Get the income statement, balance sheet, cash flow and quarterly income for one Yahoo Finance ticker. Figures are not audited and do not replace the company's own filings.
Full API reference: parameters, code samples, response example and health →keywordRequired- Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches. The history, financials, news, analyst, and options actions process one ticker per request to retrieve historical market data, financial statements, news items, analyst coverage, or options chains.
What do the Yahoo Finance news parameters mean?
Track recent news for a Yahoo Finance ticker, each item with headline, snippet, publisher, time and link. Pass one symbol per call rather than a company name; snippets do not replace reading the original article.
Full API reference: parameters, code samples, response example and health →keywordRequired- Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches. The history, financials, news, analyst, and options actions process one ticker per request to retrieve historical market data, financial statements, news items, analyst coverage, or options chains.
What do the Yahoo Finance analyst parameters mean?
See how analysts rate a stock on Yahoo Finance: the recommendation distribution over time and the history of upgrades and downgrades. These are third-party opinions for one ticker, not advice from EveryInfra.
Full API reference: parameters, code samples, response example and health →keywordRequired- Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches. The history, financials, news, analyst, and options actions process one ticker per request to retrieve historical market data, financial statements, news items, analyst coverage, or options chains.
What do the Yahoo Finance options parameters mean?
Scan the options chain for one Yahoo Finance ticker, with calls and puts showing strike, last price, bid, ask, volume, open interest and implied volatility. There is no expiration parameter, so check expiration for the date returned and expiration_dates for the full list.
keywordRequired- Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches. The history, financials, news, analyst, and options actions process one ticker per request to retrieve historical market data, financial statements, news items, analyst coverage, or options chains.Yahoo Finance: Ticker Suffixes, Exchange Delays, and Information Use — Official guidance explains that exchange ticker suffixes and data delays vary, defining data strictly for informational purposes. This explains ticker symbol and market data freshness boundaries; it does not prove that this endpoint supports real-time trading. · Checked
What do the Yahoo Finance trending parameters mean?
Get up to 200 movers from a preset Yahoo Finance list, day gainers by default, with price, change, percent change, volume, market cap and 52-week range. screener takes uppercase list names covering stocks, crypto, private companies and funds; a list is not a recommendation.
screenerOptional- Specifies the uppercase preset list key for the Yahoo Finance trending action. Supported equity screeners include DAY_GAINERS (default), DAY_LOSERS, MOST_ACTIVES, MOST_SHORTED_STOCKS, UNDERVALUED_GROWTH_STOCKS, GROWTH_TECHNOLOGY_STOCKS, AGGRESSIVE_SMALL_CAPS, and SMALL_CAP_GAINERS; crypto lists include ALL_CRYPTOCURRENCIES_US, DAY_GAINERS_CRYPTOCURRENCIES, DAY_LOSERS_CRYPTOCURRENCIES, and MOST_ACTIVES_CRYPTOCURRENCIES; private company lists include HIGHEST_VALUATION_PRIVATE_COMPANY, WEEK_GAINERS_PRIVATE_COMPANY, RECENTLY_FUNDED_PRIVATE_COMPANY, and MOST_FUNDED_PRIVATE_COMPANY; fund lists include TOP_MUTUAL_FUNDS, DAY_GAINERS_MUTUAL_FUNDS, PORTFOLIO_ANCHORS, SOLID_LARGE_GROWTH_FUNDS, SOLID_MIDCAP_GROWTH_FUNDS, CONSERVATIVE_FOREIGN_FUNDS, and HIGH_YIELD_BOND. Category availability does not guarantee current data or constitute financial advice.Yahoo Finance: Exchange Delays in Trending Ticker Lists — Official guidance states that data delays vary by exchange and that data is strictly for informational purposes. This illustrates the market and freshness boundaries for trending lists; it does not prove that the endpoint lists are real-time or constitute investment advice. · Checked
How to use the Yahoo Finance API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"yahoo_finance","action":"search","params":{"keyword":"<keyword>"}}'
Yahoo Finance API questions
What can I retrieve with the Yahoo Finance API?
Set platform to yahoo_finance. The current catalog lists search, historical prices, financial statements, news, analyst ratings, and more. These action names identify different Yahoo Finance objects or views; they are not interchangeable search modes.
Which input starts a Yahoo Finance `search` request?
Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches. The history, financials, news, analyst, and options actions process one ticker per request to retrieve historical market data, financial statements, news items, analyst coverage, or options chains. Send it as keyword inside params.
Which fields can Yahoo Finance `search` return?
Its declared schema includes name, symbol, sector, and industry. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Yahoo Finance action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.