{ "openapi": "3.0.1", "info": { "title": "Douyin 抖音用户主页 Profile Scraper - Followers & Likes", "description": "抖音用户主页 of any public Douyin (抖音) account: Douyin ID, nickname, bio, followers, following, total likes, post count and IP region, as exact numbers rather than the rounded 万 the page shows. No login. An account that could not be read says so with the reason, never as an empty account.", "version": "0.0", "x-build-id": "CJemeB8bPfNQA2far" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lanternlab318~douyin-profile/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lanternlab318-douyin-profile", "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/lanternlab318~douyin-profile/runs": { "post": { "operationId": "runs-sync-lanternlab318-douyin-profile", "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/lanternlab318~douyin-profile/run-sync": { "post": { "operationId": "run-sync-lanternlab318-douyin-profile", "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": [ "profileUrls" ], "properties": { "profileUrls": { "title": "Douyin profiles", "type": "array", "description": "Public Douyin accounts, one per line: a profile link (https://www.douyin.com/user/MS4w...), a share link (https://v.douyin.com/...), a link carrying sec_uid=..., or the bare sec_uid. A numeric user ID is not enough - Douyin's web API only answers by sec_uid, which every profile link contains. Account search is not supported.", "items": { "type": "string" } }, "maxUpstreamRequests": { "title": "Max Douyin requests per run", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Hard ceiling on requests sent to Douyin in this run, retries included. Leave it empty and the Actor works one out from the number of accounts you gave it, so a run is never unbounded; 0 sends no request at all. RUN_SUMMARY reports which ceiling was in force." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for all requests. Off by default: Douyin answers guests without a proxy.", "default": { "useApifyProxy": false } }, "residentialFallback": { "title": "Retry refused accounts through a residential proxy", "type": "boolean", "description": "When Douyin refuses the request for an account (captcha, empty answer, block status), retry that account once through an Apify residential proxy exiting in China. Residential traffic costs more than direct requests. An account Douyin does answer about - gone, renamed away, withheld - is never retried: no exit changes that answer.", "default": true }, "maxFallbackProfiles": { "title": "Max accounts retried through the residential proxy", "minimum": 0, "maximum": 10, "type": "integer", "description": "Upper limit per run on accounts moved to the residential proxy. 0 turns the fallback off.", "default": 3 }, "requestDelaySecs": { "title": "Delay between requests (seconds)", "minimum": 0.2, "maximum": 30, "type": "number", "description": "Minimum pause between two requests from the same guest identity.", "default": 1 }, "maxIdentityRotations": { "title": "Max guest identities per run", "minimum": 0, "maximum": 30, "type": "integer", "description": "How many times a refused request may be retried on a freshly minted guest identity before the account is reported as blocked.", "default": 6 }, "msTokenWaitSecs": { "title": "Wait for the page's security token (seconds)", "minimum": 0, "maximum": 180, "type": "integer", "description": "How long a new guest page may take to receive its security token (msToken) before requests start. Longer waits make requests more likely to be answered.", "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 } } } } } } } } } }