{
"openapi": "3.0.1",
"info": {
"title": "Yahoo Finance Scraper — Quotes, Fundamentals, Options & News",
"description": "Scrape all of Yahoo Finance in one actor: live quotes with 60+ fields, historical OHLCV candles, income/balance/cash-flow statements, analyst ratings & price targets, full options chains, news, symbol search & screeners. Stocks, ETFs, crypto, forex, indices. No API key. JSON/CSV.",
"version": "0.0",
"x-build-id": "WB54h4D138Uwd68rB"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/memo23~yahoo-finance-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-memo23-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/memo23~yahoo-finance-scraper/runs": {
"post": {
"operationId": "runs-sync-memo23-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/memo23~yahoo-finance-scraper/run-sync": {
"post": {
"operationId": "run-sync-memo23-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": [
"operation"
],
"properties": {
"operation": {
"title": "Operation",
"enum": [
"quotes",
"historical",
"fundamentals",
"analysis",
"options",
"news",
"search",
"screener",
"holders",
"insiders",
"calendar",
"esg",
"profile"
],
"type": "string",
"description": "What to scrape when Operations (bundle) is empty. quotes = snapshot. historical = OHLCV. fundamentals = statements. analysis = ratings. options = chains (+ Greeks). news / search / screener. holders = institutions. insiders = insider trades. calendar = earnings dates. esg = ESG scores. profile = officers + ETF holdings.",
"default": "quotes"
},
"operations": {
"title": "Operations (bundle)",
"uniqueItems": true,
"type": "array",
"description": "Run several products in one run. When this list is set, it is used instead of the single Operation field. Each product still emits its own rows (you are charged per row). Leave empty to use Operation alone.",
"items": {
"type": "string",
"enum": [
"quotes",
"historical",
"fundamentals",
"analysis",
"options",
"news",
"search",
"screener",
"holders",
"insiders",
"calendar",
"esg",
"profile"
],
"enumTitles": [
"Quotes",
"Historical",
"Fundamentals",
"Analysis",
"Options",
"News",
"Search",
"Screener",
"Holders",
"Insiders",
"Calendar",
"ESG",
"Profile"
]
}
},
"tickers": {
"title": "Tickers",
"type": "array",
"description": "Ticker symbols or full Yahoo Finance quote URLs. Works with stocks (AAPL), ETFs (SPY), crypto (BTC-USD), forex (EURUSD=X), indices (^GSPC) and futures (GC=F). Used by quotes, historical, fundamentals, analysis, options, news, holders, insiders, calendar, esg and profile.",
"items": {
"type": "string"
}
},
"query": {
"title": "Search query",
"type": "string",
"description": "Free-text query for the search operation (company name, ticker or ISIN), also usable for news instead of tickers. Example: apple, US0378331005."
},
"range": {
"title": "Range (historical)",
"enum": [
"1d",
"5d",
"1mo",
"3mo",
"6mo",
"1y",
"2y",
"5y",
"10y",
"ytd",
"max"
],
"type": "string",
"description": "How far back to fetch candles. Ignored when an explicit start date is set.",
"default": "1mo"
},
"interval": {
"title": "Interval (historical)",
"enum": [
"1m",
"2m",
"5m",
"15m",
"30m",
"60m",
"90m",
"1h",
"1d",
"5d",
"1wk",
"1mo",
"3mo"
],
"type": "string",
"description": "Candle size. Intraday intervals (1m–1h) are only available for recent periods — Yahoo keeps ~30 days of 1m data and ~2 years of 1h data.",
"default": "1d"
},
"startDate": {
"title": "Start date (historical)",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string",
"description": "Explicit start date YYYY-MM-DD — overrides Range when set."
},
"endDate": {
"title": "End date (historical)",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string",
"description": "Explicit end date YYYY-MM-DD — defaults to today. Only used together with Start date."
},
"includeEvents": {
"title": "Include dividends & splits",
"type": "boolean",
"description": "Also emit one row per dividend payment and stock split inside the selected period (historical operation).",
"default": false
},
"includePrePost": {
"title": "Include pre/post-market bars",
"type": "boolean",
"description": "On historical intraday intervals, also emit pre-market and after-hours bars.",
"default": false
},
"includeGreeks": {
"title": "Include option Greeks",
"type": "boolean",
"description": "On options rows, attach Black-Scholes delta, gamma, theta (per day), vega and rho from Yahoo's implied volatility. Turn off to skip.",
"default": true
},
"optionsExpirations": {
"title": "Expirations per ticker (options)",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "How many upcoming expiration dates to fetch per ticker — each expiration is a full call + put chain (often 50–200 contracts). Default 1 = nearest expiration only.",
"default": 1
},
"screenerId": {
"title": "Screener (screener)",
"enum": [
"day_gainers",
"day_losers",
"most_actives",
"growth_technology_stocks",
"undervalued_growth_stocks",
"undervalued_large_caps",
"aggressive_small_caps",
"small_cap_gainers",
"solid_large_growth_funds",
"top_mutual_funds",
"conservative_foreign_funds",
"high_yield_bond",
"most_shorted_stocks",
"all_cryptocurrencies_us",
"day_gainers_cryptocurrencies",
"day_losers_cryptocurrencies",
"most_actives_cryptocurrencies",
"portfolio_anchors",
"solid_midcap_growth_funds",
"day_gainers_mutual_funds"
],
"type": "string",
"description": "Which predefined Yahoo screener to pull for the screener operation.",
"default": "day_gainers"
},
"maxItems": {
"title": "Max results",
"minimum": 1,
"type": "integer",
"description": "Hard cap on dataset rows for the whole run (you are only charged per row actually pushed). Leave empty for no cap."
},
"proxy": {
"title": "Proxy override",
"type": "object",
"description": "Optional override. The actor already routes through premium residential proxies by default — only set this if you must use your own."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}