{ "openapi": "3.0.1", "info": { "title": "Kick.com Scraper: Streams, Clips, VODs & Profiles", "description": "Collect public Kick profiles, live stream metrics, clips and recent VODs. Find channels by game, language or name without a Kick login.", "version": "0.1", "x-build-id": "Q23tg22N59HHe1JHl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arabiainsights~kick-research-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arabiainsights-kick-research-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/arabiainsights~kick-research-scraper/runs": { "post": { "operationId": "runs-sync-arabiainsights-kick-research-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/arabiainsights~kick-research-scraper/run-sync": { "post": { "operationId": "run-sync-arabiainsights-kick-research-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": { "task": { "title": "How would you like to find channels?", "enum": [ "channels", "live", "search", "auto" ], "type": "string", "description": "Known channels uses only your URLs/usernames. Find live streams uses the games and optional title keywords in Live discovery. Channel name search uses only its search terms. Inputs in other task sections are ignored. Languages and channel filters apply to every task. Combine inputs supports existing saved tasks and advanced mixed sources.", "default": "auto" }, "include": { "title": "What would you like to collect?", "minItems": 1, "type": "array", "description": "Select one or more options. Profiles include followers, social links, panels and chat settings. Live streams include current viewers, language and category; offline channels return no live row. Clips and videos return metadata and optional media URLs. Schedules are experimental. To get only one type, remove the other selected options.", "items": { "type": "string", "enum": [ "profile", "livestream", "clip", "video", "schedule" ], "enumTitles": [ "Profiles (followers, social links, bio)", "Live streams (viewers, language, category)", "Clips", "Videos (past broadcasts / VODs)", "Schedules (experimental)" ] }, "default": [ "profile", "livestream", "clip", "video" ] }, "languages": { "title": "Languages — match any selected (optional)", "maxItems": 20, "type": "array", "description": "Select Arabic, English, Turkish, or any combination. Leave empty for all languages. This filters the CURRENT live stream, including when collecting profiles, clips or videos; offline/unknown-language channels do not match. JSON/API also accepts language codes such as ar/en/tr. Regional codes can be entered explicitly, e.g. en-IN.", "items": { "type": "string", "enumSuggestedValues": [ "ar", "en", "tr", "es", "pt", "fr", "de", "ru", "af", "sq", "an", "hy", "ast", "az", "bn", "bs", "bg", "ca", "zh", "hr", "cs", "da", "nl", "en-IN", "eo", "fil", "fi", "ka", "el", "he", "hi", "hu", "id", "it", "ja", "kn", "ko", "la", "lt", "mk", "ml", "mr", "mn", "ne", "no", "fa", "pl", "qu", "ro", "gd", "sr", "sn", "si", "sk", "sl", "so", "sv", "ta", "te", "th", "uk", "ur", "vi", "zu" ], "enumTitles": [ "Arabic — العربية", "English", "Turkish — Türkçe", "Spanish — Español", "Portuguese — Português", "French — Français", "German — Deutsch", "Russian — Русский", "Afrikaans", "Albanian", "Aragonese", "Armenian", "Asturian", "Azerbaijani", "Bangla", "Bosnian", "Bulgarian", "Catalan", "Chinese", "Croatian", "Czech", "Danish", "Dutch", "English (India)", "Esperanto", "Filipino", "Finnish", "Georgian", "Greek", "Hebrew", "Hindi", "Hungarian", "Indonesian", "Italian", "Japanese", "Kannada", "Korean", "Latin", "Lithuanian", "Macedonian", "Malayalam", "Marathi", "Mongolian", "Nepali", "Norwegian", "Persian — فارسی", "Polish", "Quechua", "Romanian", "Scottish Gaelic", "Serbian", "Shona", "Sinhala", "Slovak", "Slovenian", "Somali", "Swedish", "Tamil", "Telugu", "Thai", "Ukrainian", "Urdu", "Vietnamese", "Zulu" ] }, "default": [] }, "maxChannels": { "title": "Maximum channels to check", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum distinct channels checked after discovery. Live discovery merges selected games/languages by viewer count. This is a total, not a quota per language or game. Offline changes, follower filters or unavailable data can produce fewer results.", "default": 25 }, "maxResults": { "title": "Maximum total records", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap across all profile, live, clip, VOD and schedule rows.", "default": 10000 }, "startUrls": { "title": "Kick URLs", "type": "array", "description": "Paste channel URLs such as https://kick.com/3mr. You can also use /clips, /videos, or direct content URLs. For a direct clip or video, select its data type above. Direct content URLs fetch that item and any selected profile/live data; use a channel URL for full lists. Leave empty when using usernames or discovery.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "usernames": { "title": "Kick usernames (alternative to URLs)", "maxItems": 1000, "type": "array", "description": "Enter usernames such as 3mr or xqc. Use this instead of URLs, or combine both lists. Leave empty when using only discovery.", "items": { "type": "string", "minLength": 1, "maxLength": 80 }, "default": [] }, "categories": { "title": "Games / categories — match any selected", "maxItems": 50, "type": "array", "description": "Type PUBG to choose PUBG Mobile, PUBG: Battlegrounds, or both. Choosing the custom entry pubg includes both. You can also paste a Kick category URL, use a suggested game name, or enter a category slug. Leave empty for all games. A stream must match one selected game AND one selected language. Used by Find live streams and Combine inputs.", "items": { "type": "string", "enumSuggestedValues": [ "pubg-mobile", "pubg-battlegrounds", "just-chatting", "grand-theft-auto-v", "fortnite", "minecraft", "league-of-legends", "valorant", "counter-strike-2", "dota-2", "Garena-Free-Fire", "call-of-duty-warzone", "ea-sports-fc-26", "irl", "chess" ], "enumTitles": [ "PUBG Mobile", "PUBG: Battlegrounds (PC / console)", "Just Chatting", "Grand Theft Auto V", "Fortnite", "Minecraft", "League of Legends", "VALORANT", "Counter-Strike 2", "Dota 2", "Garena Free Fire", "Call of Duty: Warzone", "EA Sports FC 26", "IRL", "Chess" ] }, "default": [] }, "liveKeywords": { "title": "Stream title contains — match any phrase (optional)", "maxItems": 20, "type": "array", "description": "Optional extra filter on current stream titles, ignoring case. Enter separate phrases such as ranked or tournament; any phrase can match. Combine with games and languages to narrow results. Leave empty to include all titles. To find all PUBG streams, select the game instead of requiring PUBG in the title. Used by Find live streams and Combine inputs; scanning stops at your page/request/time limits.", "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "default": [] }, "searchQueries": { "title": "Channel name search", "maxItems": 20, "type": "array", "description": "Find creators by channel name, for example xqc. Multiple terms add their results together. For a game such as PUBG, choose Find live streams and select the game in Live discovery. Kick exposes only a limited channel-search window.", "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "default": [] }, "maxClipsPerChannel": { "title": "Maximum clips per channel", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Used only when Clips is selected. Maximum matching clips per channel; zero skips channel clip lists. Ignored when Collect all available history is on.", "default": 100 }, "clipSort": { "title": "Sort clips by", "enum": [ "recent", "views" ], "type": "string", "description": "Used only for channel clip lists. Choose newest first or most viewed first.", "default": "recent" }, "clipRange": { "title": "Clip time window", "enum": [ "day", "week", "month", "all" ], "type": "string", "description": "Used only for channel clip lists. Kick-defined day, week, month or all-time window.", "default": "all" }, "includeClipDetails": { "title": "Include clip source-video details", "type": "boolean", "description": "Retrieve source VOD links/offsets when available. Disabling reduces requests.", "default": true }, "maxVideosPerChannel": { "title": "Maximum videos per channel", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Used only when Videos is selected. Maximum matching completed videos (VODs) per channel; zero skips channel video lists. Kick exposes a recent window, so fewer videos may be available. Ignored when Collect all available history is on.", "default": 100 }, "allAvailable": { "title": "Collect all available history", "type": "boolean", "description": "Remove per-channel clip/VOD caps while retaining total record, page, request and time limits. Does not recover deleted or inaccessible history.", "default": false }, "createdAfter": { "title": "Created on or after (UTC)", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string", "description": "Inclusive lower timestamp for clips and VODs, e.g. 2026-09-01T00:00:00Z. Unknown creation dates do not match." }, "createdBefore": { "title": "Created before (UTC)", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string", "description": "Exclusive upper timestamp for clips and VODs." }, "minViews": { "title": "Minimum content views", "minimum": 0, "maximum": 9007199254740991, "type": "integer", "description": "Clip/VOD view-count filter; unknown counts do not match." }, "includeMediaUrls": { "title": "Include available media URLs", "type": "boolean", "description": "Return HLS or direct media references where exposed. VOD details may be needed. URLs may expire; files are not downloaded.", "default": true }, "minFollowers": { "title": "Minimum channel followers", "minimum": 0, "maximum": 9007199254740991, "type": "integer", "description": "Channel follower-count filter; unknown counts do not match." }, "minViewers": { "title": "Minimum live viewers", "minimum": 0, "maximum": 9007199254740991, "type": "integer", "description": "Current live-viewer filter; offline/unknown counts do not match." }, "scheduleMonth": { "title": "Schedule month (UTC)", "pattern": "^\\d{4}-(0[1-9]|1[0-2])$", "type": "string", "description": "YYYY-MM; defaults to the current UTC month." }, "maxPagesPerSurface": { "title": "Maximum pages per list", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop paginated clip lists after this many pages per channel. In Find live streams, this page budget is shared across all selected game/language feeds, which are visited in rounds. Very narrow title filters may need more pages.", "default": 50 }, "maxRequests": { "title": "Maximum source requests", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Total source HTTP attempts, including retries.", "default": 1000 }, "maxRunSeconds": { "title": "Maximum collection time (seconds)", "minimum": 10, "maximum": 86400, "type": "integer", "description": "Stop new source work after this many seconds; finish saving already collected records.", "default": 900 }, "requestDelayMillis": { "title": "Request delay (milliseconds)", "minimum": 100, "maximum": 10000, "type": "integer", "description": "Minimum delay between source requests.", "default": 300 }, "maxRetries": { "title": "Retries per request", "minimum": 0, "maximum": 5, "type": "integer", "description": "Bounded retries for network, rate-limit and temporary source errors.", "default": 2 }, "discoverLive": { "title": "Browse live streams in combined mode", "type": "boolean", "description": "Legacy API option for Combine inputs. Find live streams enables discovery automatically. When categories are selected, browsing stays within those categories.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify/custom proxy. Disabled by default; proxy charges depend on your configuration.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }