{ "openapi": "3.0.1", "info": { "title": "Kick Streamer Finder by Category - Emails, Socials, New Only", "description": "Find the Kick streamers live in any category right now, with follower and viewer counts, stream title, language, social links and the business email each streamer published in the channel bio or panels. Filter by followers, viewers, language or email; get only new streamers on each scheduled run.", "version": "0.0", "x-build-id": "ZRT9vFkNW6aLe61Pl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~kick-streamer-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-kick-streamer-finder", "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/neverempty~kick-streamer-finder/runs": { "post": { "operationId": "runs-sync-neverempty-kick-streamer-finder", "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/neverempty~kick-streamer-finder/run-sync": { "post": { "operationId": "run-sync-neverempty-kick-streamer-finder", "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": { "games": { "title": "Games or categories", "type": "array", "description": "The Kick categories to search, one per line: the name as Kick shows it (VALORANT, Just Chatting, Grand Theft Auto V), the slug (grand-theft-auto-v), the category URL (https://kick.com/category/valorant) or the category number. A name Kick does not know comes back as a free row with Kick's closest matches. Up to 50 per run. If you leave this empty, the example category VALORANT is searched and every row says so in inputGame.", "items": { "type": "string" } }, "maxStreamersPerGame": { "title": "Maximum streamers per category", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many matching streamers to return for each category. Streamers come in order of current viewers, most first.", "default": 100 }, "maxRecords": { "title": "Maximum rows to return in total", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The most charged rows this run returns across all categories. When it is reached, a free row says which categories were not searched to the end.", "default": 1000 }, "maxRequests": { "title": "Maximum requests to Kick", "minimum": 1, "maximum": 5000, "type": "integer", "description": "A safety limit on how many pages this run reads. Each streamer takes 2 (the channel and its panels), and each list page of up to 100 live streams takes 1, so the default of 300 covers about 140 streamers. Raise it for bigger runs. When the limit is hit, a free row says what was not searched.", "default": 300 }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Return only channels with at least this many followers. Leave empty for no lower limit." }, "maxFollowers": { "title": "Maximum followers", "minimum": 0, "type": "integer", "description": "Return only channels with at most this many followers, for example to find small and mid-size streamers. Leave empty for no upper limit." }, "minViewers": { "title": "Minimum viewers right now", "minimum": 0, "type": "integer", "description": "Return only streams with at least this many viewers at the moment of the run." }, "maxViewers": { "title": "Maximum viewers right now", "minimum": 0, "type": "integer", "description": "Return only streams with at most this many viewers at the moment of the run." }, "languages": { "title": "Stream languages", "type": "array", "description": "Language codes of the stream as Kick sets them, for example en, es, pt, de, fr, ar, tr. Leave empty for all languages. A code Kick does not accept comes back as a free row.", "items": { "type": "string" } }, "onlyWithEmail": { "title": "Only streamers with a business email", "type": "boolean", "description": "On = return only streamers who published an email address in their channel bio or panels. Streamers without one are read but not returned, so they cost nothing.", "default": false }, "monitoringMode": { "title": "Return only streamers not returned before", "type": "boolean", "description": "On = the Actor remembers every streamer it returned and charged for, and later runs return only streamers it has not returned before. Put it on a schedule to receive new streamers in a category each day. Streamers who were found but not returned (for example because the run hit its maximum total charge) are not remembered, so they still count as new next time. The memory is shared by all your runs of this Actor.", "default": false }, "resetMonitoringState": { "title": "Forget the remembered streamers and start over", "type": "boolean", "description": "Clears the list of streamers already returned, so the next monitoring run returns everyone again. This affects all your monitoring runs of this Actor.", "default": false }, "useProxy": { "title": "Retry through Apify Proxy if Kick slows the run down", "type": "boolean", "description": "On = if Kick answers with a bot check or a rate limit, the run retries through Apify Proxy instead of stopping. Off = such an answer is reported as a free row.", "default": 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 }, "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 } } } } } } } } } }