{ "openapi": "3.0.1", "info": { "title": "Yahoo Finance Scraper — Stocks, ETFs, Crypto, Indices", "description": "Pull real-time quotes, fundamentals, financials, analyst targets, dividends, company officers, and historical OHLCV for any Yahoo Finance ticker. Works for stocks, ETFs, mutual funds, crypto, FX, and indices. Output as JSON, CSV, or Excel.", "version": "0.1", "x-build-id": "ggggB55fy6RH6YZYc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alwaysprimedev~yahoo-finance-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alwaysprimedev-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/alwaysprimedev~yahoo-finance-scraper/runs": { "post": { "operationId": "runs-sync-alwaysprimedev-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/alwaysprimedev~yahoo-finance-scraper/run-sync": { "post": { "operationId": "run-sync-alwaysprimedev-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": "List of Yahoo Finance ticker symbols to scrape. Examples: AAPL, MSFT, GOOGL, TSLA, BTC-USD, EURUSD=X, ^GSPC, SPY. Supports stocks, ETFs, mutual funds, crypto, FX, and indices.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Free-text queries (company names, ISIN, partial symbols). Each query returns up to 10 matching tickers, which are then merged with the explicit `tickers` list and deduplicated.", "items": { "type": "string" } }, "screeners": { "title": "Predefined screeners", "type": "array", "description": "Use Yahoo's built-in lists. Each screener resolves to up to 100 tickers. Available: most_actives, day_gainers, day_losers, trending_tickers, undervalued_growth_stocks, growth_technology_stocks, aggressive_small_caps, small_cap_gainers, top_mutual_funds, portfolio_anchors, solid_large_growth_funds, solid_midcap_growth_funds, conservative_foreign_funds, high_yield_bond.", "items": { "type": "string" } }, "modules": { "title": "Data modules", "type": "string", "description": "Comma-separated Yahoo quoteSummary modules to fetch per ticker. The default set covers price, fundamentals, profile, analyst targets, key statistics, calendar, earnings, and analyst trends. Extra modules (e.g. insiderHolders, fundOwnership, secFilings) can be added but increase per-ticker bandwidth." }, "includeHistory": { "title": "Include historical OHLCV", "type": "boolean", "description": "When enabled, attaches a `history` array of daily/weekly/monthly OHLCV bars to each record. Adds one extra request per ticker and roughly 5-15 KB per ticker.", "default": false }, "historyInterval": { "title": "History interval", "enum": [ "1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo" ], "type": "string", "description": "Bar granularity when `includeHistory` is on.", "default": "1d" }, "historyRange": { "title": "History range", "enum": [ "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max" ], "type": "string", "description": "How far back to fetch bars when `includeHistory` is on.", "default": "1mo" }, "maxHistoryBars": { "title": "Max bars per ticker", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Cap on the number of historical bars returned per ticker. 0 = unlimited (within `historyRange`). Useful for keeping output size predictable." }, "maxItems": { "title": "Max items", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Hard cap on the number of tickers scraped (0 = unlimited). Applied after deduplication across `tickers`, `searchQueries`, and `screeners`." }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 25, "type": "integer", "description": "Number of parallel ticker requests. 5 is safe for any run size. Raise to 10-15 only for very large runs against a clean IP." } } }, "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 } } } } } } } } } }