{ "openapi": "3.0.1", "info": { "title": "🔥 FREE BETA: Douyin 抖音 Scraper, 20 Keywords, No-Watermark MP4", "description": "FREE BETA; no provider fee. ≤20 keywords/run; rich public creator/content/engagement data; cross-keyword dedup; eligible No-Watermark MP4 downloads optional. No Douyin login/imported cookies. Apify usage/storage/transfer fees apply. 免费测试：多词去重，可选无水印MP4。", "version": "0.1", "x-build-id": "UKcYPH0lfuc57axhh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plutonus~douyin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plutonus-douyin-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/plutonus~douyin-scraper/runs": { "post": { "operationId": "runs-sync-plutonus-douyin-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/plutonus~douyin-scraper/run-sync": { "post": { "operationId": "run-sync-plutonus-douyin-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": { "keyword": { "title": "Keyword / 单个关键词", "type": "string", "description": "One Douyin search keyword (1–128 Unicode characters, without leading or trailing whitespace). 单个抖音搜索词，1–128 个 Unicode 字符，首尾不能有空白；与 keywords 二选一。" }, "max_results": { "title": "Maximum results / 每词结果上限", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Optional ceiling of 1–2000 unique metadata results PER KEYWORD, including items also found by another keyword. Fewer results may be available. Omission sets no numeric target. Complete coverage and verified relevance/latest order are not guaranteed. 可选：每个关键词最多返回 1–2000 条去重结果，跨词重叠内容计入各词额度。留空不设数量目标；实际结果可能更少，不保证完整覆盖或相关性、最新排序。" }, "media_max_items": { "title": "Maximum MP4 downloads / 本次 MP4 上限", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Optional invocation-wide ceiling of 1–2000 selections for MP4 downloads from final canonical VIDEO results across all requested keywords. Overlap consumes the budget once. Items invalidated by final cross-keyword type resolution are not replaced. Fewer files may be available or delivered; this does not set the number of search results. Leave empty for metadata only. Media can increase run time and Apify usage, storage, and transfer costs. 可选：本次运行所有关键词合计最多选择 1–2000 个符合条件的视频，重复内容只占一次额度，最终不合格的候选不补选。实际下载可能更少；不影响搜索结果上限。留空仅取元数据。下载可能增加耗时及 Apify 运行、存储和传输费用。" }, "keywords": { "title": "Keywords / 多个关键词", "minItems": 1, "maxItems": 20, "uniqueItems": true, "type": "array", "description": "Ordered list of 1–20 exact distinct keywords. Do not supply keyword as well. Text is preserved exactly; leading/trailing whitespace and control characters are rejected. Optional media_max_items applies once across the whole list. 按顺序填写 1–20 个不重复的关键词，不要同时填写 keyword。文本原样保留；首尾空白和控制字符不允许。media_max_items 是整个列表共享的额度。", "items": { "type": "string", "minLength": 1, "maxLength": 128 } } } }, "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 } } } } } } } } } }