Get Douyin profile
Get a Douyin profile by user id or link, with its bio, followers, likes, video count and IP location.
Headers
Get your API keyAPI key (`sfk_...`)
Douyin's public user id from the profile link, as in douyin.com/user/{secUid}, for example `MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw`. A full profile link or a v.douyin.com short link also works.
min 1 chars · max 512 chars
Endpoint-specific response payload.
`private` when the account is private: the profile is returned, but Douyin shows logged-out visitors none of its videos. `not_found` when no account has this id.
one of: found, private, not_found
The account when `lookupStatus` is `found` or `private`; null when `not_found`.
Douyin's numeric user id (`uid`), the same on every endpoint.
Douyin's public user id, as in douyin.com/user/{secUid}.
Douyin id (抖音号) shown on the profile, when set.
Profile page.
Display name.
Bio as plain text.
Profile picture.
Profile background image. Signed; it expires.
True when Douyin verified the account.
What the verification says, such as `央视新闻官方账号`.
True when the account hides its videos from people it has not approved.
True when Douyin banned the account. Douyin then shows no videos and zero counts, so `stats` is null.
The province or country Douyin shows as the account's IP location.
The age Douyin shows on the profile. Null when the creator hides it or the account has none, as brand accounts don't.
True when the account is live streaming now.
Douyin's own counters; null for a banned account (`isBanned`).
Followers.
Accounts it follows.
Public videos.
Likes its videos received.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/douyin/profiles/MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw" \
-H "x-api-key: YOUR_API_KEY"Responses
A Douyin profile.