Yahoo Finance Scraper

Collect Yahoo Finance data for stocks, ETFs, indices, cryptocurrencies, currencies, futures, and mutual funds. Each resolved symbol produces one aggregate record in the default dataset.

You can provide symbols directly or discover them with search, trending results, or one of the supported screeners. A run accepts exactly one of those four methods.

Quick start

Look up one symbol with the default data 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

Field	Type	Default	Behavior
symbols	string[]		Yahoo Finance symbols. Empty strings are rejected and duplicates are removed while preserving order.
searchQuery	string		Search text used to discover symbols.
trending	boolean	false	Set to true to use trending-symbol discovery.
trendingRegion	string	US	Region used by trending discovery.
screener	enum		Supported predefined screener.
maxSearchResults	integer	10	Maximum symbols kept from search, trending, or screener discovery. Range: 1–50.
includeQuote	boolean	true	Quote fields such as price, volume, market state, valuation, and pre/post-market values when available.
includeProfile	boolean	true	Company or fund profile, sector, industry, ESG data, and fund holdings when available.
includeFinancials	boolean	true	Available annual and quarterly income statement, balance-sheet, and cash-flow fields.
includeChart	boolean	true	OHLCV series and available dividend, split, capital-gain, and earnings events.
includeNews	boolean	true	Symbol-related news.
maxNewsResults	integer	10	Maximum articles per symbol. Range: 1–200.
includeRecommendations	boolean	true	Related symbols and relevance scores.
includeInsights	boolean	true	Available research, price insights, and technical events.
includeAnalyst	boolean	true	Analyst trends, ratings, earnings data, filings, transcripts, and scheduled events when available.
includeOwnership	boolean	false	Insider, institution, fund, and transaction ownership data when available.
includeOptions	boolean	false	Options expiration and contract data.
optionAllExpirations	boolean	false	Fetch all available expirations. Cannot be combined with optionDates.
optionDates	string[]		Specific expiration dates in YYYY-MM-DD format. Leave unset for the nearest available expiration.
chartRange	enum	1mo	1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, or max.
chartStartDate	string		Custom chart start date in YYYY-MM-DD format. Requires chartEndDate.
chartEndDate	string		Custom chart end date in YYYY-MM-DD format. Requires chartStartDate and must be later.
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	Apify Proxy groups or country, or your own proxy URLs.

Custom chart dates override chartRange. Fine chart intervals are available only for time windows supported by Yahoo Finance.

The supported screeners are:

DAY_GAINERS, DAY_LOSERS, MOST_ACTIVES, MOST_SHORTED_STOCKS, UNDERVALUED_GROWTH_STOCKS, GROWTH_TECHNOLOGY_STOCKS, AGGRESSIVE_SMALL_CAPS, SMALL_CAP_GAINERS, ALL_CRYPTOCURRENCIES_US, DAY_GAINERS_CRYPTOCURRENCIES, DAY_LOSERS_CRYPTOCURRENCIES, MOST_ACTIVES_CRYPTOCURRENCIES, HIGHEST_VALUATION_PRIVATE_COMPANY, WEEK_GAINERS_PRIVATE_COMPANY, RECENTLY_FUNDED_PRIVATE_COMPANY, MOST_FUNDED_PRIVATE_COMPANY, TOP_MUTUAL_FUNDS, DAY_GAINERS_MUTUAL_FUNDS, PORTFOLIO_ANCHORS, SOLID_LARGE_GROWTH_FUNDS, SOLID_MIDCAP_GROWTH_FUNDS, CONSERVATIVE_FOREIGN_FUNDS, and HIGH_YIELD_BOND.

Output

The default dataset contains one symbol record for each resolved symbol. Direct symbols keep input order after deduplication. Discovery results keep Yahoo Finance order and stop at maxSearchResults.

Every record has these control fields:

Field	Meaning
recordType	Always symbol.
status	complete, partial, or not_found.
failedSections	Names of sections whose requests failed. Empty for complete and not_found.
symbol	Resolved Yahoo Finance symbol.

The remaining fields are nullable data sections:

Field	Controlled by
quote	includeQuote
profile	includeProfile
financials	includeFinancials
chart	includeChart
news	includeNews
recommendations	includeRecommendations
insights, priceInsights, technicalEvents	includeInsights
options	includeOptions
ownership	includeOwnership
analyst, analystConsensus, ratings, scheduledEvents	includeAnalyst
keyStatistics, calendarEvents	Fetched when profile, analyst, or ownership data is requested
marketSummary, sectors	Attempted once per run and repeated on each symbol record

complete means no section request failed. A field can still be null because it was disabled, does not apply to that instrument, or Yahoo Finance did not return data.

partial means the Actor saved the usable data and listed each failed request group in failedSections. It does not include raw request details.

not_found means quote or chart identity data was requested, neither was found, and those requests did not fail.

Invalid input, initialization or discovery failure, and failure to save a valid record cause the Actor run to fail. A discovery request with no matches succeeds with an empty dataset.

Selected live output

The values below are selected unchanged fields from one verified local AAPL run on 2026-07-29. Fields and array entries not shown here were omitted from the example.

{
  "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
      }
    ]
  },
  "news": [
    {
      "uuid": "d338c18c-8293-4d57-9a92-37d1b77c960a",
      "title": "Apple options trades: What's a covered call and how does it work?",
      "link": "https://finance.yahoo.com/video/apple-options-trades-whats-covered-201000242.html",
      "pubDate": "Wed, 29 Jul 2026 20:10:00 +0000",
      "providerPublishTime": 1785355800
    }
  ],
  "options": {
    "underlyingSymbol": "AAPL",
    "expirationDates": [1785283200, 1785456000, 1785715200],
    "strikes": [210, 220, 225],
    "hasMiniOptions": false,
    "options": [
      {
        "expirationDate": 1785283200,
        "hasMiniOptions": false,
        "calls": [
          {
            "contractSymbol": "AAPL260729C00210000",
            "strike": 210,
            "currency": "USD",
            "lastPrice": 134.25,
            "bid": 126.4,
            "ask": 129.65,
            "volume": 235,
            "openInterest": 7,
            "impliedVolatility": 5.433596958007811,
            "inTheMoney": true
          }
        ],
        "puts": [
          {
            "contractSymbol": "AAPL260729P00220000",
            "strike": 220,
            "currency": "USD",
            "lastPrice": 0.01,
            "bid": 0,
            "ask": 0.01,
            "volume": null,
            "openInterest": 1,
            "impliedVolatility": 2.50000375,
            "inTheMoney": false
          }
        ]
      }
    ]
  }
}

Known limits

• Availability differs by instrument, market, locale, and date. A supported field may still be absent.
• Quote timing and exchange delay come from the returned Yahoo Finance fields; the Actor does not promise real-time delivery for every instrument.
• Historical option expirations are not available, and all-expiration responses can be large.
• Fine chart intervals support shorter date windows than daily, weekly, or monthly intervals.
• This Actor returns data as provided by Yahoo Finance. Verify time-sensitive financial data before making decisions.