Douyin Profiles in bulk API

Read the public profiles of several Douyin authors at once with urls: nickname, bio, follower_count, following_count, like_count and video_count. Each item in urls is one call, at $0.56 per 1,000 calls.

  • Each item is a secUid (it starts with MS4w) or a user profile link.
  • Nicknames, Douyin IDs and short links are not accepted.
  • 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": "profiles_batch",
      "params": {
        "urls": [
          "https://www.douyin.com/user/<SEC_UID_A>",
          "<SEC_UID_B>"
        ]
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "user_id": string,
          "douyin_id": string,
          "nickname": string,
          "bio": string
        },
        …
      ]
    }
  3. 3Rows

    user_iddouyin_idnicknamebio
    stringstringstringstring
  4. 4CSV

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

A request with urls goes in, and one row per author comes back; input is the item you sent, listed as a field table and a CSV file.

What data you get

This endpoint has no public real sample yet. The table lists the fields, types and meanings that each row returns, with no values.

FieldTypeMeaning
user_idstringUser's unique ID on the platform.
douyin_idstringDouyin ID: the searchable ID the account holder chooses.
nicknamestringDisplay name of the account.
biostringProfile bio written by the account; may contain line breaks and emoji.
urlstringLink to the record on the platform.
follower_countnumberFollowers. null means not disclosed, not 0.
following_countnumberAccounts followed. null means not disclosed, not 0.
like_countnumberLikes. null means the platform or this capability does not disclose it; it is not 0.
video_countnumberVideo count: the account's videos on profile, profiles_batch, user_overview and billboard_account_search, videos related to the entry on trending.
is_verifiedbooleanWhether the platform verified the account. null means it cannot be determined.
avatar_urlstringAvatar image link. Some platforms return sized CDN links that can expire.
platformstringSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
input—The entry from urls that this row answers, returned exactly as you passed it (posts_batch, profiles_batch, media_links). Use it to match rows to your entries.

Use cases

  • Build records for a creator list

    Put the secUid values from your list into urls, read nickname, bio and douyin_id, and match rows to the list with input.

  • Refresh follower counts on a schedule

    Read follower_count every so often and subtract to see who on the list grows fastest.

  • Check verification

    Read is_verified to separate verified accounts from the rest.

  • Find the author in a share text

    When a text contains a user profile link, use resolve_links to find the secUid first, then put it into urls.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform user information access solution and EveryInfra profiles_batch compare on access.

ComparedDouyin Open PlatformEveryInfra
Whose profile you readThe documentation says the solution reads a user's public Douyin information, such as nickname and avatar, and the public nickname and avatar on Xigua and Toutiao.urls holds the secUid or profile link of each author to read, and the rows return nickname, bio, follower_count, video_count and more. The authors do not have to authorize anything.
Access you needThe documentation says the data is available to third-party developers who have completed the permission application, when the user has authorized it.One EveryInfra API key in the Authorization: Bearer header. You apply for no user management permission.

The Douyin Open Platform documentation is in Chinese; the table shows a translation, checked against its user information access solution on 2026-11-22. The page shows no update date. The documentation has no description of reading any public author profiles in a batch, so this table compares whose profile you read and the access you need. Official sources: User information access solution

Limits and gotchas

  • urls is an array; the parameter reference says how many items one call takes; the same item can appear only once.
  • Each item must be a secUid (it starts with MS4w) or a user profile link, https://www.douyin.com/user/<secUid>; nicknames, Douyin IDs and short links are not accepted.
  • Billing is per item, one call each; items that could not be read are not charged and are listed in missed in the response.
  • follower_count, video_count and the other counts are the values at the moment of the read.
  • Synchronous calls only.

Pricing

Each item in urls counts as one call at $0.000556, so you pay by the number of items and not per field; items that could not be read are not charged. 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": "profiles_batch",
  "params": {
    "urls": [
      "https://www.douyin.com/user/<SEC_UID_A>",
      "<SEC_UID_B>"
    ]
  }
}'

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 profiles_batch, 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 Profiles in bulk endpoint (douyin/profiles_batch).

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 profiles_batch, and put the parameters inside params.
- Required parameters:
  - urls: The accounts to read, as an array of up to 20 entries; each entry can appear only once. Each entry is a secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>.
- Optional parameters:
  - limit: The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.
- Returns a list of records. Main fields of each record: 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, input (The entry from urls that this row answe…).
- Example request body:
{
  "platform": "douyin",
  "action": "profiles_batch",
  "params": {
    "urls": [
      "https://www.douyin.com/user/<SEC_UID_A>",
      "<SEC_UID_B>"
    ]
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- This endpoint runs synchronously only; do not add "mode": "async" to the body.
- 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.
actionbodystringYesprofiles_batchCapability identifier, fixed value.
urlsbody.paramsarrayYes-The accounts to read, as an array of up to 20 entries; each entry can appear only once. Each entry is a secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted. Billed per account; accounts not found are not charged. Rows carry input, the entry you passed.
limitbody.paramsinteger (1–)No-The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.

Response example

#
No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.
json
{  "id": "req_…",  "platform": "douyin",  "action": "profiles_batch",  "results": [    {      "user_id": …,      "douyin_id": …,      "nickname": …,      "bio": …,      "url": …,      "follower_count": …,      "following_count": …,      "like_count": …,      "video_count": …,      "is_verified": …,      "avatar_url": …,      "platform": …,      "input": …    }  ],  "count": …,  "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).
inputThe entry from urls that this row answers, returned exactly as you passed it (posts_batch, profiles_batch, media_links). Use it to match rows to your entries.

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 Douyin batch profiles API return?

One row for each author that was read: user_id, douyin_id, nickname, bio, url, follower_count, following_count, like_count, video_count, is_verified and avatar_url, plus input.

Can I use it if I only have a Douyin ID or a nickname?

No. This endpoint takes only a secUid or a user profile link, not a nickname, a Douyin ID or a short link.

How do I get a secUid from a share text?

Use resolve_links first. When the text contains a user profile link, it recognizes the user, and resource_id is the secUid.

How is a batch of profiles billed?

Each item in urls is one call at $0.000556, 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