{ "openapi": "3.0.1", "info": { "title": "🇹🇷 BIST Turkey Stock Screener — BIST 30 Quotes", "description": "BIST Borsa Istanbul Turkey stock screener API — BIST 100 / BIST 30 live quotes, market cap (TRY), P/E, P/B, dividend yield, ROE, sector. Turkish Airlines, Garanti BBVA, Akbank, Koç Holding universe. Bloomberg / FactSet / Refinitiv Eikon alternative for EMEA data. Pay-per-result.", "version": "0.0", "x-build-id": "c6NoulmecArwGB8TS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~bist-turkey-stock-screener/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-bist-turkey-stock-screener", "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~bist-turkey-stock-screener/runs": { "post": { "operationId": "runs-sync-nexgendata-bist-turkey-stock-screener", "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~bist-turkey-stock-screener/run-sync": { "post": { "operationId": "run-sync-nexgendata-bist-turkey-stock-screener", "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": { "index": { "title": "Index / Market", "enum": [ "BIST30", "BIST100", "BIST-all" ], "type": "string", "description": "Which Borsa Istanbul (BIST) market scope to screen. BIST30 = the Turkish blue-chip benchmark of the 30 largest, most-liquid Istanbul-listed equities (Akbank AKBNK, Garanti BBVA GARAN, Türkiye Iş Bankası ISCTR, Koç Holding KCHOL, Sabancı Holding SAHOL, Turkish Airlines THYAO, Ereğli Demir Çelik EREGL, BIM Birleşik Mağazalar BIMAS, ASELSAN, Tüpraş TUPRS, etc.). BIST100 = broader 100-name benchmark covering the largest BIST main-board equities. BIST-all = entire Borsa Istanbul universe (~500 listed names) sorted by market cap descending. BIST30 is the headline Turkish benchmark (similar to Saudi TASI, FTSE 100 in the UK, or DAX 40 in Germany).", "default": "BIST30" }, "limit": { "title": "Limit (stocks returned)", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of Turkish-listed stocks to return. Stocks are returned in descending market-cap order. Use 10 for a quick smoke test, 30 for the BIST30 blue-chips, 100 for BIST100 coverage, 500+ to sweep the entire Borsa Istanbul universe. Borsa Istanbul has roughly 500 listed companies on the main board.", "default": 30 }, "min_market_cap_try_billion": { "title": "Min market cap (billion TRY)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Filter to stocks with market cap above this threshold, in BILLIONS of Turkish Lira (TRY). Examples: 50 = 50B TRY (mid-cap floor), 200 = 200B TRY (BIST30 mega-caps), 500 = 500B TRY (top 10 Turkish blue-chips like ASELSAN, QNB, Enka, Garanti, Koç, BIM, Turkish Airlines). Leave at 0 for no filter. Note: TRY is highly volatile due to Turkish inflation — 1 USD ≈ 35-40 TRY as of 2026, so a 100B TRY market cap is roughly $2.5-3B USD.", "default": 0 }, "sector": { "title": "Sector / industry / name keyword", "type": "string", "description": "Optional case-insensitive substring filter applied to sector, industry, and company name. Examples: 'bank' (Akbank, Garanti, Iş Bankası, Yapı Kredi, Halkbank, Vakıfbank, QNB Türkiye), 'holding' (Koç, Sabancı, Eczacıbaşı, Doğuş), 'airline' (Turkish Airlines / THYAO, Pegasus / PGSUS), 'steel' or 'iron' (Ereğli / EREGL, Kardemir), 'retail' (BIM / BIMAS, Migros / MGROS, Şok / SOKM), 'cement', 'energy', 'petrochemical' (Tüpraş / TUPRS, Petkim / PETKM), 'defense' (ASELSAN). Leave blank for no filter. Note: sector matching requires enrich_fundamentals=true." }, "enrich_fundamentals": { "title": "Enrich with fundamentals (slower)", "type": "boolean", "description": "If true, fetch each stock's detail page on stockanalysis.com to extract P/E ratio, forward P/E, EPS, dividend yield, shares outstanding, beta, RSI, 52-week range, sector and industry classification, and earnings dates. Adds ~1 HTTP request per stock and roughly doubles runtime. Required if you want to filter by sector. Turkish equities trade at unusually low P/E multiples (often single-digit) due to high domestic inflation and TRY currency volatility — useful signal for value screens.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration. Defaults to Apify datacenter proxy for reliable global access to stockanalysis.com. Switch to RESIDENTIAL group only if you hit rate limits — the BIST listing page is lightweight and rarely throttles.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }