EveryData platform API

Yahoo Finance API

Q: 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.

Q: 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 source record, and every other action has its own field list.

Yahoo Finance separates Yahoo Finance quotes, price history, statements, news, analyst ratings, options, and screeners across 7 documented actions (`search`, `history`, `financials`), keeping discovery and object-detail contracts distinct.

Yahoo Finance keeps `search` results separate from `history` rows. Both actions accept `keyword`, but their objects and response fields remain distinct.

Start for free View the public catalog

Endpoint: POST /api/v1/social
Capabilities: 7
Per 1,000: $1.389

Available capabilities

Compare the Yahoo Finance actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.

Action	Required	Optional	Delivery	Limit	Per 1,000	Response fields
`search` Search Search public results on Yahoo Finance. Accepts these parameters: `since`, `keyword`, `until`, and `tickers`. Returns these fields: `currency`, `name`, `symbol`, and `price`.	keyword	since, tickers, until	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
`history` Historical prices Use the `history` action on Yahoo Finance. Accepts these parameters: `keyword`, `period`, and `interval`. Returns these fields: `open`, `high`, `date`, 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
`financials` Financial statements Use the `financials` action on Yahoo Finance. Accepts these parameters: `keyword`, `since`, and `until`. Returns these fields: `income`, `cash_flow`, `balance_sheet`, and `symbol`.	keyword	since, until	Sync delivery	—	$1.39 per 1,000 requests	symbol · income · balance_sheet · cash_flow · quarterly_income · platform
`news` News Use the `news` action on Yahoo Finance. Accepts these parameters: `until`, `keyword`, and `since`. Returns these fields: `symbol`, `text`, `title`, and `publisher`.	keyword	since, until	Sync delivery	—	$1.39 per 1,000 requests	id · url · title · text · publisher · posted_at · symbol · platform
`analyst` Analyst ratings Use the `analyst` action on Yahoo Finance. Accepts these parameters: `until`, `since`, and `keyword`. Returns these fields: `upgrades_downgrades`, `from_grade`, `symbol`, and `posted_at`.	keyword	since, until	Sync delivery	—	$1.39 per 1,000 requests	symbol · recommendation_trend · upgrades_downgrades · platform · firm · action · from_grade · to_grade · price_target · prior_price_target · posted_at
`options` Options chains Use the `options` action on Yahoo Finance. Accepts these parameters: `keyword`, `since`, and `until`. Returns these fields: `bid`, `expiration_dates`, `puts`, and `volume`.	keyword	since, until	Sync delivery	—	$1.39 per 1,000 requests	calls · puts · symbol · expiration_dates · strikes · platform · contract_symbol · strike · last_price · bid · ask · volume · open_interest · implied_volatility · in_the_money · expiration
`trending` Trending Retrieve current trends from Yahoo Finance. Accepts these parameters: `since`, `screener`, and `until`. Returns these fields: `symbol`, `price`, `market_cap`, and `fifty_two_week_range`.		screener, since, until	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 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.

What do the Yahoo Finance `search` parameters mean?

Search public results on Yahoo Finance. Accepts these parameters: since, keyword, until, and tickers. Returns these fields: currency, name, symbol, and price.

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 UseOfficial 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 2026-09-05
sinceOptional: Maps to start_date or chartStartDate across shared date routes for Yahoo Finance actions. Because chart functionality is currently disabled for financials, news, analyst, and options actions, historical date filtering cannot be guaranteed for these endpoints. The history action uses period and interval instead of this date parameter.
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.
untilOptional: Sets the end date for Yahoo Finance query windows, subject to the same action-level limitations as since. This parameter does not serve as an options expiration date or earnings report period selector.

What do the Yahoo Finance `history` parameters mean?

Use the history action on Yahoo Finance. Accepts these parameters: keyword, period, and interval. Returns these fields: open, high, date, and stock_splits.

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 SelectionThe 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 2026-09-05
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 CloseOfficial 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 2026-09-05

What do the Yahoo Finance `financials` parameters mean?

Use the financials action on Yahoo Finance. Accepts these parameters: keyword, since, and until. Returns these fields: income, cash_flow, balance_sheet, and symbol.

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.
sinceOptional: Maps to start_date or chartStartDate across shared date routes for Yahoo Finance actions. Because chart functionality is currently disabled for financials, news, analyst, and options actions, historical date filtering cannot be guaranteed for these endpoints. The history action uses period and interval instead of this date parameter.
untilOptional: Sets the end date for Yahoo Finance query windows, subject to the same action-level limitations as since. This parameter does not serve as an options expiration date or earnings report period selector.

What do the Yahoo Finance `news` parameters mean?

Use the news action on Yahoo Finance. Accepts these parameters: until, keyword, and since. Returns these fields: symbol, text, title, and publisher.

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.
sinceOptional: Maps to start_date or chartStartDate across shared date routes for Yahoo Finance actions. Because chart functionality is currently disabled for financials, news, analyst, and options actions, historical date filtering cannot be guaranteed for these endpoints. The history action uses period and interval instead of this date parameter.
untilOptional: Sets the end date for Yahoo Finance query windows, subject to the same action-level limitations as since. This parameter does not serve as an options expiration date or earnings report period selector.

What do the Yahoo Finance `analyst` parameters mean?

Use the analyst action on Yahoo Finance. Accepts these parameters: until, since, and keyword. Returns these fields: upgrades_downgrades, from_grade, symbol, and posted_at.

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.
sinceOptional: Maps to start_date or chartStartDate across shared date routes for Yahoo Finance actions. Because chart functionality is currently disabled for financials, news, analyst, and options actions, historical date filtering cannot be guaranteed for these endpoints. The history action uses period and interval instead of this date parameter.
untilOptional: Sets the end date for Yahoo Finance query windows, subject to the same action-level limitations as since. This parameter does not serve as an options expiration date or earnings report period selector.

What do the Yahoo Finance `options` parameters mean?

Use the options action on Yahoo Finance. Accepts these parameters: keyword, since, and until. Returns these fields: bid, expiration_dates, puts, and volume.

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 UseOfficial 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 2026-09-05
sinceOptional: Maps to start_date or chartStartDate across shared date routes for Yahoo Finance actions. Because chart functionality is currently disabled for financials, news, analyst, and options actions, historical date filtering cannot be guaranteed for these endpoints. The history action uses period and interval instead of this date parameter.
untilOptional: Sets the end date for Yahoo Finance query windows, subject to the same action-level limitations as since. This parameter does not serve as an options expiration date or earnings report period selector.

What do the Yahoo Finance `trending` parameters mean?

Retrieve current trends from Yahoo Finance. Accepts these parameters: since, screener, and until. Returns these fields: symbol, price, market_cap, and fifty_two_week_range.

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 ListsOfficial 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 2026-09-05
sinceOptional: Maps to start_date or chartStartDate across shared date routes for Yahoo Finance actions. Because chart functionality is currently disabled for financials, news, analyst, and options actions, historical date filtering cannot be guaranteed for these endpoints. The history action uses period and interval instead of this date parameter.
untilOptional: Sets the end date for Yahoo Finance query windows, subject to the same action-level limitations as since. This parameter does not serve as an options expiration date or earnings report period selector.

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 selected action is asynchronous.
04Store the structured response fields needed by your application.

yahoo_finance_search.sh

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 source record, and every other action has its own field list.

Does every Yahoo Finance action return immediately?

No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.