{ "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 } } } } } } } } } }