{ "openapi": "3.0.1", "info": { "title": "Yahoo Finance Scraper - Stock Quotes, Statistics & History", "description": "Scrape Yahoo Finance for any stock, ETF, index, crypto or FX ticker: live (delayed) quotes, P/E, EPS, dividends, earnings dates, key statistics and daily/weekly/monthly price history with dividends and splits. Raw numbers, cheap per-row pricing.", "version": "0.1", "x-build-id": "mMeLdKd2O0BbFXdA9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rjmacarthy~yahoo-finance-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rjmacarthy-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/rjmacarthy~yahoo-finance-scraper/runs": { "post": { "operationId": "runs-sync-rjmacarthy-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/rjmacarthy~yahoo-finance-scraper/run-sync": { "post": { "operationId": "run-sync-rjmacarthy-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", "required": [ "tickers" ], "properties": { "tickers": { "title": "Tickers", "type": "array", "description": "Yahoo Finance symbols, exactly as shown on finance.yahoo.com: stocks (AAPL, BRK-B, 7203.T, VOD.L), ETFs (SPY), indices (^GSPC, ^IXIC), crypto (BTC-USD), currencies (EURUSD=X) and futures (GC=F). Quote page URLs work too. Max 200 per run.", "default": [ "AAPL", "MSFT", "NVDA", "TSLA", "SPY" ], "items": { "type": "string" } }, "mode": { "title": "What to scrape", "enum": [ "quote", "history" ], "type": "string", "description": "\"Quotes\" gives one item per ticker (price, change, ranges, volume, market cap, P/E, EPS, dividend, earnings date, analyst target...). \"Price history\" gives one item per daily/weekly/monthly bar (open, high, low, close, adjusted close, volume, dividends and splits).", "default": "quote" }, "includeStatistics": { "title": "Add key statistics (stocks only)", "type": "boolean", "description": "Quotes mode: also open each stock's Key Statistics page and merge valuation measures (incl. 5 quarters of history), margins, returns, income, balance sheet, cash flow, share/short-interest stats and dividend/split facts into the item. One extra page per stock, charged as the \"statistics\" event. Skipped (and not charged) for ETFs, indices, crypto and currencies, which have no such page.", "default": false }, "historyRange": { "title": "History range", "enum": [ "1mo", "3mo", "6mo", "ytd", "1y", "2y", "5y", "10y", "max" ], "type": "string", "description": "Price history mode: how far back to go.", "default": "1y" }, "historyInterval": { "title": "Bar interval", "enum": [ "daily", "weekly", "monthly" ], "type": "string", "description": "Price history mode: one row per trading day, week or month.", "default": "daily" }, "sinceDate": { "title": "Only bars after (incremental)", "type": "string", "description": "Price history mode: only output bars dated AFTER this day, e.g. 2026-10-01, or a relative period such as \"3 days\" or \"2 weeks\". When set, the still-forming bar of the current day/week/month is left out, so a daily schedule with \"3 days\" appends only finished rows (de-duplicate on the item \"id\" if periods overlap). Leave empty for the full range." }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of dataset items for the whole run (quotes or price rows). In history mode the most recent bars are kept. 0 = no limit. The default fits 5 tickers x 1 year of daily bars.", "default": 2000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed normally. Enable Apify Proxy (datacenter) if Yahoo rate-limits the run or shows a cookie-consent page (EU IPs). Residential proxies are not supported: if selected, the Actor falls back to Apify datacenter proxy.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }