A Douyin account’s profile by sec_uid, profile link or share link: bio, IP location, verification, exact follower and following counts, video count and the likes its videos have received. 1 credit.

POST /user-profile Accounts

https://api.fetchlayer.dev/douyin/user-profile

OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

user string required

An account: its sec_uid (starts with MS4wLjAB), a douyin.com/user/... link, or a v.douyin.com share link to the profile.

format string optional

json or markdown, lowercase; any other value is a 400. Over MCP, markdown returns the result rendered as text; the REST API accepts it and returns JSON. (default: json)

timeoutMs integer optional

Time limit for the whole request, in milliseconds (1000–120000); a value outside that range is a 400. Where possible a partial answer comes back with a note; a request with nothing to return yet fails with a 503 you can retry, marked with the response header X-Timeout-Source: caller.

Response Fields

user-profile

Get an account’s profile

transport string

The data source: always the platform id, "douyin".

fetchedAt string

When the data was read (ISO 8601).

notes string[]

Caveats you can act on, such as older videos existing beyond the list. Empty when there are none.

profile.secUid string

The account’s sec_uid, which every account route accepts.

profile.uid string

Douyin’s numeric account id.

profile.uniqueId string

The 抖音号 (Douyin handle).

profile.nickname string

The display name.

profile.signature string

The bio.

profile.avatarUrl string

Avatar image.

profile.followerCount number

Followers, exact.

profile.followingCount number

Accounts it follows.

profile.totalLikes number

Likes its videos have received.

profile.videoCount number

Videos it has posted.

profile.ipLocation string | null

The province or country Douyin shows on the profile (IP属地), e.g. 广西.

profile.verification string | null

Douyin’s verification text, or null.

profile.isPrivate boolean

Whether the account is private.

profile.profileUrl string

Link to the profile.

Request

curl -X POST "https://api.fetchlayer.dev/douyin/user-profile" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"user":"MS4wLjABAAAAYOEVkUXnngwqKUvaFEGdZWxDxUD6cEbk7zYTJGMrqPA"}'

Response

{
  "transport": "douyin",
  "fetchedAt": "2026-10-15T15:54:17.000Z",
  "notes": [],
  "profile": {
    "secUid": "MS4wLjABAAAAYOEVkUXnngwqKUvaFEGdZWxDxUD6cEbk7zYTJGMrqPA",
    "uid": "593384953094045",
    "uniqueId": "Mom2024017",
    "nickname": "林杉导演AIGC",
    "signature": "❤️AI原创剧集《这是我的世界》持续更新中🎬",
    "followerCount": 397848,
    "followingCount": 22,
    "totalLikes": 1441789,
    "videoCount": 33,
    "ipLocation": "广西",
    "verification": null,
    "isPrivate": false,
    "profileUrl": "https://www.douyin.com/user/MS4wLjABAAAAYOEVkUXnngwqKUvaFEGdZWxDxUD6cEbk7zYTJGMrqPA"
  }
}

{
  "error": "Invalid API key"
}