Douyin

Get Douyin profile

Get a Douyin profile by user id or link, with its bio, followers, likes, video count and IP location.

GET/v1/douyin/profiles/{secUid}
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
secUidstringrequiredpath

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

Response fields
29

Endpoint-specific response payload.

datalookupStatus
string

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

dataprofileid
string

Douyin's numeric user id (`uid`), the same on every endpoint.

dataprofilesecUid
string

Douyin's public user id, as in douyin.com/user/{secUid}.

dataprofilehandle
stringnullable

Douyin id (抖音号) shown on the profile, when set.

dataprofileurl
string

Profile page.

dataprofiledisplayName
stringnullable

Display name.

dataprofilebio
stringnullable

Bio as plain text.

dataprofileavatarUrl
stringnullable

Profile picture.

dataprofilecoverUrl
stringnullable

Profile background image. Signed; it expires.

dataprofileisVerified
booleannullable

True when Douyin verified the account.

dataprofileverifiedLabel
stringnullable

What the verification says, such as `央视新闻官方账号`.

dataprofileisPrivate
booleannullable

True when the account hides its videos from people it has not approved.

dataprofileisBanned
booleannullable

True when Douyin banned the account. Douyin then shows no videos and zero counts, so `stats` is null.

dataprofileipLocation
stringnullable

The province or country Douyin shows as the account's IP location.

dataprofileage
integernullable

The age Douyin shows on the profile. Null when the creator hides it or the account has none, as brand accounts don't.

dataprofileisLive
booleannullable

True when the account is live streaming now.

Douyin's own counters; null for a banned account (`isBanned`).

dataprofilestatsfollowers
integernullable

Followers.

dataprofilestatsfollowing
integernullable

Accounts it follows.

dataprofilestatsvideos
integernullable

Public videos.

dataprofilestatslikes
integernullable

Likes its videos received.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.