{ "openapi": "3.0.1", "info": { "title": "Twitch Scraper — Channels, Emails, Live Streams, VODs & Clips", "description": "Scrape Twitch channels (followers, partner status, live now, social links and business emails from panels), the top live streams of any game/category by language, plus recent VODs and top clips. No login, no API key.", "version": "0.1", "x-build-id": "zSpuxSWe0LbFb2bJ0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jeffev~twitch-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jeffev-twitch-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/jeffev~twitch-scraper/runs": { "post": { "operationId": "runs-sync-jeffev-twitch-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/jeffev~twitch-scraper/run-sync": { "post": { "operationId": "run-sync-jeffev-twitch-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": { "channels": { "title": "Channels", "type": "array", "description": "Twitch logins or channel URLs. Each returns the full channel profile (followers, live status, social links, emails found in the panels).", "items": { "type": "string" } }, "categories": { "title": "Categories / games", "type": "array", "description": "Game or category names (e.g. 'VALORANT', 'Just Chatting'). Returns the live streams with most viewers right now. Approximate names are matched with Twitch search.", "items": { "type": "string" } }, "languages": { "title": "Stream languages", "type": "array", "description": "Only live streams in these languages (codes like EN, PT, ES, DE, FR). Each language returns up to 100 streams per category.", "items": { "type": "string" } }, "enrichStreamers": { "title": "Full channel profile for each streamer", "type": "boolean", "description": "Return a full channel item (social links, emails, description...) for every live streamer found in the categories, instead of a short stream item. Charged as a channel.", "default": false }, "searchChannels": { "title": "Search channels by keyword", "type": "array", "description": "Find channels whose name or profile matches these keywords (e.g. 'valorant', 'cooking', 'asmr'), live or not. Each returns the full channel profile.", "items": { "type": "string" } }, "maxChannelsPerSearch": { "title": "Max channels per keyword", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many channels to return per keyword.", "default": 50 }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Skip channels with fewer followers (keyword search and live streams by category)." }, "maxFollowers": { "title": "Maximum followers", "minimum": 0, "type": "integer", "description": "Skip channels with more followers, great for micro-streamers (keyword search and live streams by category)." }, "onlyWithEmail": { "title": "Only channels with a contact email", "type": "boolean", "description": "Keep only channels that show an email in their panels or bio (keyword search, and live streams when 'Full channel profile for each streamer' is on). Channels without email are not charged.", "default": false }, "minViewers": { "title": "Minimum viewers", "minimum": 0, "type": "integer", "description": "Skip live streams with fewer viewers than this." }, "maxStreamsPerCategory": { "title": "Max streams per category", "minimum": 1, "maximum": 3000, "type": "integer", "description": "Limit of live streams per category (Twitch returns up to 100 per language).", "default": 100 }, "videosPerChannel": { "title": "Recent VODs per channel", "minimum": 0, "maximum": 100, "type": "integer", "description": "How many recent past broadcasts/videos to return per channel (0 = none).", "default": 0 }, "clipsPerChannel": { "title": "Top clips per channel", "minimum": 0, "maximum": 100, "type": "integer", "description": "How many most-viewed clips to return per channel (0 = none).", "default": 0 }, "clipsPeriod": { "title": "Clips period", "enum": [ "LAST_DAY", "LAST_WEEK", "LAST_MONTH", "ALL_TIME" ], "type": "string", "description": "Time window for the top clips.", "default": "LAST_MONTH" } } }, "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 } } } } } } } } } }