# Yahoo Finance Scraper - Most Comprehensive (`kaix/yahoo-finance-scraper`) Actor 🔥 ~$0.5/1K stocks 🔥 Scrape Yahoo Finance for stock quotes, financials, charts, news, options, and more - **URL**: https://apify.com/kaix/yahoo-finance-scraper.md - **Developed by:** [Kai](https://apify.com/kaix) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.40 / 1,000 stocks This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 ```json { "symbols": ["GOOGL"] } ```` #### Look up multiple stocks ```json { "symbols": ["GOOGL", "AAPL", "TSLA", "AMZN"] } ``` #### International stocks ```json { "symbols": ["7203.T", "005930.KS", "RELIANCE.NS", "VOW3.DE", "0700.HK"] } ``` #### ETFs and indices ```json { "symbols": ["SPY", "QQQ", "^DJI", "^GSPC", "^IXIC"] } ``` #### Crypto ```json { "symbols": ["BTC-USD", "ETH-USD", "SOL-USD"] } ``` #### Currencies ```json { "symbols": ["EURUSD=X", "GBPUSD=X", "USDJPY=X"] } ``` #### Futures / Commodities ```json { "symbols": ["GC=F", "CL=F", "SI=F"] } ``` #### Mutual funds ```json { "symbols": ["VFIAX", "FXAIX"] } ``` #### Search by keyword ```json { "searchQuery": "tech stocks", "maxSearchResults": 10 } ``` #### Trending symbols ```json { "trending": true, "trendingRegion": "US" } ``` #### Screener (day gainers) ```json { "screener": "DAY_GAINERS", "maxSearchResults": 20 } ``` #### Options — all expirations ```json { "symbols": ["AAPL"], "includeOptions": true, "optionAllExpirations": true } ``` #### Options — specific dates ```json { "symbols": ["AAPL"], "includeOptions": true, "optionDates": ["2026-06-18", "2026-09-18"] } ``` #### Minimal output (quote only) ```json { "symbols": ["GOOGL"], "includeProfile": false, "includeFinancials": false, "includeChart": false, "includeNews": false, "includeRecommendations": false, "includeInsights": false, "includeAnalyst": false } ``` #### Full output with options and ownership ```json { "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) ```json { "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) ```json { "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) ```json { "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 } ] } ] } } ``` # Actor input Schema ## `symbols` (type: `array`): Yahoo Finance symbols. Formats: stocks (GOOGL, AAPL), international (7203.T, 005930.KS), ETFs (SPY, QQQ), indices (^DJI, ^GSPC), crypto (BTC-USD, ETH-USD), currencies (EURUSD=X), futures (GC=F, CL=F), mutual funds (VFIAX). ## `searchQuery` (type: `string`): Search keyword to discover symbols (e.g. 'tech stocks', 'energy ETF'). ## `trending` (type: `boolean`): Fetch currently trending symbols from Yahoo Finance. ## `trendingRegion` (type: `string`): Region for trending symbols (US, GB, DE, FR, JP, etc.). ## `screener` (type: `string`): Predefined screener to discover symbols. ## `maxSearchResults` (type: `integer`): Maximum number of symbols to return from search, trending, or screener. ## `includeQuote` (type: `boolean`): Real-time quote: price, volume, 52-week range, market cap, P/E, dividends, pre/post market. ## `includeProfile` (type: `boolean`): Company profile, sector, industry, officers, ESG scores. For ETFs/funds: top holdings, fund family, expense ratio, performance. ## `includeFinancials` (type: `boolean`): 363-field income statement, balance sheet, and cash flow (annual + quarterly + trailing). ## `includeChart` (type: `boolean`): OHLCV price chart with pre/post market data and dividend/split/earnings events. ## `includeNews` (type: `boolean`): News articles with headlines, descriptions, and links (up to 200 per symbol). ## `includeRecommendations` (type: `boolean`): Similar/recommended symbols with relevance scores. ## `includeInsights` (type: `boolean`): Research reports, AI-powered news/price analysis, technical events with support/resistance levels. ## `includeAnalyst` (type: `boolean`): Recommendation trends, upgrade/downgrade history, earnings (GAAP + non-GAAP), SEC filings, earnings transcripts, top analyst ratings, scheduled events. ## `includeOwnership` (type: `boolean`): Insider holdings, institutional ownership, fund ownership, insider transactions, net share purchase activity. ## `includeOptions` (type: `boolean`): Full options chain with calls, puts, strikes, and greeks. ## `optionAllExpirations` (type: `boolean`): Fetch options for all available expiration dates (can be 20-30 expirations, thousands of contracts). ## `optionDates` (type: `array`): Fetch options for specific dates only (YYYY-MM-DD format, e.g. '2026-06-18'). If empty, returns nearest expiration. ## `chartRange` (type: `string`): Time range for chart data. ## `chartStartDate` (type: `string`): Start date for chart data (YYYY-MM-DD). Overrides chart range when both start and end dates are set. ## `chartEndDate` (type: `string`): End date for chart data (YYYY-MM-DD). Overrides chart range when both start and end dates are set. ## `chartInterval` (type: `string`): Data interval for chart. Use 1m-1h for intraday (1d-5d range only), 1d+ for longer ranges. ## `maxNewsResults` (type: `integer`): Maximum number of news articles per symbol (1-200). ## `lang` (type: `string`): Language for API responses (e.g. en-US, ja-JP, de-DE, fr-FR, zh-Hant-HK). ## `region` (type: `string`): Region for market data (e.g. US, GB, DE, JP, HK, AU, CA, FR). ## `proxyConfiguration` (type: `object`): Residential proxies recommended — Yahoo blocks non-browser TLS fingerprints. ## Actor input object example ```json { "symbols": [ "GOOGL", "AAPL" ], "trending": false, "trendingRegion": "US", "maxSearchResults": 10, "includeQuote": true, "includeProfile": true, "includeFinancials": true, "includeChart": true, "includeNews": true, "includeRecommendations": true, "includeInsights": true, "includeAnalyst": true, "includeOwnership": false, "includeOptions": false, "optionAllExpirations": false, "chartRange": "1mo", "chartInterval": "1d", "maxNewsResults": 10, "lang": "en-US", "region": "US" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "symbols": [ "GOOGL", "AAPL" ] }; // Run the Actor and wait for it to finish const run = await client.actor("kaix/yahoo-finance-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "symbols": [ "GOOGL", "AAPL", ] } # Run the Actor and wait for it to finish run = client.actor("kaix/yahoo-finance-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "symbols": [ "GOOGL", "AAPL" ] }' | apify call kaix/yahoo-finance-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kaix/yahoo-finance-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Yahoo Finance Scraper - Most Comprehensive", "description": "🔥 ~$0.5/1K stocks 🔥 Scrape Yahoo Finance for stock quotes, financials, charts, news, options, and more", "version": "0.1", "x-build-id": "V1lIcFzvEM05XQsBj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kaix~yahoo-finance-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kaix-yahoo-finance-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/kaix~yahoo-finance-scraper/runs": { "post": { "operationId": "runs-sync-kaix-yahoo-finance-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/kaix~yahoo-finance-scraper/run-sync": { "post": { "operationId": "run-sync-kaix-yahoo-finance-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "symbols": { "title": "Symbols", "type": "array", "description": "Yahoo Finance symbols. Formats: stocks (GOOGL, AAPL), international (7203.T, 005930.KS), ETFs (SPY, QQQ), indices (^DJI, ^GSPC), crypto (BTC-USD, ETH-USD), currencies (EURUSD=X), futures (GC=F, CL=F), mutual funds (VFIAX).", "items": { "type": "string" } }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Search keyword to discover symbols (e.g. 'tech stocks', 'energy ETF')." }, "trending": { "title": "Fetch Trending", "type": "boolean", "description": "Fetch currently trending symbols from Yahoo Finance.", "default": false }, "trendingRegion": { "title": "Trending Region", "type": "string", "description": "Region for trending symbols (US, GB, DE, FR, JP, etc.).", "default": "US" }, "screener": { "title": "Screener", "enum": [ "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" ], "type": "string", "description": "Predefined screener to discover symbols." }, "maxSearchResults": { "title": "Max Discovery Results", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of symbols to return from search, trending, or screener.", "default": 10 }, "includeQuote": { "title": "Quote", "type": "boolean", "description": "Real-time quote: price, volume, 52-week range, market cap, P/E, dividends, pre/post market.", "default": true }, "includeProfile": { "title": "Company / Fund Profile", "type": "boolean", "description": "Company profile, sector, industry, officers, ESG scores. For ETFs/funds: top holdings, fund family, expense ratio, performance.", "default": true }, "includeFinancials": { "title": "Financial Statements", "type": "boolean", "description": "363-field income statement, balance sheet, and cash flow (annual + quarterly + trailing).", "default": true }, "includeChart": { "title": "Price Chart", "type": "boolean", "description": "OHLCV price chart with pre/post market data and dividend/split/earnings events.", "default": true }, "includeNews": { "title": "News", "type": "boolean", "description": "News articles with headlines, descriptions, and links (up to 200 per symbol).", "default": true }, "includeRecommendations": { "title": "Recommendations", "type": "boolean", "description": "Similar/recommended symbols with relevance scores.", "default": true }, "includeInsights": { "title": "Insights & Technical Events", "type": "boolean", "description": "Research reports, AI-powered news/price analysis, technical events with support/resistance levels.", "default": true }, "includeAnalyst": { "title": "Analyst Data", "type": "boolean", "description": "Recommendation trends, upgrade/downgrade history, earnings (GAAP + non-GAAP), SEC filings, earnings transcripts, top analyst ratings, scheduled events.", "default": true }, "includeOwnership": { "title": "Ownership", "type": "boolean", "description": "Insider holdings, institutional ownership, fund ownership, insider transactions, net share purchase activity.", "default": false }, "includeOptions": { "title": "Options Chain", "type": "boolean", "description": "Full options chain with calls, puts, strikes, and greeks.", "default": false }, "optionAllExpirations": { "title": "All Expirations", "type": "boolean", "description": "Fetch options for all available expiration dates (can be 20-30 expirations, thousands of contracts).", "default": false }, "optionDates": { "title": "Specific Expiration Dates", "type": "array", "description": "Fetch options for specific dates only (YYYY-MM-DD format, e.g. '2026-06-18'). If empty, returns nearest expiration.", "items": { "type": "string" } }, "chartRange": { "title": "Chart Range", "enum": [ "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max" ], "type": "string", "description": "Time range for chart data.", "default": "1mo" }, "chartStartDate": { "title": "Chart Start Date", "type": "string", "description": "Start date for chart data (YYYY-MM-DD). Overrides chart range when both start and end dates are set." }, "chartEndDate": { "title": "Chart End Date", "type": "string", "description": "End date for chart data (YYYY-MM-DD). Overrides chart range when both start and end dates are set." }, "chartInterval": { "title": "Chart Interval", "enum": [ "1m", "5m", "15m", "30m", "1h", "1d", "1wk", "1mo" ], "type": "string", "description": "Data interval for chart. Use 1m-1h for intraday (1d-5d range only), 1d+ for longer ranges.", "default": "1d" }, "maxNewsResults": { "title": "Max News Articles", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of news articles per symbol (1-200).", "default": 10 }, "lang": { "title": "Language", "type": "string", "description": "Language for API responses (e.g. en-US, ja-JP, de-DE, fr-FR, zh-Hant-HK).", "default": "en-US" }, "region": { "title": "Region", "type": "string", "description": "Region for market data (e.g. US, GB, DE, JP, HK, AU, CA, FR).", "default": "US" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxies recommended — Yahoo blocks non-browser TLS fingerprints." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```