Douyin Profile by numeric ID API

When you only have a numeric UID (author_uid in video and comment rows), pass it as uid to get the account's user_id, douyin_id, nickname, follower_count and video_count, for $0.56 per 1,000 calls.

  • uid is digits only.
  • The returned user_id is the secUid, ready for profile and user_posts.
  • Failed calls and empty results are not charged.

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "profile_by_id",
      "params": {
        "uid": "1929015166249580"
      }
    }
  2. 2JSON response

    {
      "results": {
        "user_id": "",
        "douyin_id": "63970939507",
        "bio": "📚英语爱好者\n🧸努力学习英语中\n❤️好好吃饭💛好好睡觉💚好好生活\n🎇文本群里分享视频的文本,有需要的小伙伴可以进群",
        "follower_count": 48149,
        …
      }
    }
  3. 3Fields

    user_iddouyin_idbiofollower_count
    63970939507📚英语爱好者 🧸努力学习英语中 ❤️好好吃饭💛好好睡觉💚好好生活 🎇文本群里分享视频的文本,有需要的小伙伴可以进群48149
  4. 4CSV

    douyin-profile_by_id-sample.csv user_id,douyin_id,nickname,bio,url,follower_count,following_count,like_count,video_count,is_verified,avatar_url,platform,uid

A request with uid goes in, and one JSON object comes back with fields such as user_id, nickname and follower_count, listed as a field table and a CSV file.

What data you get

The table shows a real call for 1929015166249580, captured November 21, 2026 at 07:17 (UTC), that returned one object; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.

user_iddouyin_idnicknamebiourlfollower_countfollowing_countlike_countvideo_countis_verifiedavatar_urlplatformuid
63970939507木•••语📚英语爱好者 🧸努力学习英语中 ❤️好好吃饭💛好好睡觉💚好好生活 🎇文本群里分享视频的文本,有需要的小伙伴可以进群https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS481492192404212falsedouyin

Use cases

  • Turn a commenter into an account you can read

    If you stored only a commenter's author_uid, pass it as uid to get the user_id, follower_count and video_count, then read the profile and videos.

  • Fill in the author of a video

    author_uid on a video row gives you the author's follower_count and video_count.

  • Keep both IDs of an account

    One account has a numeric uid and a secUid user_id. One call lets you store both in your record.

  • Check verification

    Read is_verified to see whether the account is verified.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform user management documentation and EveryInfra profile_by_id compare on reading public user information.

ComparedDouyin Open PlatformEveryInfra
Public informationThe documentation says the interface returns the public information of a Douyin user.By numeric uid, it returns nickname, bio, follower_count, following_count, like_count, video_count and is_verified.
Access termsThe documentation says that third-party developers who have applied for the user management permission and have the user's authorization can get the data.You call with an EveryInfra API key. uid comes from author_uid in video and comment rows, or from uid in a profile result.

Douyin's documentation is in Chinese. The table shows a translation of the user management page, checked on 2026-11-22. The page shows no update date. It describes the Open ID, Union ID, nickname and avatar of an authorized user. It does not describe reading a public profile by numeric UID. Official sources: User management

Limits and gotchas

  • uid is required, digits only. It comes from author_uid in video and comment rows, or from uid in a profile result.
  • The result has fewer fields than profile. For example, it has no gender and no ip_location.
  • user_id (the secUid) and uid are two IDs for the same account, so store both.
  • like_count and follower_count are snapshots from the time of the call.

Pricing

You pay $0.000556 per call. Failed calls and empty results are not charged.

CallsCost
10,000$5.56
100,000$55.56
1,000,000$555.56

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "profile_by_id",
  "params": {
    "uid": "1929015166249580"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for profile_by_id, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Douyin Profile by numeric ID endpoint (douyin/profile_by_id).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to douyin and action to profile_by_id, and put the parameters inside params.
- Required parameters:
  - uid: The account's numeric Douyin UID: the author_uid on video and comment rows, or the uid from profile.
- Returns one object. Main fields: user_id, douyin_id (Douyin ID: the searchable ID the accoun…), nickname (Display name of the account), bio, url, follower_count, following_count, like_count, video_count (Video count: the account's videos on pr…), is_verified, avatar_url, uid (Numeric user ID (profile / creator_sear…).
- Example request body:
{
  "platform": "douyin",
  "action": "profile_by_id",
  "params": {
    "uid": "1929015166249580"
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesdouyinPlatform identifier, fixed value.
actionbodystringYesprofile_by_idCapability identifier, fixed value.
uidbody.paramsstringYes-The account's numeric Douyin UID: the author_uid on video and comment rows, or the uid from profile.

Response example

#
Captured November 21, 2026 at 07:17 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "douyin",  "action": "profile_by_id",  "results": {    "user_id": "•••",    "douyin_id": "63970939507",    "nickname": "木•••语",    "bio": "📚英语爱好者\n🧸努力学习英语中\n❤️好好吃饭💛好好睡觉💚好好生活\n🎇文本群里分享视频的文本,有需要的小伙伴可以进群",    "url": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS",    "follower_count": 48149,    "following_count": 21,    "like_count": 92404,    "video_count": 212,    "is_verified": false,    "avatar_url": "https://p11.douyinpic.com/•••",    "platform": "douyin",    "uid": "•••"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
user_idUser's unique ID on the platform.
douyin_idDouyin ID: the searchable ID the account holder chooses.
nicknameDisplay name of the account.
bioProfile bio written by the account; may contain line breaks and emoji.
urlLink to the record on the platform.
follower_countFollowers. null means not disclosed, not 0.
following_countAccounts followed. null means not disclosed, not 0.
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
video_countVideo count: the account's videos on profile, profiles_batch, user_overview and billboard_account_search, videos related to the entry on trending.
is_verifiedWhether the platform verified the account. null means it cannot be determined.
avatar_urlAvatar image link. Some platforms return sized CDN links that can expire.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
uidNumeric user ID (profile / creator_search). user_id is the secUid; both identify the same account.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the profile-by-UID API return?

One account object: user_id, douyin_id, nickname, bio, url, follower_count, following_count, like_count, video_count, is_verified, avatar_url and uid.

When do I use profile_by_id and when profile?

If you have a secUid, use profile; it returns more fields. If you only have the numeric uid, use profile_by_id first to get the secUid, then continue from there.

How much does one call cost?

It costs $0.000556 per call, or $0.56 per 1,000 calls. Failed calls and empty results are not charged.

You can call the other Douyin endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy