{ "openapi": "3.0.1", "info": { "title": "Twitch Scraper - Streamer Emails, Followers, Streams & Games", "description": "Export public Twitch streamer profiles with follower counts, business emails and social links, plus live streams, past broadcasts and top games with viewer totals. Filter streamers by game, language and followers for influencer outreach, sponsorship and gaming analytics.", "version": "0.1", "x-build-id": "tswPniaeKYZZ7PpiN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~twitch-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-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/s-r~twitch-scraper/runs": { "post": { "operationId": "runs-sync-s-r-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/s-r~twitch-scraper/run-sync": { "post": { "operationId": "run-sync-s-r-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": "Channel logins, @handles or public Twitch channel URLs.", "items": { "type": "string" } }, "channelUsernames": { "title": "Channelusernames", "type": "array", "description": "Channel logins, @handles or public Twitch channel URLs.", "items": { "type": "string" } }, "logins": { "title": "Logins", "type": "array", "description": "Channel logins, @handles or public Twitch channel URLs.", "items": { "type": "string" } }, "games": { "title": "Games", "type": "array", "description": "Game names, slugs or Twitch category URLs.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Game names, slugs or Twitch category URLs.", "items": { "type": "string" } }, "gameName": { "title": "Gamename", "minLength": 1, "maxLength": 200, "type": "string", "description": "One game name or category URL; alias for a games entry." }, "searchQuery": { "title": "Searchquery", "minLength": 1, "maxLength": 200, "type": "string", "description": "Search Twitch channels and games; returned channels are fetched as full profiles." }, "searchQueries": { "title": "Searchqueries", "type": "array", "description": "Search terms; combined with searchQuery.", "items": { "type": "string" } }, "topGames": { "title": "Topgames", "type": "boolean", "description": "Return Twitch categories ranked by current viewers. Only topic rows are returned.", "default": false }, "maxResults": { "title": "Maxresults", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Fallback limit for maxGames and maxStreamsPerGame.", "default": 20 }, "maxGames": { "title": "Maxgames", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of top categories across all cursor pages." }, "maxStreamsPerGame": { "title": "Maxstreamspergame", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum unique live streams per requested category across all pages; zero returns only category data." }, "maxVideosPerChannel": { "title": "Maxvideosperchannel", "minimum": 0, "maximum": 100, "type": "integer", "description": "Recent archived broadcasts per loaded channel; zero disables video retrieval." }, "languages": { "title": "Languages", "type": "array", "description": "Filter directory streams by two-letter language codes; output language is lowercase.", "items": { "type": "string" } }, "includeStreamerProfiles": { "title": "Includestreamerprofiles", "type": "boolean", "description": "Fetch full creator profiles, public panels and contact addresses for directory streamers.", "default": false }, "minFollowers": { "title": "Minfollowers", "minimum": 0, "maximum": 9007199254740991, "type": "integer", "description": "Follower threshold for profiles discovered through categories; explicit channels are not filtered." }, "maxFollowers": { "title": "Maxfollowers", "minimum": 0, "maximum": 9007199254740991, "type": "integer", "description": "Follower threshold for profiles discovered through categories; explicit channels are not filtered." }, "cursor": { "title": "Cursor", "maxLength": 8000000, "type": "string", "description": "Opaque continuation token. Repeat the original input with this token to retrieve the next request chunk." } } }, "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 } } } } } } } } } }