{ "openapi": "3.0.1", "info": { "title": "Kuaishou Scraper (快手): Hot List, Videos & Comments, No Login", "description": "Scrape Kuaishou (快手) without login: the live hot list (热榜) with heat, video details (views, likes, comments, shares, caption, hashtags, duration) with the author's follower count, and comments. Optional own cookie for keyword search and creator videos (beta).", "version": "0.1", "x-build-id": "0cL7NlakwkSBbTjgx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bossless~kuaishou-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bossless-kuaishou-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/bossless~kuaishou-scraper/runs": { "post": { "operationId": "runs-sync-bossless-kuaishou-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/bossless~kuaishou-scraper/run-sync": { "post": { "operationId": "run-sync-bossless-kuaishou-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": { "hotList": { "title": "Hot list (快手热榜)", "type": "boolean", "description": "Get Kuaishou's live hot list: rank, topic, heat and its videos. Goes to the Topics dataset. When left out, it is on only if no video links, keywords or creators are given." }, "maxTopics": { "title": "Hot topics", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many hot-list topics, from the top (up to ~50).", "default": 20 }, "videosPerTopic": { "title": "Videos per hot topic", "minimum": 0, "maximum": 10, "type": "integer", "description": "Video details for each topic's videos (a topic has up to ~8). 0 = topics only.", "default": 1 }, "videoUrls": { "title": "Video links or ids", "type": "array", "description": "Kuaishou videos to scrape: kuaishou.com/short-video/… links, v.kuaishou.com share links, m.gifshow.com/fw/photo/… links, or video ids (3x… or the long number).", "items": { "type": "string" } }, "commentsPerVideo": { "title": "Comments per video", "minimum": 0, "maximum": 500, "type": "integer", "description": "Also get up to this many comments of every video. Goes to the Comments dataset. 0 = none.", "default": 0 }, "kuaishouCookie": { "title": "Your Kuaishou cookie (optional, beta)", "type": "string", "description": "Paste the Cookie header from your own logged-in kuaishou.com browser session to unlock keyword search and creator videos. Leave empty to use only the guest features. You supply and own this cookie; it is stored as secret input. Beta: not yet tested with a real account." }, "searchKeywords": { "title": "Search keywords (needs cookie, beta)", "type": "array", "description": "Videos for these search terms, e.g. 美食. Needs your cookie above.", "items": { "type": "string" } }, "creatorUrls": { "title": "Creator profiles (needs cookie, beta)", "type": "array", "description": "Latest videos of these creators: kuaishou.com/profile/… links or ids (3x…). Needs your cookie.", "items": { "type": "string" } }, "maxVideosPerSource": { "title": "Videos per search or creator", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many videos to get for each search keyword and each creator.", "default": 20 } } }, "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 } } } } } } } } } }