{ "openapi": "3.0.1", "info": { "title": "Kuaishou Scraper 快手 [From $1] Videos, Comments & Hot Lists", "description": "[From $1 per 1000 results] Kuaishou (快手) scraper with no login: search videos by keyword, get views, likes, shares and collects, comments with replies, creator profiles with followers, a creator's videos, creator search and the live hot boards. Videos $3, comments $2 per 1,000.", "version": "0.1", "x-build-id": "QAtexAemlvM0hcYjV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~kuaishou-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~kuaishou-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~kuaishou-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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": { "keywords": { "title": "Search keywords", "type": "array", "description": "Keywords to search videos for. Chinese, English and brand names all work. Each keyword is searched on its own and a video found by two keywords is returned once.", "items": { "type": "string" } }, "videoUrls": { "title": "Video links", "type": "array", "description": "Video links (`https://www.kuaishou.com/short-video/3xwj3denedfszne`), share links (`https://v.kuaishou.com/…`) or video ids. Each returns the full video row.", "items": { "type": "string" } }, "creators": { "title": "Creators", "type": "array", "description": "Creator profile links (`https://www.kuaishou.com/profile/3xgevw3ryternmi`) or ids. Returns the creator's videos; turn on 'Creator profile' for followers and the rest of the profile.", "items": { "type": "string" } }, "creatorKeywords": { "title": "Creator search keywords", "type": "array", "description": "Find creators by name or topic. Each result is a `creator` row with name, handle, followers and video count. Billed as `creator-search-result`.", "items": { "type": "string" } }, "hotBoards": { "title": "Hot boards", "uniqueItems": true, "type": "array", "description": "Kuaishou's live hot boards, about 50 ranked terms each with heat values. Billed as `hot-search-term`.", "items": { "type": "string", "enum": [ "hot", "entertainment", "society", "useful" ], "enumTitles": [ "Hot (热榜)", "Entertainment (文娱榜)", "Society (社会榜)", "Useful (有用榜)" ] } }, "rankings": { "title": "Rankings", "uniqueItems": true, "type": "array", "description": "Kuaishou's rankings, 50 entries per tab, as `ranking-row` rows with rank, heat value and the creator or live room behind each entry.", "items": { "type": "string", "enum": [ "liveTop", "shoppingTop", "brandTop", "hotPeople", "music" ], "enumTitles": [ "Live top list (直播榜)", "Shopping top list (购物榜)", "Brand top list (品牌榜)", "Hot people (热搜人物榜)", "Music ranking (音乐榜)" ] } }, "rankingCategories": { "title": "Ranking categories", "type": "array", "description": "Tab names in Chinese, for rankings that have tabs. Live: `音乐`, `舞蹈`, `颜值`, `游戏`, `二次元`. Brand: `美妆`, `服饰`, `汽车`, `游戏`, `3C数码`, `手机`, `家电`, `母婴`, `食品饮料`. Shopping: `热门主播`, `热销商品`. Empty returns each ranking's main tab.", "items": { "type": "string" } }, "liveKeywords": { "title": "Live room search keywords", "type": "array", "description": "Find live rooms that are on air right now. Each result is a `live-room` row with title, viewers, likes and the creator.", "items": { "type": "string" } }, "tagKeywords": { "title": "Hashtag search keywords", "type": "array", "description": "Find hashtags by keyword. Each result is a `tag` row with its video count and plays.", "items": { "type": "string" } }, "musicKeywords": { "title": "Music search keywords", "type": "array", "description": "Find songs and sounds by keyword. Each result is a `music` row with artist, duration, audio link and how many videos use it.", "items": { "type": "string" } }, "maxResultsPerKeyword": { "title": "Max videos per keyword", "minimum": 1, "type": "integer", "description": "Upper bound on videos collected per search keyword. About 20 arrive per page.", "default": 50 }, "includeCreatorProfile": { "title": "Creator profile", "type": "boolean", "description": "For each entry in Creators, add a `creator` row: followers, following, video count, total likes, verification, bio, location, schools and whether they are live right now. Billed as `creator-profile`.", "default": false }, "includeCreatorVideos": { "title": "Creator videos", "type": "boolean", "description": "For each entry in Creators, return their videos.", "default": true }, "creatorVideoOrder": { "title": "Creator videos order", "enum": [ "latest", "popular" ], "type": "string", "description": "Which of a creator's videos come first.", "default": "latest" }, "maxVideosPerCreator": { "title": "Max videos per creator", "minimum": 1, "type": "integer", "description": "Upper bound on videos collected per creator.", "default": 40 }, "maxCreatorsPerKeyword": { "title": "Max creators per keyword", "minimum": 1, "type": "integer", "description": "Upper bound on creators collected per creator-search keyword.", "default": 20 }, "maxLiveRoomsPerKeyword": { "title": "Max live rooms per keyword", "minimum": 1, "type": "integer", "description": "Upper bound on live rooms per live-search keyword. About 10 arrive per page.", "default": 20 }, "maxTagsPerKeyword": { "title": "Max hashtags per keyword", "minimum": 1, "type": "integer", "description": "Upper bound on hashtags per hashtag-search keyword.", "default": 10 }, "maxMusicPerKeyword": { "title": "Max songs per keyword", "minimum": 1, "type": "integer", "description": "Upper bound on songs per music-search keyword.", "default": 40 }, "maxItemsPerRanking": { "title": "Max rows per ranking tab", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper bound on rows per ranking tab. Tabs hold 50 entries; the music ranking goes further.", "default": 50 }, "includeComments": { "title": "Comments", "type": "boolean", "description": "For every video in the run, also return its comments as `comment` rows (about 30 per page).", "default": false }, "maxCommentsPerVideo": { "title": "Max comments per video", "minimum": 1, "type": "integer", "description": "Upper bound on comments collected per video.", "default": 30 }, "includeReplies": { "title": "Replies", "type": "boolean", "description": "With comments on, also return the replies under each comment as `reply` rows linked by `parentCommentId`. Billed as `comment`.", "default": false }, "maxRepliesPerComment": { "title": "Max replies per comment", "minimum": 1, "type": "integer", "description": "Upper bound on replies collected under one comment.", "default": 10 }, "maxItems": { "title": "Max videos per run", "minimum": 1, "type": "integer", "description": "Cap on video rows across the whole run. Comments, creators and hot terms have their own limits. Free-plan runs return up to 100 videos.", "default": 100 } } }, "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 } } } } } } } } } }