# Yahoo Finance Scraper — Quotes, Options & Fundamentals (`brick_joey_yto/yahoo-finance-scraper`) Actor Scrape Yahoo Finance — live quotes, OHLCV charts, option chains with IV, fundamentals & analyst targets, ticker news, screeners, and price-move watch monitors. No API key. From $1/1,000 results. - **URL**: https://apify.com/brick_joey_yto/yahoo-finance-scraper.md - **Developed by:** [William Billings](https://apify.com/brick_joey_yto) (community) - **Categories:** Automation, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Yahoo Finance Scraper — Quotes, Options Chains, Fundamentals & News The complete Yahoo Finance data layer in one actor — **live quotes, OHLCV history, option chains with implied volatility, company fundamentals, analyst price targets, ticker news, and market screeners**. No API key, no Yahoo account, no scraping browser needed — the actor talks to the same JSON endpoints finance.yahoo.com uses. Stocks, crypto (`BTC-USD`), indices (`^GSPC`), ETFs, forex (`EURUSD=X`), and futures — one input shape for all of it. ### Modes | Mode | What you get | |---|---| | `quote` | Live quote per ticker — price, day change %, volume, market cap, P/E, EPS, 52-week range, market state | | `chart` | OHLCV candles — any interval (1m→1mo), any range (1d→max), adjusted close included | | `news` | Ticker-linked headlines — title, publisher, link, timestamp, related tickers | | `options` | Full option chains — calls/puts with strike, bid/ask, volume, **open interest, implied volatility**, expiry | | `financials` | Fundamentals — revenue, net income, margins, cash/debt, P/E ratios, EPS growth, **analyst target price + buy/hold/sell consensus** | | `screener` | Yahoo's predefined screens — day gainers/losers, most actives, most shorted, undervalued growth, growth tech, small-cap movers | | `watch` | **Price-move monitor** — emit only tickers that moved ≥ your threshold. Schedule hourly for a movers-only feed | ### Why this and not a paid market-data API? Official market-data APIs (Polygon, Alpha Vantage, IEX) gate real-time quotes, options chains, and fundamentals behind $30–200/mo tiers and key management. This actor pulls the same fields from Yahoo's public API for **$1 per 1,000 rows** — no key rotation, no quota tier, no contract. ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `quote` | `quote` / `chart` / `news` / `options` / `financials` / `screener` / `watch` | | `symbols` | array | `["AAPL","NVDA","BTC-USD"]` | Yahoo tickers — equities, `BTC-USD` crypto, `^GSPC` indices, `EURUSD=X` forex, `ES=F` futures | | `interval` | string | `1d` | Chart candle size: `1m`–`1mo` | | `range` | string | `1mo` | Chart lookback: `1d`–`max` | | `expiry` | int | — | Options: specific expiry (unix timestamp); empty = nearest | | `screen` | string | `day_gainers` | Screener preset — see modes table | | `newsPerSymbol` | int | `10` | Headlines per ticker (news mode) | | `minChangePct` | number | — | Watch filter — only movers ≥ this % get rows | | `maxResults` | int | `100` | Row cap (per symbol for chart/options, total for screener) | | `proxyConfiguration` | object | — | Optional Apify proxy | #### Example inputs Watch for any portfolio stock moving 3%+ (schedule every 30 min): ```json {"mode": "watch", "symbols": ["AAPL","NVDA","TSLA","AMD","SPY"], "minChangePct": 3} ``` Daily candles for backtests: ```json {"mode": "chart", "symbols": ["SPY","QQQ"], "interval": "1d", "range": "5y", "maxResults": 2000} ``` AAPL option chain for the nearest expiry: ```json {"mode": "options", "symbols": ["AAPL"], "maxResults": 500} ``` Analyst consensus across mega-caps: ```json {"mode": "financials", "symbols": ["AAPL","MSFT","GOOGL","AMZN","NVDA"]} ``` ### Example output ```json { "recordType": "quote", "symbol": "NVDA", "name": "NVIDIA Corporation", "price": 229.28, "changePct": -0.52, "volume": 187445213, "marketCap": 5536424132608, "peRatio": 45.2, "week52High": 246.5, "marketState": "CLOSED", "url": "https://finance.yahoo.com/quote/NVDA" } ``` ```json { "recordType": "option", "symbol": "AAPL", "underlyingPrice": 336.64, "contractSymbol": "AAPL261012C00300000", "side": "call", "strike": 300, "lastPrice": 36.9, "volume": 1204, "openInterest": 15832, "impliedVolatility": 1.219, "inTheMoney": true } ``` ### Use cases - **Screeners → pipeline** — pull `day_gainers` hourly, feed movers into our StockTwits Scraper for sentiment, DexScreener for token context - **Backtest data** — `chart` mode gives 5+ years of daily candles per ticker in one run - **Options flow** — chain snapshots with IV + OI for volatility research - **Earnings/fundamental models** — `financials` covers revenue, margins, analyst consensus - **Portfolio alerting** — `watch` + schedule = "tell me when anything in my book moves 3%" ### Pricing **$1.00 per 1,000 results** (pay-per-event). A 500-contract option chain costs $0.50. A 30-ticker watchlist poll costs $0.03. ### FAQ **Do I need a Yahoo account or API key?** No — the actor uses Yahoo's public JSON endpoints with the standard crumb handshake the site's own frontend performs. **What tickers work?** Anything resolvable on finance.yahoo.com: `AAPL`, `^GSPC` (S\&P), `BTC-USD`, `ETH-USD`, `EURUSD=X` (forex), `ES=F` (futures), `0700.HK` (international exchanges work too). **Is the data real-time?** Quotes come from Nasdaq Real Time Price / Yahoo's feed — same numbers the website shows (15-min delayed for some exchanges, real-time for crypto). **How far back does `chart` go?** `range: "max"` returns the instrument's full listed history — decades for blue chips. **Rate limits?** Yahoo rate-limits aggressively-identified clients — the actor handles crumb rotation automatically. For heavy schedules, enable the proxy option. **Is it legal to scrape this data?** The actor only accesses publicly available data — the same pages/APIs a browser sees. Scraping public data for research, monitoring, and analysis is common practice, but platform Terms of Service and the rules in your jurisdiction still apply to how you use it. Consult legal counsel for your specific case. ### More from this developer **Monitors & business intel:** [ATS Jobs Monitor](https://apify.com/brick_joey_yto/ats-jobs-monitor) · [Sports Scores & Odds Monitor](https://apify.com/brick_joey_yto/sports-scores-odds-monitor) · [Prediction Markets Monitor](https://apify.com/brick_joey_yto/prediction-markets-monitor) · [DexScreener Scraper — Crypto Token Monitor](https://apify.com/brick_joey_yto/crypto-token-monitor) · [Crypto Derivatives Monitor](https://apify.com/brick_joey_yto/crypto-derivatives-monitor) · [Google News Monitor](https://apify.com/brick_joey_yto/google-news-monitor) · [App Store Monitor](https://apify.com/brick_joey_yto/app-store-monitor) · [Walmart Product Monitor](https://apify.com/brick_joey_yto/walmart-product-monitor) · [Pump.fun Monitor](https://apify.com/brick_joey_yto/memecoin-launch-monitor) · [StockTwits Scraper](https://apify.com/brick_joey_yto/stocktwits-scraper) · [Product Hunt Monitor](https://apify.com/brick_joey_yto/product-hunt-monitor) · [Hacker News Monitor](https://apify.com/brick_joey_yto/hackernews-monitor) · [AI Visibility Tracker](https://apify.com/brick_joey_yto/ai-brand-monitor) **Alt-social & OSINT:** [Gab Scraper](https://apify.com/brick_joey_yto/gab-search-scraper) · [BitChute Scraper](https://apify.com/brick_joey_yto/bitchute-search-scraper) · [Truth Social Scraper](https://apify.com/brick_joey_yto/truth-social-scraper) · [Telegram Scraper](https://apify.com/brick_joey_yto/telegram-scraper) · [Discord Scraper](https://apify.com/brick_joey_yto/discord-scraper) · [Rumble Video Scraper](https://apify.com/brick_joey_yto/rumble-video-scraper) · [Odysee Scraper](https://apify.com/brick_joey_yto/odysee-scraper) · [Kick Scraper](https://apify.com/brick_joey_yto/kick-scraper) · [4chan Scraper](https://apify.com/brick_joey_yto/4chan-scraper) · [Bitcointalk Scraper](https://apify.com/brick_joey_yto/bitcointalk-scraper) · [Xiaohongshu / RedNote Scraper](https://apify.com/brick_joey_yto/xiaohongshu-scraper) **Creator platforms:** [Bluesky Scraper](https://apify.com/brick_joey_yto/bluesky-search-scraper) · [Threads Scraper](https://apify.com/brick_joey_yto/threads-profile-scraper) · [Farcaster Scraper](https://apify.com/brick_joey_yto/farcaster-scraper) · [Spoutible Scraper](https://apify.com/brick_joey_yto/spoutible-scraper) · [Pixelfed Scraper](https://apify.com/brick_joey_yto/pixelfed-scraper) · [Substack Notes Scraper](https://apify.com/brick_joey_yto/substack-notes-scraper) · [Dailymotion Scraper](https://apify.com/brick_joey_yto/dailymotion-scraper) · [Roblox Scraper](https://apify.com/brick_joey_yto/roblox-scraper) **Gov & regulatory:** [Federal Register Monitor](https://apify.com/brick_joey_yto/federal-register-monitor) · [Federal Court Monitor](https://apify.com/brick_joey_yto/federal-court-monitor) · [FDA Compliance Monitor](https://apify.com/brick_joey_yto/fda-compliance-monitor) · [Clinical Trials Monitor](https://apify.com/brick_joey_yto/clinical-trials-monitor) · [Lobbying Monitor](https://apify.com/brick_joey_yto/lobbying-monitor) *** *Not affiliated with Yahoo Inc. Uses publicly accessible endpoints — respect Yahoo's Terms of Service.* # Actor input Schema ## `mode` (type: `string`): What to fetch: quote (live price/metrics per ticker), chart (OHLCV history), news (ticker headlines), options (full option chains w/ IV/OI), financials (fundamentals + analyst targets), screener (day gainers/losers/most-active…), watch (price monitor — only emit tickers that moved ≥ minChangePct). ## `symbols` (type: `array`): Yahoo symbols — stocks (AAPL, NVDA), crypto (BTC-USD, ETH-USD), indices (^GSPC, ^IXIC), ETFs (SPY), forex (EURUSD=X), futures (ES=F). Demo default: AAPL, NVDA, BTC-USD. ## `interval` (type: `string`): Candle interval for chart mode — 1m, 5m, 15m, 30m, 1h, 1d, 1wk, 1mo. ## `range` (type: `string`): How far back the chart goes — 1d, 5d, 1mo, 3mo, 6mo, 1y, 5y, max. ## `expiry` (type: `integer`): Options mode: pick a specific expiration (unix timestamp). Leave empty for the nearest expiry. ## `screen` (type: `string`): Screener mode: which Yahoo predefined screen to pull. ## `newsPerSymbol` (type: `integer`): News mode: headlines per ticker, 1–50, default 10. ## `minChangePct` (type: `number`): Watch mode: only emit tickers whose |daily change %| is at least this value — e.g. 2 means only movers of 2%+ get rows. Leave empty to emit every ticker. ## `maxResults` (type: `integer`): Row cap — per symbol for chart/options, total for screener. 1–5000, default 100. ## `proxyConfiguration` (type: `object`): Optional Apify proxy — useful if Yahoo rate-limits your runs. ## Actor input object example ```json { "mode": "quote", "symbols": [ "AAPL", "NVDA", "BTC-USD" ], "interval": "1d", "range": "1mo", "screen": "day_gainers", "newsPerSymbol": 10, "maxResults": 100 } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing quote, candle, news, option, financials, or screener records # 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 = { "mode": "quote", "symbols": [ "AAPL", "NVDA", "BTC-USD" ] }; // Run the Actor and wait for it to finish const run = await client.actor("brick_joey_yto/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 = { "mode": "quote", "symbols": [ "AAPL", "NVDA", "BTC-USD", ], } # Run the Actor and wait for it to finish run = client.actor("brick_joey_yto/yahoo-finance-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "quote", "symbols": [ "AAPL", "NVDA", "BTC-USD" ] }' | apify call brick_joey_yto/yahoo-finance-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,brick_joey_yto/yahoo-finance-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/rLLRZL2hT7cFX0OXb/builds/fLrfHcPJow36K7cfn/openapi.json