Yahoo Finance Scraper

Collect Yahoo Finance market and company data for stocks, ETFs, indices, cryptocurrencies, currencies, futures, and mutual funds. Provide symbols or discover them by search, trending results, or a predefined screener.

Choose a symbol source

What you have	Input	Result order
Exact Yahoo Finance symbols	symbols	Supplied order, including repetitions
A company, fund, or instrument name	searchQuery	Yahoo Finance search order
A market region	trending and trendingRegion	Yahoo Finance trending order
A predefined market list	screener	Yahoo Finance screener order

Use one source per run. If you supply more than one, the Actor uses the first populated source in this table.

Choose the record contents

Most data sections are on by default. Ownership and options are off by default.

Data you need	Input
Current quote fields	includeQuote
Company or fund profile	includeProfile
Financial time series	includeFinancials
Chart series and events	includeChart
News and related symbols	includeNews, includeRecommendations
Research and technical events	includeInsights
Analyst, rating, and calendar modules	includeAnalyst
Ownership modules	includeOwnership
Option chains	includeOptions

Build a market record

In Apify Console, select Input, paste an example, and select Run. Open the default Dataset when the run finishes. Each resolved symbol has one combined record.

Look up one symbol with the default sections:

{
  "symbols": ["AAPL"]
}

Look up several instrument types and return quotes only:

{
  "symbols": ["SPY", "^GSPC", "BTC-USD", "EURUSD=X", "GC=F", "VFIAX"],
  "includeProfile": false,
  "includeFinancials": false,
  "includeChart": false,
  "includeNews": false,
  "includeRecommendations": false,
  "includeInsights": false,
  "includeAnalyst": false
}

Discover up to two symbols by search:

{
  "searchQuery": "Apple",
  "maxSearchResults": 2
}

Fetch a custom chart window without populating the quote field:

{
  "symbols": ["AAPL"],
  "includeQuote": false,
  "includeProfile": false,
  "includeFinancials": false,
  "includeChart": true,
  "includeNews": false,
  "includeRecommendations": false,
  "includeInsights": false,
  "includeAnalyst": false,
  "chartStartDate": "2026-07-01",
  "chartEndDate": "2026-07-15",
  "chartInterval": "1d"
}

Fetch options for a specific expiration:

{
  "symbols": ["AAPL"],
  "includeOptions": true,
  "optionDates": ["2026-12-18"]
}

Input

The symbol-source precedence is symbols, searchQuery, trending, and screener. maxSearchResults limits discovery results, but it does not limit a direct symbols array.

Field	Type	Default	Behaviour
symbols	string[]		Yahoo Finance symbols. Direct values retain their supplied order and repetitions.
searchQuery	string		Text for symbol discovery. The Actor keeps Yahoo Finance order and removes repeated discovered symbols.
trending	boolean	false	Set to true to use trending-symbol discovery.
trendingRegion	string	US	Region for trending discovery. This field does not replace region.
screener	enum		A supported predefined screener.
maxSearchResults	integer	10	Maximum number of symbols kept from search, trending, or screener discovery. Range: 1 to 50.
includeQuote	boolean	true	Include the quote object when data is available.
includeProfile	boolean	true	Include the company or fund profile when data is available.
includeFinancials	boolean	true	Include annual and quarterly financial time-series rows when data is available.
includeChart	boolean	true	Include chart metadata, OHLCV rows, adjusted close values, and available events.
includeNews	boolean	true	Include symbol-related news items.
maxNewsResults	integer	10	Maximum number of news items per symbol. Range: 1 to 200.
includeRecommendations	boolean	true	Include related symbols and their scores.
includeInsights	boolean	true	Include research, price insight, and technical-event sections.
includeAnalyst	boolean	true	Include analyst, consensus, rating, calendar, and scheduled-event sections.
includeOwnership	boolean	false	Include holder, institution, fund, and transaction modules when data is available.
includeOptions	boolean	false	Include the options chain.
optionAllExpirations	boolean	false	Fetch all available expirations. If this is true, this branch takes precedence over optionDates.
optionDates	string[]		Requested expiration date strings. If this array is absent or empty, the Actor requests the nearest available expiration.
chartRange	enum	1mo	1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, or max.
chartStartDate	string		Start value for a custom chart window. The custom-window branch needs both date fields. One date by itself is accepted and chartRange is used.
chartEndDate	string		End value for a custom chart window. The Actor uses both date strings when both fields are present.
chartInterval	enum	1d	1m, 5m, 15m, 30m, 1h, 1d, 1wk, or 1mo.
lang	string	en-US	Language locale for returned data.
region	string	US	Market-data region.
proxyConfiguration	object	Apify Proxy	Connection settings for the run.

When both custom chart dates are present, they replace chartRange. The input contract accepts date strings without a syntax or order check. Yahoo Finance can reject a date or interval combination that it does not support.

Complete input examples

Output

The default dataset contains one symbol record for each resolved symbol. Direct symbols keep their supplied order and repetitions. Discovery results keep Yahoo Finance order, remove repeated symbols, and stop at maxSearchResults.

Each record uses the same top-level shape. A data section is null when you disable it, it does not apply to the instrument, or Yahoo Finance returns no data for it.

Field	Type	Meaning
recordType	string	Always symbol.
status	string	complete, partial, or not_found.
failedSections	string[]	Section names for requests that failed.
symbol	string	The direct or discovered Yahoo Finance symbol.
quote	object or null	Quote fields. Controlled by includeQuote.
profile	object or null	Company or fund profile. Controlled by includeProfile.
financials	object or null	Financial time-series rows. Controlled by includeFinancials.
chart	object or null	Chart metadata, series, and events. Controlled by includeChart.
news	object[] or null	News items. Controlled by includeNews.
recommendations	object[] or null	Related symbols and scores. Controlled by includeRecommendations.
insights	object or object[] or null	Research and event data. Controlled by includeInsights.
priceInsights	object or null	Symbol price-insight data. Controlled by includeInsights.
options	object or null	Option expiration and contract data. Controlled by includeOptions.
ownership	object or null	Ownership modules. Controlled by includeOwnership.
analyst	object or null	Analyst and earnings modules. Controlled by includeAnalyst.
analystConsensus	object or null	Generated analyst modules. Controlled by includeAnalyst.
ratings	object or null	Four rating slots. Controlled by includeAnalyst.
technicalEvents	object or null	Technical summary and event rows. Controlled by includeInsights.
keyStatistics	object or null	Quote-summary statistics. Available when profile, analyst, or ownership data is requested.
calendarEvents	object or null	Earnings and dividend calendar values. Available with keyStatistics.
scheduledEvents	object or null	Earnings and economic event days. Controlled by includeAnalyst.
marketSummary	object[] or null	Run-level market rows copied to each symbol record.
sectors	object or null	Run-level sector summary copied to each symbol record.

Use status to decide how to process a record:

• complete: no requested section failed. A section can still be null.
• partial: usable data was saved, and failedSections lists sections that could not be collected.
• not_found: quote or chart identity data was requested, but neither was available.

A discovery request that completes with no matches saves an empty Dataset. If the discovery request or a Dataset write cannot complete, the run stops. If one data section fails, the Actor saves a partial record for that symbol and continues with other symbols.

Selected recorded fields at a glance

The values below are unchanged fields from a recorded AAPL run on 29 July 2026. Other sections and array items are not shown, so this is not a saved Dataset item.

{
  "recordType": "symbol",
  "status": "complete",
  "failedSections": [],
  "symbol": "AAPL",
  "quote": {
    "symbol": "AAPL",
    "shortName": "Apple Inc.",
    "quoteType": "EQUITY",
    "currency": "USD",
    "regularMarketPrice": 338.19,
    "regularMarketPreviousClose": 340.08,
    "regularMarketVolume": 48852885,
    "marketState": "POST"
  },
  "chart": {
    "meta": {
      "symbol": "AAPL",
      "currency": "USD",
      "instrumentType": "EQUITY",
      "regularMarketPrice": 338.19,
      "dataGranularity": "1d",
      "range": "5d"
    },
    "series": [
      {
        "timestamp": 1784813400,
        "date": "2026-07-23T13:30:00.000Z",
        "open": 321.7300109863281,
        "high": 323.29998779296875,
        "low": 319.3500061035156,
        "close": 321.6600036621094,
        "volume": 40840800,
        "adjclose": 321.6600036621094
      }
    ]
  }
}

Field reference

Yahoo Finance can add keys to some objects. The Actor keeps those keys. The tables below list the declared fields and their JSON types. A ? after a field name means that the field can be absent. or null means that the field can be present with a null value. An open object can contain other source-defined keys with any JSON value. The top-level section types and nullability are in the table above.

Missing and optional values

Some fields can be absent, empty, or null. The Actor keeps the form returned by Yahoo Finance.

Group	Behaviour
Failure list	failedSections[] is empty when no section request fails.
Pre-market quote values	quote.preMarketPrice, quote.preMarketChange, and the same two fields under options.quote are optional.
Chart event children	splits[] (date, numerator, denominator, splitRatio), capitalGains[] (amount, date), and earnings[] (date, amount) can be empty.
Optional news children	publisher, type, thumbnail.resolutions[] (url, width, height, tag), and relatedTickers[] can be absent.
Insight object form	insights can be one object or an array. Both forms use the stable symbol, events[], reports[], and sigDevs[] fields.
Price insight symbol	priceInsights can use the symbol as a dynamic key instead of a symbol child.
Direct-holder name	The name value in majorDirectHolders.holders[] is optional.
Technical event prices	priceHigh, priceLow, and priceOpen, with raw and fmt children, are optional.
Sector and industry trend estimates	The period and growth children can be absent from these estimate arrays.
Optional formatted long values	Market-summary and sector-list value objects can omit longFmt.

Selected all-section fields

Selected mutual-fund fields

Symbol not found

Yahoo Finance can add or remove keys in the open objects listed above. A documented optional field can be absent, and an enabled section can be null when it does not apply or has no returned data. The selected examples shorten arrays and replace some values with documentation markers.

Data and request constraints

• Availability differs by instrument, market, locale, and date. A supported field can be absent.
• Quote timing and exchange delay are source values and can differ by instrument.
• Historical option expirations are not available. A request for all available expirations can produce a large record.
• Fine chart intervals support shorter date windows than daily, weekly, or monthly intervals.
• Research and analyst sections can contain generated text and open nested objects.