Douyin profile
Profile header + publication metrics for a Douyin (抖音) user.
Provide exactly one of sec_uid (the canonical MS4w… id from a
douyin.com/user/<sec_uid> or m.douyin.com/share/user/<sec_uid> link) or url
(any douyin.com / iesdouyin.com profile URL containing one). Returns
profile_info only (no post feed): identity, follower/following/post counts,
verification, avatar, and lifetime likes received (total_favorited).
NOTE: a bare 抖音号/handle is NOT a sec_uid and is not accepted (resolving it
needs Douyin's signed search API). Follower/following/favoriting counts are
coarsened by Douyin's public share surface (see counts_are_approximate);
post_count and total_favorited are exact.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 6.7s.
Authorization
ApiKeyAuth Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/douyin-profile" \ -H "Content-Type: application/json" \ -d '{ "sec_uid": "MS4wLjABAAAA4betsiKnGaXpGn50xzBdpIx4qqgCo644b_lzlxHWppk" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "profile_info": { "avatar": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813_oknuAKfBDE1Ue00AWycJAhzmMCGAFiQAiAA0Ig.jpeg?from=2956013662", "avatar_thumb": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813_oknuAKfBDE1Ue00AWycJAhzmMCGAFiQAiAA0Ig.jpeg?from=2956013662", "counts_are_approximate": true, "custom_verify": null, "description": "希望你天天开心❤️\n搬砖兄弟：@星河悬太清 男……男大？\n开播：@公瑾象棋", "enterprise_verify_reason": null, "favoriting_count": 0, "follower_count": 3000, "following_count": 100, "nickname": "Aala", "original_music_count": 0, "original_music_used_count": 0, "post_count": 34, "profile_url": "https://www.douyin.com/user/MS4wLjABAAAA4betsiKnGaXpGn50xzBdpIx4qqgCo644b_lzlxHWppk", "sec_uid": "MS4wLjABAAAA4betsiKnGaXpGn50xzBdpIx4qqgCo644b_lzlxHWppk", "short_id": null, "show_favorite_list": false, "total_favorited": 609731, "unique_id": "65581209652", "user_id": "MS4wLjABAAAA4betsiKnGaXpGn50xzBdpIx4qqgCo644b_lzlxHWppk", "verification_type": 0, "verified": false } } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "douyin-profile", "billable": true, "duration_ms": 6136 }}