{ "openapi": "3.0.1", "info": { "title": "Global Stock Exchange Meta Scraper — 25 Exchanges, One Call", "description": "One API call for global equities snapshots across 25 stock exchanges. Replaces stitching 25 individual exchange feeds.", "version": "0.0", "x-build-id": "EbS9MPOkpnjpU4Brf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~stock-exchange-meta-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-stock-exchange-meta-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/nexgendata~stock-exchange-meta-scraper/runs": { "post": { "operationId": "runs-sync-nexgendata-stock-exchange-meta-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/nexgendata~stock-exchange-meta-scraper/run-sync": { "post": { "operationId": "run-sync-nexgendata-stock-exchange-meta-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": { "exchanges": { "title": "Exchanges to query", "uniqueItems": true, "type": "array", "description": "List of exchange codes to include in this snapshot. Pick any subset of the 25 supported exchanges (KOSPI, TWSE, NSE_INDIA, BSE_INDIA, B3_BRAZIL, HKEX, SGX, HOSE_VIETNAM, TSE_JAPAN, LSE_UK, XETRA_GERMANY, TSX_CANADA, ASX_AUSTRALIA, TADAWUL_SAUDI, BMV_MEXICO, JSE_SOUTH_AFRICA, IDX_INDONESIA, SET_THAILAND, BURSA_MALAYSIA, BIST_TURKEY, PSE_PHILIPPINES, STAR_CHINA, CHINEXT_CHINA, CHINESE_ADRS, BSE_BEIJING, EASTMONEY_A_SHARES). Leave the default (all 25) to get a true global snapshot in one run.", "items": { "type": "string", "enum": [ "KOSPI", "TWSE", "NSE_INDIA", "BSE_INDIA", "B3_BRAZIL", "HKEX", "SGX", "HOSE_VIETNAM", "TSE_JAPAN", "LSE_UK", "XETRA_GERMANY", "TSX_CANADA", "ASX_AUSTRALIA", "TADAWUL_SAUDI", "BMV_MEXICO", "JSE_SOUTH_AFRICA", "IDX_INDONESIA", "SET_THAILAND", "BURSA_MALAYSIA", "BIST_TURKEY", "PSE_PHILIPPINES", "STAR_CHINA", "CHINEXT_CHINA", "CHINESE_ADRS", "BSE_BEIJING", "EASTMONEY_A_SHARES" ], "enumTitles": [ "South Korea — KOSPI / KOSDAQ", "Taiwan — TWSE", "India — NSE", "India — BSE", "Brazil — B3 (Bovespa)", "Hong Kong — HKEX (Hang Seng)", "Singapore — SGX", "Vietnam — HOSE", "Japan — TSE", "United Kingdom — LSE", "Germany — Xetra / DAX", "Canada — TSX", "Australia — ASX", "Saudi Arabia — Tadawul", "Mexico — BMV", "South Africa — JSE", "Indonesia — IDX", "Thailand — SET", "Malaysia — Bursa", "Turkey — BIST", "Philippines — PSE", "China — STAR Market", "China — ChiNext", "China — US-listed ADRs", "China — Beijing Stock Exchange", "China — Eastmoney A-Shares" ] }, "default": [ "KOSPI", "TWSE", "NSE_INDIA", "BSE_INDIA", "B3_BRAZIL", "HKEX", "SGX", "HOSE_VIETNAM", "TSE_JAPAN", "LSE_UK", "XETRA_GERMANY", "TSX_CANADA", "ASX_AUSTRALIA", "TADAWUL_SAUDI", "BMV_MEXICO", "JSE_SOUTH_AFRICA", "IDX_INDONESIA", "SET_THAILAND", "BURSA_MALAYSIA", "BIST_TURKEY", "PSE_PHILIPPINES", "STAR_CHINA", "CHINEXT_CHINA", "CHINESE_ADRS", "BSE_BEIJING", "EASTMONEY_A_SHARES" ] }, "outputMode": { "title": "Output mode", "enum": [ "per_exchange_summary", "per_stock" ], "type": "string", "description": "Shape of the dataset rows. `per_exchange_summary` returns ONE aggregated row per exchange (top 5 gainers, top 5 losers, top 10 by market cap, advancers/decliners, median change) — ideal for daily institutional briefings and hedge-fund snapshots. `per_stock` returns a flat list of normalized stock rows across all selected exchanges (much larger output) — ideal for sector rotation, cross-border ETF construction, and screener workflows.", "default": "per_exchange_summary" }, "topN": { "title": "Top N stocks per exchange", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many stocks to fetch per exchange. In `per_exchange_summary` mode this controls the underlying universe used to compute aggregates (default 50 is sufficient for top-movers / index leaders). In `per_stock` mode it directly controls dataset size — 100 stocks × 25 exchanges = 2,500 rows. Maximum 500.", "default": 50 }, "maxParallel": { "title": "Max parallel sub-actor runs", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many sub-actors to run concurrently. Higher = faster wall-clock but more peak memory + risk of provider rate-limits. 5 is the sweet spot for a global snapshot across 25 exchanges (~5 batches of 5).", "default": 5 }, "subActorTimeoutSecs": { "title": "Per sub-actor timeout (seconds)", "minimum": 60, "maximum": 1200, "type": "integer", "description": "Maximum seconds to wait for any one sub-actor run to complete. If a single exchange screener stalls (regional outage, captcha), it will be cut off and the error recorded in that exchange's row — other exchanges continue. Default 300s (5 min) is plenty for any single screener at topN=500.", "default": 300 } } }, "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 } } } } } } } } } }