Douyin Profile API
Turn a Douyin profile link into structured JSON with the creator's counts.
GET /v1/douyin/profiles/{secUid}1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/douyin/profiles/MS4wLjABAAAA5LE5fb8MvFq4oU8t-ZA4ENG2fLsaSUvkWu16F9MeGkw returns data.profile: id (the numeric user id, the same on every Douyin endpoint), secUid, handle (the Douyin id), display name, bio, avatar and cover, verification and its label, ipLocation, age (null when the creator hides it), isLive, and stats for followers, following, videos and likes.
A private account returns lookupStatus: private with its profile, a banned one isBanned: true with no counts, and an id that names no account lookupStatus: not_found.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Douyin Profile API FAQ
Which id do I pass?
The id in the profile link, douyin.com/user/{secUid}, starting MS4wLjABAAAA. The whole link works too.
What is ipLocation?
The province or country Douyin shows on the profile as the account's IP location, such as 海南.
Are counts exact?
Yes. They are Douyin's own whole numbers, not the rounded 万 figures the app shows.
How many credits does a profile lookup cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.