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.
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 }}