{ "openapi": "3.0.1", "info": { "title": "Douyin 抖音 Profile Scraper - 博主 Followers, Posts & Hashtags", "description": "Scrape public Douyin (抖音) creator profiles without login or cookies. Get followers, bio, verification, posts, hashtags, music and engagement from profile links, share links or IDs. Bulk 25 creators, date filters, clean JSON for analytics, influencer research and AI.", "version": "1.0", "x-build-id": "tBo6czzuXMYiPVGfk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_wiki~douyin-profile-scraper-followers-posts-hashtags/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_wiki-douyin-profile-scraper-followers-posts-hashtags", "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/data_wiki~douyin-profile-scraper-followers-posts-hashtags/runs": { "post": { "operationId": "runs-sync-data_wiki-douyin-profile-scraper-followers-posts-hashtags", "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/data_wiki~douyin-profile-scraper-followers-posts-hashtags/run-sync": { "post": { "operationId": "run-sync-data_wiki-douyin-profile-scraper-followers-posts-hashtags", "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": [ "urls" ], "properties": { "urls": { "title": "🔗 Creator profile links or IDs", "minItems": 1, "maxItems": 25, "type": "array", "description": "One entry per line, up to 25. Accepted: www.douyin.com/user/ links, v.douyin.com share links (or the whole share text copied from the app), www.iesdouyin.com/share/user links, bare secUid values (MS4wLj...) and bare numeric user IDs. Mixed formats are fine.", "items": { "type": "string" } }, "maxPostsPerProfile": { "title": "🎬 Posts per profile", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Most posts to collect from each creator (0 to 10000). Set 0 to get only the creator's profile data, one row per creator. Douyin may show visitors only part of a creator's posts.", "default": 10 }, "recentDays": { "title": "⏰ Only the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Keep only posts published in the last N days (1 to 3650). Leave empty for no limit. If you also set an oldest post date, this one wins." }, "oldestPostDate": { "title": "📅 Oldest post date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Keep only posts published on or after this date (YYYY-MM-DD, China time). Leave empty for no limit." }, "excludePinnedPosts": { "title": "📌 Skip pinned posts", "type": "boolean", "description": "Leave out the posts a creator pinned to the top of their profile.", "default": false }, "includeCollections": { "title": "📚 Add posts from collections", "type": "boolean", "description": "When Douyin shows only the newest posts, also read the creator's public collections (合集) to find more posts. Posts already found are not repeated.", "default": true }, "maxRetries": { "title": "🔁 Retries per request", "minimum": 1, "maximum": 10, "type": "integer", "description": "How often a failed or blocked request is retried before giving up (1 to 10). Also the number of tries with a new connection when requests keep failing.", "default": 3 }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Choose how requests are routed. If a request is blocked, the Actor switches to another connection automatically.", "default": { "useApifyProxy": 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 } } } } } } } } } }