{ "openapi": "3.0.1", "info": { "title": "Yahoo Finance Scraper: Quotes, Financials, Options — $0.84/1k", "description": "Yahoo Finance data for any ticker list, screener or trending feed: live quotes (86 fields), profile, key stats, income/balance/cash-flow statements, earnings, analyst targets, ownership, options chains, price history, news. No login or cookies. MCP-ready for AI agents. $0.84 per 1,000 records.", "version": "1.0", "x-build-id": "B3QQvshd9n7tCv9Xb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fortuitous_pirate~yahoo-finance-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fortuitous_pirate-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/fortuitous_pirate~yahoo-finance-scraper/runs": { "post": { "operationId": "runs-sync-fortuitous_pirate-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/fortuitous_pirate~yahoo-finance-scraper/run-sync": { "post": { "operationId": "run-sync-fortuitous_pirate-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": { "tickers": { "title": "Tickers", "type": "array", "description": "Yahoo Finance symbols or quote URLs: stocks (AAPL), international (7203.T, SAP.DE), ETFs (SPY), indices (^GSPC), crypto (BTC-USD), FX (EURUSD=X), futures (GC=F), mutual funds (VFIAX). Leave empty to use a list file, search, trending or a screener. With nothing set the actor runs a 3-ticker sample.", "items": { "type": "string" } }, "listUrl": { "title": "Ticker list (CSV / Google Sheet URL)", "type": "string", "description": "Public URL of a CSV/TSV file or a Google Sheet shared as 'anyone with the link'. First column = symbol, one per row (a header row is skipped). Appended to Tickers." }, "searchQuery": { "title": "Search query (discover symbols)", "type": "string", "description": "Company, fund or instrument name, e.g. 'Apple', 'Vanguard S&P 500', 'US0378331005'. Matching symbols are added to the run (see Max discovered symbols)." }, "trending": { "title": "Trending tickers", "type": "boolean", "description": "Add the symbols currently trending on Yahoo Finance for the Trending region.", "default": false }, "trendingRegion": { "title": "Trending region", "type": "string", "description": "Region for trending symbols: US, GB, DE, FR, ES, IT, CA, AU, IN, HK, SG, JP, BR.", "default": "US" }, "screener": { "title": "Screener", "enum": [ "day_gainers", "day_losers", "most_actives", "most_shorted_stocks", "undervalued_growth_stocks", "growth_technology_stocks", "undervalued_large_caps", "aggressive_small_caps", "small_cap_gainers", "recent_52_week_highs", "mega_cap_hc", "top_etfs_us", "all_cryptocurrencies_us", "day_gainers_cryptocurrencies", "day_losers_cryptocurrencies", "most_actives_cryptocurrencies", "top_mutual_funds", "day_gainers_mutual_funds", "portfolio_anchors", "solid_large_growth_funds", "solid_midcap_growth_funds", "conservative_foreign_funds", "high_yield_bond", "highest_valuation_private_company", "recently_funded_private_company", "most_funded_private_company", "custom" ], "type": "string", "description": "Yahoo predefined screener to pull symbols from (most active, gainers, losers, undervalued, crypto, funds, private companies...). Pick 'custom' to use the Custom screener query below." }, "screenerQuery": { "title": "Custom screener query", "type": "object", "description": "Yahoo screener criteria as JSON, e.g. {\"operator\":\"AND\",\"operands\":[{\"operator\":\"EQ\",\"operands\":[\"region\",\"us\"]},{\"operator\":\"GT\",\"operands\":[\"intradaymarketcap\",10000000000]},{\"operator\":\"LT\",\"operands\":[\"peratio.lasttwelvemonths\",15]}]}. Fields: region, exchange, sector, industry, intradaymarketcap, intradayprice, dayvolume, percentchange, peratio.lasttwelvemonths, forward_dividend_yield, eodvolume, beta." }, "screenerQuoteType": { "title": "Custom screener: instrument type", "enum": [ "EQUITY", "ETF", "MUTUALFUND", "CRYPTOCURRENCY", "INDEX", "FUTURE" ], "type": "string", "description": "Instrument type for the custom screener.", "default": "EQUITY" }, "screenerSortField": { "title": "Custom screener: sort field", "type": "string", "description": "e.g. intradaymarketcap, percentchange, dayvolume, intradayprice, peratio.lasttwelvemonths.", "default": "intradaymarketcap" }, "screenerSortType": { "title": "Custom screener: sort direction", "enum": [ "DESC", "ASC" ], "type": "string", "description": "Sort direction for the custom screener.", "default": "DESC" }, "maxDiscovered": { "title": "Max discovered symbols", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap on symbols taken from search, trending and screener (each). Screeners page 250 at a time.", "default": 25 }, "dataTypes": { "title": "Data to collect", "type": "array", "description": "One row per ticker per data type (news: one row per article; options: one row per expiration). quote = live price + 86 market fields; profile = company/fund profile; keyStats = valuation & key statistics; financials/balanceSheet/cashFlow = statements (annual & quarterly); earnings = history, estimates, next date; analysts = price targets, ratings, upgrades, technical outlook; ownership = institutions, funds, insiders; options = chains; history = OHLCV candles + dividends/splits; news = articles. esg is accepted but Yahoo no longer serves ESG scores.", "items": { "type": "string", "enum": [ "quote", "profile", "keyStats", "financials", "balanceSheet", "cashFlow", "earnings", "analysts", "ownership", "options", "history", "news", "fundamentals", "esg" ], "enumTitles": [ "Quote (price, volume, market cap, P/E, 52-week range, dividends...)", "Profile (sector, industry, employees, officers, description; fund holdings)", "Key statistics (valuation, margins, growth, short interest, beta)", "Income statement", "Balance sheet", "Cash flow statement", "Earnings (history, estimates, next earnings date)", "Analysts (price targets, ratings, upgrades/downgrades, technical outlook)", "Ownership (institutions, funds, insiders, insider transactions)", "Options chain", "Price history (OHLCV candles, dividends, splits)", "News", "Fundamentals bundle (legacy nested record)", "ESG (no longer served by Yahoo)" ] }, "default": [ "quote" ] }, "statementPeriods": { "title": "Statement periods", "type": "array", "description": "Which periods to fetch for income statement, balance sheet and cash flow.", "items": { "type": "string", "enum": [ "annual", "quarterly", "trailing" ], "enumTitles": [ "Annual", "Quarterly", "Trailing 12 months" ] }, "default": [ "annual", "quarterly" ] }, "range": { "title": "History range", "enum": [ "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max" ], "type": "string", "description": "How far back for price history (ignored when Start date is set).", "default": "1mo" }, "interval": { "title": "History interval", "enum": [ "1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo" ], "type": "string", "description": "Candle size. Intraday intervals only work for short ranges (Yahoo keeps ~30 days of 1m and ~2 years of 1h data).", "default": "1d" }, "startDate": { "title": "History start date", "type": "string", "description": "YYYY-MM-DD. Overrides History range." }, "endDate": { "title": "History end date", "type": "string", "description": "YYYY-MM-DD, inclusive. Defaults to today when Start date is set." }, "includePrePost": { "title": "Include pre/post market candles", "type": "boolean", "description": "Intraday history only.", "default": false }, "optionsExpirations": { "title": "Options: nearest expirations", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many upcoming expiration dates to fetch per ticker (one row each, full calls + puts chain).", "default": 1 }, "optionsDates": { "title": "Options: specific expiration dates", "type": "array", "description": "YYYY-MM-DD values. When set, only these expirations are fetched.", "items": { "type": "string" } }, "optionsAllExpirations": { "title": "Options: all expirations", "type": "boolean", "description": "Fetch every listed expiration (20-30 rows per ticker).", "default": false }, "maxNews": { "title": "Max news articles per ticker", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many recent articles to return per ticker (one row each).", "default": 10 }, "region": { "title": "Region", "type": "string", "description": "Market-data region passed to Yahoo (US, GB, DE, FR, JP, HK, AU, CA, IN...).", "default": "US" }, "lang": { "title": "Language", "type": "string", "description": "Locale for names and news (en-US, de-DE, fr-FR, ja-JP, zh-Hant-HK...).", "default": "en-US" }, "maxItems": { "title": "Max records", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on dataset rows for the whole run. You only pay for rows actually saved.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Yahoo answers Apify datacenter proxies; residential is only needed at very high volume.", "default": { "useApifyProxy": true } }, "symbols": { "title": "(Legacy) Symbols", "type": "array", "description": "Older name for Tickers; still accepted and merged with Tickers.", "items": { "type": "string" } }, "dataType": { "title": "(Legacy) Data type", "enum": [ "quote", "historical", "both" ], "type": "string", "description": "Older single-choice field: quote, historical or both. Merged into Data to collect." }, "historyRange": { "title": "(Legacy) History range", "enum": [ "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max" ], "type": "string", "description": "Older name for History range; takes precedence when set." }, "historyInterval": { "title": "(Legacy) History interval", "enum": [ "1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo" ], "type": "string", "description": "Older name for History interval; takes precedence when set." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }