{ "openapi": "3.0.1", "info": { "title": "Douyin Video Scraper: Stats, Top Comments, Related Videos", "description": "Scrape Douyin (抖音) videos from their links: likes, comments, shares, saves, caption, hashtags, author and follower count, music, plus the first 5 comments and up to 10 related videos per page, each related video a full row. Read from public pages in a real browser. No login, no cookies.", "version": "0.1", "x-build-id": "wD7GxJ3uII6mtU2Lt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~douyin-video-stats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-douyin-video-stats-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~douyin-video-stats-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-douyin-video-stats-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~douyin-video-stats-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-douyin-video-stats-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", "required": [ "videoUrls" ], "properties": { "videoUrls": { "title": "Douyin video links or ids", "type": "array", "description": "One per line. Accepted: https://www.douyin.com/video/, https://www.douyin.com/note/, any douyin.com link with ?modal_id=, https://www.iesdouyin.com/share/video//, v.douyin.com short links, the app's share text with a link inside, or a bare 19 digit video id. Creator profile links are skipped: Douyin does not show a creator's video list to a visitor who is not logged in.", "items": { "type": "string" } }, "includeTopComments": { "title": "Include the first comments", "type": "boolean", "description": "Adds the first 5 comments Douyin shows on each of your videos (text, likes, replies, date, province). Douyin shows more only to logged in users, so 5 is the most a visitor sees.", "default": true }, "maxRelatedPerVideo": { "title": "Related videos per page", "minimum": 5, "maximum": 10, "type": "integer", "description": "Related videos delivered for each video page opened, from Douyin's own related list (it shows 10). Each one is a full row with stats. At least 5.", "default": 10 }, "relatedDepth": { "title": "Follow related videos (depth)", "minimum": 0, "maximum": 2, "type": "integer", "description": "0 opens only your videos. 1 also opens the pages of the related videos found, to collect their related videos too. 2 goes one step further. Use it to grow a list of videos around a topic from a few seed videos.", "default": 0 }, "maxResults": { "title": "Max rows", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Stops after this many video rows (your videos plus related videos). 0 means up to 10,000.", "default": 100 }, "monitorMode": { "title": "Monitor mode (only new related videos)", "type": "boolean", "description": "On repeat runs, skips related videos this actor already delivered to you in an earlier run, so you pay only for new ones. Your own videos are always delivered with fresh stats.", "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 } } } } } } } } } }