Yahoo Finance Scraper

Scrape comprehensive financial data from Yahoo Finance. Returns stock quotes, company profiles, 363-field financial statements, OHLCV charts with pre/post market data, up to 200 news articles, full options chains, analyst ratings, SEC filings, ownership data, technical events, AI-powered insights, and market screeners. Supports stocks, ETFs, indices, crypto, currencies, futures, and mutual funds.

Why use this scraper?

• Real-time quotes: price, volume, 52-week range, market cap, P/E, dividend yield, EPS, beta, pre/post market
• Company profiles: description, sector, industry, officers, headquarters, ESG scores
• ETF/fund profiles: top holdings, fund family, expense ratio, performance returns
• Financial statements: 363 line items across income, balance sheet, cash flow (annual + quarterly + trailing)
• OHLCV price charts with dividend/split/earnings events, pre/post market data, configurable range and interval
• Up to 200 news articles per symbol via RSS feed
• Full options chains: all expirations or specific dates, calls/puts with strikes and greeks
• Analyst data: recommendation trends, 900+ upgrade/downgrade history, earnings estimates (GAAP + non-GAAP), SEC filings, earnings call transcripts
• Top analyst ratings with direction, momentum, price target, financial score
• AI-powered insights: news summaries, price movement explanations, earnings analysis
• Technical events: support/resistance levels, short/mid/long-term trends
• Ownership: insider holdings, institutional ownership, fund ownership, insider transactions
• Market context: 15 market indices, 12 sector performance returns
• 23+ predefined screeners: gainers, losers, most active, crypto, private companies, mutual funds
• Search by keyword, fetch trending symbols, or use screeners to discover stocks

Use cases

• Build financial databases with fundamentals across global markets
• Track real-time stock prices, earnings dates, and dividend schedules
• Analyze income statements, balance sheets, and cash flow trends
• Feed OHLCV charts into technical analysis pipelines
• Monitor options chains for trading strategies
• Screen for day gainers, losers, most shorted stocks, crypto
• Track institutional and insider ownership changes
• Discover trending symbols and search for stocks by keyword

How to use

Look up a single stock

{
  "symbols": ["GOOGL"]
}

Look up multiple stocks

{
  "symbols": ["GOOGL", "AAPL", "TSLA", "AMZN"]
}

International stocks

{
  "symbols": ["7203.T", "005930.KS", "RELIANCE.NS", "VOW3.DE", "0700.HK"]
}

ETFs and indices

{
  "symbols": ["SPY", "QQQ", "^DJI", "^GSPC", "^IXIC"]
}

Crypto

{
  "symbols": ["BTC-USD", "ETH-USD", "SOL-USD"]
}

Currencies

{
  "symbols": ["EURUSD=X", "GBPUSD=X", "USDJPY=X"]
}

Futures / Commodities

{
  "symbols": ["GC=F", "CL=F", "SI=F"]
}

Mutual funds

{
  "symbols": ["VFIAX", "FXAIX"]
}

Search by keyword

{
  "searchQuery": "tech stocks",
  "maxSearchResults": 10
}

Trending symbols

{
  "trending": true,
  "trendingRegion": "US"
}

Screener (day gainers)

{
  "screener": "DAY_GAINERS",
  "maxSearchResults": 20
}

Options — all expirations

{
  "symbols": ["AAPL"],
  "includeOptions": true,
  "optionAllExpirations": true
}

Options — specific dates

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

Minimal output (quote only)

{
  "symbols": ["GOOGL"],
  "includeProfile": false,
  "includeFinancials": false,
  "includeChart": false,
  "includeNews": false,
  "includeRecommendations": false,
  "includeInsights": false,
  "includeAnalyst": false
}

Full output with options and ownership

{
  "symbols": ["GOOGL"],
  "includeQuote": true,
  "includeProfile": true,
  "includeFinancials": true,
  "includeChart": true,
  "includeNews": true,
  "maxNewsResults": 200,
  "includeRecommendations": true,
  "includeInsights": true,
  "includeAnalyst": true,
  "includeOptions": true,
  "optionAllExpirations": true,
  "includeOwnership": true,
  "chartRange": "5y",
  "chartInterval": "1d"
}

Input

Field	Type	Default	Description
symbols	string[]		Yahoo Finance symbols (GOOGL, 7203.T, ^DJI, BTC-USD, EURUSD=X, GC=F, VFIAX)
searchQuery	string		Search keyword to discover symbols (e.g. "tech stocks", "energy ETF")
trending	boolean	false	Fetch currently trending symbols
trendingRegion	string	US	Region for trending symbols (US, GB, DE, FR, JP, etc.)
screener	string		Predefined screener (see screener list below)
maxSearchResults	number	10	Max symbols from search/trending/screener (1-50)
includeQuote	boolean	true	Real-time quote (price, volume, 52-week range, market cap, P/E, etc.)
includeProfile	boolean	true	Company/fund profile, ESG scores, top holdings (ETFs)
includeFinancials	boolean	true	363-field income statement, balance sheet, cash flow
includeChart	boolean	true	OHLCV price chart with pre/post market and dividend/split/earnings events
includeNews	boolean	true	News articles with headlines, sources, descriptions
maxNewsResults	number	10	Max news articles per symbol (1-200)
includeRecommendations	boolean	true	Similar/recommended symbols with relevance scores
includeInsights	boolean	true	Research reports, AI insights, technical events, price movement analysis
includeAnalyst	boolean	true	Recommendation trends, upgrades/downgrades, earnings, SEC filings, transcripts, ratings
includeOptions	boolean	false	Full options chain with calls, puts, strikes, and greeks
optionAllExpirations	boolean	false	Fetch all expiration dates (can be 20+ expirations)
optionDates	string[]		Specific expiration dates (YYYY-MM-DD format)
includeOwnership	boolean	false	Insider holdings, institutional ownership, fund ownership, insider transactions
chartRange	enum	1mo	1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
chartInterval	enum	1d	1m, 5m, 15m, 30m, 1h, 1d, 1wk, 1mo
proxyConfiguration	object	Apify proxy	Proxy config. Residential proxies recommended.

Screeners

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, HIGH_YIELD_BOND

Output

One record per symbol in the default dataset. Each record contains these fields:

Field	Source	Description
quote	includeQuote	Real-time price, volume, market cap, P/E, dividends, pre/post market
profile	includeProfile	Company info, officers, ESG; ETFs: top holdings, fund profile, performance
financials	includeFinancials	363 line items: income, balance sheet, cash flow (annual + quarterly + trailing)
chart	includeChart	OHLCV series with dividend/split/earnings events and pre/post market data
news	includeNews	Up to 200 articles with title, description, link, publish time
recommendations	includeRecommendations	Similar symbols with relevance scores
insights	includeInsights	Research reports, significant developments
priceInsights	includeInsights	AI-powered news summaries and price movement analysis
technicalEvents	includeInsights	Support/resistance, trend direction, technical patterns
options	includeOptions	Full chain: expirations, strikes, calls/puts with greeks
ownership	includeOwnership	Insider/institutional/fund holders, transactions, net share purchase
analyst	includeAnalyst	Recommendation trends, upgrade/downgrade history, earnings (GAAP/non-GAAP), SEC filings, transcripts
analystConsensus	includeAnalyst	AI consensus: options analysis, financial insights, earnings transcript analysis
ratings	includeAnalyst	Top analyst ratings: direction, momentum, price target, financial score
keyStatistics	always	Key stats, financial data, summary detail, equity performance, sector/industry trends
calendarEvents	always	Earnings dates, ex-dividend date, dividend date
scheduledEvents	includeAnalyst	Upcoming earnings and economic events calendar
marketSummary	always	15 market indices (S&P 500, Dow, Nasdaq, etc.)
sectors	always	12 sectors with market weight and YTD returns

Stock output (NVDA — live data)

{
  "symbol": "NVDA",
  "quote": {
    "symbol": "NVDA",
    "shortName": "NVIDIA Corporation",
    "quoteType": "EQUITY",
    "currency": "USD",
    "exchange": "NMS",
    "fullExchangeName": "NasdaqGS",
    "market": "us_market",
    "marketState": "CLOSED",
    "regularMarketPrice": 201.68,
    "regularMarketChange": 3.33,
    "regularMarketChangePercent": 1.679,
    "regularMarketOpen": 199.88,
    "regularMarketDayHigh": 201.7,
    "regularMarketDayLow": 199.27,
    "regularMarketVolume": 153662565,
    "regularMarketPreviousClose": 198.35,
    "fiftyTwoWeekHigh": 212.19,
    "fiftyTwoWeekLow": 95.04,
    "marketCap": 4901832228864,
    "trailingPE": 41.16,
    "forwardPE": 17.94,
    "epsTrailingTwelveMonths": 4.9,
    "epsForward": 11.24,
    "dividendYield": 0.02,
    "sharesOutstanding": 24300000000,
    "averageAnalystRating": "1.3 - Strong Buy",
    "postMarketPrice": 200.96
  },
  "profile": {
    "address1": "2788 San Tomas Expressway",
    "city": "Santa Clara",
    "state": "CA",
    "country": "United States",
    "website": "https://www.nvidia.com",
    "sector": "Technology",
    "industry": "Semiconductors",
    "fullTimeEmployees": 42000,
    "longBusinessSummary": "NVIDIA Corporation operates as a data center scale AI infrastructure company...",
    "companyOfficers": [
      { "name": "Mr. Jen-Hsun  Huang", "age": 62, "title": "Co-Founder, CEO & Director", "totalPay": 11054945 }
    ]
  },
  "financials": {
    "income": [
      {
        "asOfDate": "2026-01-31",
        "periodType": "12M",
        "currencyCode": "USD",
        "totalRevenue": 215938000000,
        "netIncome": 116997000000,
        "dilutedEPS": 4.81
      }
    ],
    "balanceSheet": [
      {
        "asOfDate": "2026-01-31",
        "periodType": "12M",
        "currencyCode": "USD",
        "totalAssets": 133203000000,
        "stockholdersEquity": 82710000000,
        "totalDebt": 19624000000
      }
    ],
    "cashFlow": [
      {
        "asOfDate": "2026-01-31",
        "periodType": "12M",
        "currencyCode": "USD",
        "operatingCashFlow": 105896000000,
        "capitalExpenditure": -4268000000,
        "freeCashFlow": 101628000000
      }
    ]
  },
  "chart": {
    "meta": {
      "currency": "USD",
      "symbol": "NVDA",
      "exchangeName": "NMS",
      "instrumentType": "EQUITY",
      "regularMarketPrice": 201.68,
      "chartPreviousClose": 181.93,
      "dataGranularity": "1d",
      "range": "1mo"
    },
    "series": [
      {
        "timestamp": 1773840600,
        "date": "2026-03-18T13:30:00.000Z",
        "open": 182.48,
        "high": 183.38,
        "low": 180.33,
        "close": 180.4,
        "volume": 156683100,
        "adjclose": 180.4
      }
    ]
  },
  "news": [
    {
      "uuid": "1aa6b0e2-0d37-3bd8-bfce-88b259954f55",
      "title": "3 Reasons You May Be Paying More for Medicare This Year",
      "description": "If it's any consolation, it's not just you.",
      "link": "https://www.fool.com/retirement/2026/04/18/...",
      "providerPublishTime": 1776520560
    }
  ],
  "recommendations": [
    { "symbol": "TSLA", "score": 0.145695 },
    { "symbol": "AMZN", "score": 0.142055 },
    { "symbol": "AMD", "score": 0.13993 }
  ],
  "insights": {},
  "priceInsights": { "NVDA": { "hasPriceAnomaly": false } },
  "technicalEvents": {
    "total": 17,
    "technicalEvents": {
      "shortTerm": "up",
      "midTerm": "up",
      "longTerm": "up",
      "support": 182.7,
      "resistance": 203.15,
      "stopLoss": 184.98
    },
    "events": [{ "eventType": "Relative Strength Index (RSI)", "pricePeriod": "D", "tradingHorizon": "S", "tradeType": "S" }]
  },
  "analyst": {
    "recommendationTrend": { "trend": [{ "period": "0m", "strongBuy": 9, "buy": 47, "hold": 2, "sell": 1, "strongSell": 0 }] },
    "upgradeDowngradeHistory": {
      "history": [
        {
          "epochGradeDate": 1774936557,
          "firm": "Benchmark",
          "toGrade": "Buy",
          "fromGrade": "Buy",
          "action": "reit",
          "currentPriceTarget": 250
        }
      ]
    },
    "earnings": {
      "earningsChart": {
        "quarterly": [{ "date": "1Q2025", "actual": 0.81, "estimate": 0.75, "surprisePct": "8.02" }],
        "currentQuarterEstimate": 1.78,
        "currentCalendarQuarter": "1Q2026"
      },
      "financialsChart": {
        "yearly": [
          { "date": 2025, "revenue": 130497000000, "earnings": 74265000000 },
          { "date": 2026, "revenue": 215938000000, "earnings": 116997000000 }
        ]
      }
    },
    "secFilings": {
      "filings": [
        {
          "date": "2026-03-06",
          "type": "8-K",
          "title": "Corporate Changes & Voting Matters",
          "edgarUrl": "https://finance.yahoo.com/sec-filing/NVDA/0001045810-26-000024_1045810"
        }
      ]
    },
    "earningsCallTranscripts": {
      "transcripts": [{ "title": "NVDA Q4 FY2026 earnings call transcript", "fiscalYear": 2026, "fiscalPeriod": "Q4" }]
    }
  },
  "analystConsensus": {
    "overview": {
      "ticker": "NVDA",
      "overview": {
        "tldr": "Nvidia is solidifying its leadership in the AI chip market with the launch of its Blackwell Ultra technology..."
      }
    }
  },
  "ratings": {
    "dir": { "analyst": "Argus Research", "ticker": "NVDA", "rating_current": "Buy", "pt_current": 220, "rating_sentiment": 1 }
  },
  "options": null,
  "ownership": {
    "majorHoldersBreakdown": { "insidersPercentHeld": 0.042, "institutionsPercentHeld": 0.697, "institutionsCount": 7376 },
    "insiderTransactions": {
      "transactions": [
        {
          "filerName": "KRESS COLETTE M.",
          "filerRelation": "Chief Financial Officer",
          "transactionText": "Sale at price 171.97 - 177.51 per share.",
          "shares": 62650,
          "value": 10956706
        }
      ]
    }
  },
  "keyStatistics": {
    "defaultKeyStatistics": {
      "enterpriseValue": 4849680252928,
      "forwardPE": 17.94,
      "profitMargins": 0.556,
      "beta": 2.335,
      "pegRatio": 0.72,
      "trailingEps": 4.9,
      "forwardEps": 11.24
    },
    "financialData": {
      "currentPrice": 201.68,
      "targetMeanPrice": 268.61,
      "recommendationKey": "strong_buy",
      "numberOfAnalystOpinions": 56,
      "totalRevenue": 215938007040,
      "revenueGrowth": 0.732,
      "grossMargins": 0.711,
      "operatingMargins": 0.65,
      "returnOnEquity": 1.015
    },
    "equityPerformance": {
      "benchmark": { "symbol": "^GSPC", "shortName": "S&P 500" },
      "performanceOverview": { "oneYearTotalReturn": 0.988, "fiveYearTotalReturn": 11.706, "maxReturn": 4608.83 }
    },
    "pageViews": { "shortTermTrend": "UP", "midTermTrend": "UP", "longTermTrend": "UP" }
  },
  "calendarEvents": {
    "earnings": { "earningsDate": [1779307200], "earningsAverage": 1.78, "revenueAverage": 78799090450 },
    "exDividendDate": 1773187200
  },
  "scheduledEvents": { "earnings": [], "economicEvents": [] },
  "marketSummary": [
    {
      "symbol": "^GSPC",
      "shortName": "S&P 500",
      "regularMarketPrice": { "raw": 7126.06, "fmt": "7,126.06" },
      "regularMarketChangePercent": { "raw": 1.204, "fmt": "1.20%" }
    },
    {
      "symbol": "^DJI",
      "shortName": "Dow 30",
      "regularMarketPrice": { "raw": 49447.43, "fmt": "49,447.43" },
      "regularMarketChangePercent": { "raw": 1.788, "fmt": "1.79%" }
    }
  ],
  "sectors": {
    "sectorsCount": 11,
    "list": [
      { "name": "Technology", "ytdReturn": { "raw": 0.046, "fmt": "4.61%" }, "marketWeight": { "raw": 0.301, "fmt": "30.07%" } }
    ]
  }
}

Crypto output (BTC-USD — live data)

{
  "symbol": "BTC-USD",
  "quote": {
    "symbol": "BTC-USD",
    "shortName": "Bitcoin USD",
    "quoteType": "CRYPTOCURRENCY",
    "currency": "USD",
    "exchange": "CCC",
    "marketState": "REGULAR",
    "regularMarketPrice": 76170.01,
    "regularMarketChange": -1816.02,
    "regularMarketChangePercent": -2.33,
    "regularMarketVolume": 38338904064,
    "fiftyTwoWeekHigh": 126198.07,
    "fiftyTwoWeekLow": 60074.203,
    "marketCap": 1523439632384,
    "circulatingSupply": 20017562,
    "maxSupply": 21000000,
    "volume24Hr": 38338904064,
    "coinMarketCapLink": "https://coinmarketcap.com/currencies/bitcoin",
    "coinImageUrl": "https://s2.coinmarketcap.com/static/img/coins/64x64/1.png"
  },
  "profile": {
    "name": "Bitcoin",
    "description": "Bitcoin (BTC) is a cryptocurrency launched in 2010. Users are able to generate BTC through the process of mining...",
    "website": "https://bitcoin.org/",
    "whitepaper": "https://bitcoin.org/bitcoin.pdf",
    "startDate": "2010-07-13",
    "blockReward": 6.25,
    "netHashesPerSecond": "244051282584378770000"
  },
  "financials": null,
  "chart": {
    "meta": {
      "currency": "USD",
      "symbol": "BTC-USD",
      "exchangeName": "CCC",
      "instrumentType": "CRYPTOCURRENCY",
      "regularMarketPrice": 76170.01,
      "chartPreviousClose": 71245.58,
      "dataGranularity": "1d",
      "range": "1mo"
    },
    "series": [
      {
        "timestamp": 1773792000,
        "date": "2026-03-18T00:00:00.000Z",
        "open": 73936.85,
        "high": 74658.98,
        "low": 70503.86,
        "close": 71245.58,
        "volume": 46229011155,
        "adjclose": 71245.58
      }
    ]
  },
  "news": [
    {
      "uuid": "12762c41-cc92-3aa4-abcb-20f1a1810804",
      "title": "Why BitMine's Tom Lee Sees Ethereum at $62,500 in 2030",
      "link": "https://247wallst.com/investing/2026/04/18/...",
      "providerPublishTime": 1776514449
    }
  ],
  "recommendations": [
    { "symbol": "ETH-USD", "score": 0.280206 },
    { "symbol": "DOGE-USD", "score": 0.129765 },
    { "symbol": "NFLX", "score": 0.128351 }
  ],
  "analyst": null,
  "options": null,
  "ownership": null
}

ETF output (SPY — live data)

{
  "symbol": "SPY",
  "quote": {
    "symbol": "SPY",
    "shortName": "State Street SPDR S&P 500 ETF T",
    "quoteType": "ETF",
    "currency": "USD",
    "regularMarketPrice": 710.14,
    "regularMarketChange": 8.48,
    "regularMarketChangePercent": 1.209,
    "marketCap": 651753750528
  },
  "profile": {
    "topHoldings": {
      "holdings": [
        { "symbol": "NVDA", "holdingName": "NVIDIA Corp", "holdingPercent": 0.0756 },
        { "symbol": "AAPL", "holdingName": "Apple Inc", "holdingPercent": 0.0664 },
        { "symbol": "MSFT", "holdingName": "Microsoft Corp", "holdingPercent": 0.049 }
      ]
    },
    "fundProfile": {
      "family": "State Street Investment Management",
      "categoryName": "Large Blend",
      "legalType": "Exchange Traded Fund"
    }
  },
  "options": {
    "underlyingSymbol": "SPY",
    "expirationDates": [1776643200, 1776729600, 1776816000],
    "strikes": [500, 505, 510, 515, 520],
    "options": [
      {
        "expirationDate": 1776643200,
        "calls": [
          {
            "contractSymbol": "SPY260420C00500000",
            "strike": 500,
            "currency": "USD",
            "lastPrice": 199.54,
            "bid": 209.04,
            "ask": 211.84,
            "volume": 15,
            "openInterest": 0,
            "impliedVolatility": 1.66,
            "inTheMoney": true
          }
        ],
        "puts": [
          {
            "contractSymbol": "SPY260420P00500000",
            "strike": 500,
            "currency": "USD",
            "lastPrice": 0.01,
            "bid": 0,
            "ask": 0.01,
            "volume": 528,
            "openInterest": 1024,
            "impliedVolatility": 1.125,
            "inTheMoney": false
          }
        ]
      }
    ]
  }
}