{ "openapi": "3.0.1", "info": { "title": "Kwai Video Scraper | Vídeos do Kwai Brasil", "description": "Scrape public Kwai videos (Vídeos do Kwai) by keyword, hashtag, creator profile or link: caption, hashtags, views, likes, comments, shares, duration, post date, cover and MP4 links, creator and follower counts. No login. Pay per video.", "version": "0.1", "x-build-id": "0PaTe1kdp1bzeWzEb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~kwai-video-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-kwai-video-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/themineworks~kwai-video-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-kwai-video-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/themineworks~kwai-video-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-kwai-video-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search on Kwai, one per line, exactly as you would type them in Kwai's search box (any language; Portuguese finds the most). Each term returns Kwai's own search results. A term that starts with # is run as a hashtag.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags, one per line, with or without the #. Only videos whose caption carries the hashtag are returned and charged.", "items": { "type": "string" } }, "profiles": { "title": "Creator profiles", "type": "array", "description": "Kwai creators, one per line: a profile link (https://www.kwai.com/@handle), an @handle or a bare handle. Returns their public videos, newest first, with their follower, like and video counts on every row.", "items": { "type": "string" } }, "videoUrls": { "title": "Video links", "type": "array", "description": "Single videos, one per line: a www.kwai.com video link, a k.kwai.com/p/... share link copied from the app, or a numeric video id. A removed or private video is reported in the run summary and not charged.", "items": { "type": "string" } }, "maxVideosPerInput": { "title": "Videos per input", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Most videos to return for each search term, hashtag or profile. A profile can go back to its first video; a search stops earlier when Kwai stops returning new videos for it (often a few hundred).", "default": 50 }, "postedWithinDays": { "title": "Posted within the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only videos posted in the last N days. A profile stops being read once its videos get older. Videos given by link are always returned. Leave empty for no date filter." }, "onlyCaptionMatches": { "title": "Only videos whose caption contains the search term", "type": "boolean", "description": "Kwai's search also returns videos about the topic that do not use your words. Turn this on to keep only videos whose caption contains every word of the term (accents and case ignored). The rest are skipped and not charged.", "default": false }, "includeCreatorStats": { "title": "Add creator stats to search results", "type": "boolean", "description": "Adds the creator's follower count, total likes and number of videos to search and hashtag rows, with one small lookup per creator. Profile rows always include them.", "default": false }, "onlyNewVideos": { "title": "Only videos not delivered in an earlier run", "type": "boolean", "description": "For scheduled runs: remembers the videos this input list delivered before (up to the latest 50,000) and returns and charges only new ones.", "default": 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 } } } } } } } } } }