# Douyin Scraper \[Only $3] Video, Profile & Comments Data (`memo23/douyin-scraper`) Actor \[Only $3 per 1000 results] Scrape Douyin (抖音, China's TikTok) — no login, no browser. Extract full video detail (likes, shares, collects, comments, author, music, hashtags, download URLs), creator profiles, and comments. Clean unified JSON. - **URL**: https://apify.com/memo23/douyin-scraper.md - **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community) - **Categories:** Social media, Videos, AI - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Douyin Scraper — Video, Profile & Comments Data Extract structured data from **Douyin (抖音)** — China's original TikTok, with ~750M daily users — without a login, browser, or manual cookies. Paste video or creator URLs and get back clean JSON: full video metrics, creator profiles, and comment threads. Great for **market research, influencer discovery, trend tracking, brand monitoring, and competitive analysis** on the Chinese short-video market. ![How the Douyin Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-douyin.png) --- ### What it does | Mode | Input | You get | |------|-------|---------| | 🎬 **Video detail** | a video URL | Full post: likes, shares, collects, comment count, author, music, hashtags, cover, video & download URLs, dimensions | | 👤 **Creator profile** | a user URL | Followers, following, total likes, video count, bio, verification, avatar, IP region | | 💬 **Comments** | a video URL + toggle | Comment text, likes, reply counts, commenter, IP region | | 🔎 **Keyword search** | keywords *(needs cookie)* | Videos matching a search term | | 📹 **Creator's videos** | a user URL *(needs cookie)* | A creator's full posted catalog | Videos, profiles, and comments work **out of the box — no account needed**. Keyword search and full creator catalogs require a logged-in cookie (see FAQ). --- ### Input | Field | Type | Description | |-------|------|-------------| | `startUrls` | array | Douyin video URLs, creator-profile URLs, short `v.douyin.com` links, or bare IDs. Video URLs → post detail; user URLs → profile. | | `includeComments` | boolean | For each video URL, also scrape its comments. | | `maxComments` | integer | Max comments per video (default 50). | | `includeUserPosts` | boolean | For each creator URL, also scrape their posted videos *(requires `douyinCookie`)*. | | `maxUserPosts` | integer | Max videos per creator (default 30). | | `searchKeywords` | array | Keyword video search *(requires `douyinCookie`)*. | | `maxResultsPerSearch` | integer | Max results per keyword (default 30). | | `douyinCookie` | string | Optional logged-in cookie to unlock search + creator catalogs. | | `maxItems` | integer | Global cap on total results. | | `proxyConfiguration` | object | Optional. A residential proxy is built in — leave this off unless you want to use your own. | #### Example input ```json { "startUrls": [ { "url": "https://www.douyin.com/video/7615930241370348219" }, { "url": "https://www.douyin.com/user/MS4wLjABAAAAUT_tvNpyI5-tObkvU2xaaqyeDpek5UJXLG8mePjYxTQ" } ], "includeComments": true, "maxComments": 100, "maxItems": 500 } ```` *** ### Output Every row carries a `type` field (`video`, `user`, or `comment`) so you can filter mixed runs. #### Video ```json { "type": "video", "awemeId": "7615930241370348219", "url": "https://www.douyin.com/video/7615930241370348219", "isImagePost": false, "description": "夜宵简单吃个长沙滋啦冒油的炭烤牛肋排… #长沙美食", "createTime": "2026-03-11T09:39:01.000Z", "duration": 12600, "hashtags": ["饭搭子", "深夜放毒", "寻味烟火气", "长沙美食"], "likes": 139023, "comments": 11025, "shares": 598443, "collects": 13776, "authorName": "章章干嘛呢", "authorSecUid": "MS4wLjABAAAAUT_tvNpyI5-tObkvU2xaaqyeDpek5UJXLG8mePjYxTQ", "authorFollowers": 62679, "coverUrl": "https://...", "videoUrls": ["https://...", "..."], "downloadUrls": ["https://...", "..."], "width": 1080, "height": 1920, "musicTitle": "@章章干嘛呢创作的原声", "shareUrl": "https://..." } ``` #### Creator profile ```json { "type": "user", "secUid": "MS4wLjABAAAA...", "nickname": "章章干嘛呢", "uniqueId": "6346717", "signature": "在我喜欢的状态里记录我喜欢的生活🤳 美食｜看展｜旅游", "verified": false, "followers": 49659, "following": 304, "totalLikes": 5130107, "videoCount": 370, "avatarUrl": "https://...", "ipLocation": "湖南", "url": "https://www.douyin.com/user/MS4wLjABAAAA..." } ``` #### Comment ```json { "type": "comment", "awemeId": "7615930241370348219", "commentId": "7615932448664650533", "text": "已观，饿之，邀好友观之，共难受之。", "createTime": "2026-03-11T09:47:36.000Z", "likes": 2970, "replyCount": 1161, "ipLocation": "湖南", "userName": "yuki小蛋堡🍔", "userSecUid": "MS4wLjABAAAA...", "userUrl": "https://www.douyin.com/user/MS4wLjABAAAA..." } ``` *** ### Use cases - **Influencer & KOL discovery** — pull follower counts, engagement, and bios to build creator shortlists for the China market. - **Trend & hashtag tracking** — monitor how videos and topics accumulate likes, shares, and comments over time. - **Brand & sentiment monitoring** — collect comment threads on videos mentioning your brand or product. - **Competitive analysis** — benchmark competitors' creator accounts and content performance. - **Content research** — gather hashtags, music, and formats that perform in a niche. *** ### FAQ **Do I need a Douyin account?** No — videos, creator profiles, and comments work with no login. Only keyword *search* and pulling a creator's *full video catalog* need a cookie. **How do I get the cookie?** Log in to `douyin.com` in your browser, open DevTools → Network, click any `douyin.com` request, and copy the full `Cookie` request header into the `douyinCookie` field. **Do I need to set up a proxy?** No. A residential proxy is built in so the actor works out of the box. You can supply your own proxy if you prefer. **What time zone are the dates?** All `createTime` values are ISO 8601 UTC. **Can I get the raw video / image files?** The output includes direct `videoUrls` / `downloadUrls` / `coverUrl` / `images` links you can download from. *** ### Support Found a missing field or a URL format that isn't recognized? Open an issue on the actor's **Issues** tab with an example URL and it'll be added. # Actor input Schema ## `startUrls` (type: `array`): Douyin video URLs, user-profile URLs, short v.douyin.com links, or bare IDs. Video URLs return full post detail; user URLs return the profile. ## `includeComments` (type: `boolean`): For each video URL, also scrape its comments (each comment becomes its own row). ## `maxComments` (type: `integer`): Upper bound on comments collected per video when 'Include comments' is on. ## `includeUserPosts` (type: `boolean`): For each user-profile URL, also scrape the creator's posted videos. Requires a logged-in cookie (see 'Douyin cookie'). ## `maxUserPosts` (type: `integer`): Upper bound on videos collected per creator when 'Include user's videos' is on. ## `searchKeywords` (type: `array`): Keyword video search. Requires a logged-in cookie (see 'Douyin cookie'). ## `maxResultsPerSearch` (type: `integer`): Upper bound on videos collected per search keyword. ## `douyinCookie` (type: `string`): Paste a logged-in douyin.com cookie string to unlock user-videos and keyword search. Get it from your browser DevTools (Network tab → any douyin.com request → Cookie header) while logged in. Videos, profiles and comments work without it. ## `maxItems` (type: `integer`): Global cap on the number of dataset items across the entire run. Leave empty for no cap. ## `proxyConfiguration` (type: `object`): Optional proxy. Douyin's web API works direct from most regions; enable residential proxy only if you hit blocks. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.douyin.com/video/7615930241370348219" }, { "url": "https://www.douyin.com/user/MS4wLjABAAAAUT_tvNpyI5-tObkvU2xaaqyeDpek5UJXLG8mePjYxTQ" } ], "includeComments": false, "maxComments": 50, "includeUserPosts": false, "maxUserPosts": 30, "searchKeywords": [], "maxResultsPerSearch": 30, "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.douyin.com/video/7615930241370348219" }, { "url": "https://www.douyin.com/user/MS4wLjABAAAAUT_tvNpyI5-tObkvU2xaaqyeDpek5UJXLG8mePjYxTQ" } ], "searchKeywords": [] }; // Run the Actor and wait for it to finish const run = await client.actor("memo23/douyin-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [ { "url": "https://www.douyin.com/video/7615930241370348219" }, { "url": "https://www.douyin.com/user/MS4wLjABAAAAUT_tvNpyI5-tObkvU2xaaqyeDpek5UJXLG8mePjYxTQ" }, ], "searchKeywords": [], } # Run the Actor and wait for it to finish run = client.actor("memo23/douyin-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.douyin.com/video/7615930241370348219" }, { "url": "https://www.douyin.com/user/MS4wLjABAAAAUT_tvNpyI5-tObkvU2xaaqyeDpek5UJXLG8mePjYxTQ" } ], "searchKeywords": [] }' | apify call memo23/douyin-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=memo23/douyin-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Douyin Scraper [Only $3] Video, Profile & Comments Data", "description": "[Only $3 per 1000 results] Scrape Douyin (抖音, China's TikTok) — no login, no browser. Extract full video detail (likes, shares, collects, comments, author, music, hashtags, download URLs), creator profiles, and comments. Clean unified JSON.", "version": "0.0", "x-build-id": "wJAJdTW5182UbJJpE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~douyin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~douyin-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~douyin-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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": { "startUrls": { "title": "Douyin URLs", "type": "array", "description": "Douyin video URLs, user-profile URLs, short v.douyin.com links, or bare IDs. Video URLs return full post detail; user URLs return the profile.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "For each video URL, also scrape its comments (each comment becomes its own row).", "default": false }, "maxComments": { "title": "Max comments per video", "minimum": 1, "type": "integer", "description": "Upper bound on comments collected per video when 'Include comments' is on.", "default": 50 }, "includeUserPosts": { "title": "Include user's videos", "type": "boolean", "description": "For each user-profile URL, also scrape the creator's posted videos. Requires a logged-in cookie (see 'Douyin cookie').", "default": false }, "maxUserPosts": { "title": "Max videos per user", "minimum": 1, "type": "integer", "description": "Upper bound on videos collected per creator when 'Include user's videos' is on.", "default": 30 }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "Keyword video search. Requires a logged-in cookie (see 'Douyin cookie').", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max results per keyword", "minimum": 1, "type": "integer", "description": "Upper bound on videos collected per search keyword.", "default": 30 }, "douyinCookie": { "title": "Douyin cookie (optional)", "type": "string", "description": "Paste a logged-in douyin.com cookie string to unlock user-videos and keyword search. Get it from your browser DevTools (Network tab → any douyin.com request → Cookie header) while logged in. Videos, profiles and comments work without it." }, "maxItems": { "title": "Max items (total)", "minimum": 1, "type": "integer", "description": "Global cap on the number of dataset items across the entire run. Leave empty for no cap." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. Douyin's web API works direct from most regions; enable residential proxy only if you hit blocks.", "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 } } }, "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 } } } } } } } } } } ```