Douyin Account collections API

List the public mixes of a Douyin author by user_id. Each row is one mix with mix_id, name, episode_count and play_count, for $0.79 per 1,000 calls.

  • mix_count gives the number of mixes the author has.
  • Pass mix_id straight to mix_posts and mix_detail.
  • 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": "user_mixes",
      "params": {
        "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "mix_id": string,
          "name": string,
          "description": string,
          "cover_image_url": string
        },
        …
      ]
    }
  3. 3Rows

    mix_idnamedescriptioncover_image_url
    stringstringstringstring
  4. 4CSV

    douyin-user_mixes-sample.csv mix_id,name,description,url,cover_image_url,author_id,author_name,episode_count,play_count,created_at,updated_at,mix_count,platform

A request with user_id goes in, and one page of that author's mixes comes back; each row in results is one mix, 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
mix_idstringDouyin collection ID (user_mixes). Pass it as mix_id to mix_posts to list the collection's videos.
namestringName of the collection (user_mixes).
descriptionstringDescription of the collection (user_mixes).
urlstringLink to the record on the platform.
cover_image_urlstringCover image URL: the cover of a video or image post on search, user_posts, posts_batch, related_posts, mix_posts, music_posts and media_links rows; the music cover on music_search and music_detail; the topic image on billboard_topic_hot; the collection cover on user_mixes; the room cover on live_room. Signed links expire.
author_idstringAuthor's unique ID on the platform.
author_namestringAuthor's display name.
episode_countnumberHow many episodes the collection has (user_mixes).
play_countnumberReal only on Hot Spot Treasure and mixes. On the boards billboard_video_hot, billboard_low_fan_explosion and billboard_high_completion it is Douyin's own play figure. On mix_posts it is the plays of that episode, and on user_mixes the plays of the whole collection. Elsewhere Douyin does not publish play counts, so the value is usually 0 and does not reflect real plays; judge reach by likes, comments and shares.
created_atstringCreation time, same format as posted_at.
updated_atstringWhen the collection was last updated (user_mixes, ISO 8601, UTC).
mix_count—How many collections the account has in all (user_mixes); the same on every row. Some accounts return fewer collections than this.
platformstringSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Use cases

  • List an author's series

    Read the name and episode_count of each mix to see how the author groups content into series and how many episodes each has.

  • Compare mix popularity

    Sort by play_count to see which mix is watched most. Here play_count is the play count of the whole mix.

  • Track mix updates

    Read updated_at and episode_count on a schedule and compare them to see whether a mix got new episodes.

  • Get the posts in a mix

    Pass mix_id to mix_posts to read the posts in a mix, or to mix_detail to read one mix.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform documentation and EveryInfra user_mixes compare on what you need to connect.

ComparedDouyin Open PlatformEveryInfra
Access you needThe documentation says that third-party developers who have applied for the user management permission and have the user's authorization can get the matching data.One EveryInfra API key in the Authorization: Bearer header. The request carries only user_id, and the author does not need to authorize anything.

The Douyin Open Platform documentation is in Chinese. The table shows a translation, checked against the page on 2026-11-22. The page shows no update date. The Open Platform API list has no endpoint that lists the mixes of an author, so this row compares only what you need to connect. Official sources: User information access solution

Limits and gotchas

  • user_id is required: the secUid of a Douyin user (it starts with MS4w) or a profile link https://www.douyin.com/user/<secUid>. A nickname, a Douyin ID and a short link are not accepted.
  • One call returns one page, and the page may hold fewer rows than usual. To get the next page, pass next_page_token back as page_token and keep the other parameters. The token is valid for 24 hours, and the last page has no next_page_token.
  • mix_count is the number of mixes the author has, and it is the same on every row. Some accounts return fewer mixes than mix_count.
  • play_count is the play count of the whole mix, and episode_count is the number of episodes in the mix.
  • cover_image_url is the mix cover. A signed cover link expires.

Pricing

You pay $0.000792 per call, not per row. One call returns one page, so each page you read counts as one call. Failed calls and empty results are not charged.

CallsCost
10,000$7.92
100,000$79.17
1,000,000$791.67

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": "user_mixes",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}'

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 user_mixes, 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 Account collections endpoint (douyin/user_mixes).

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 user_mixes, and put the parameters inside params.
- Required parameters:
  - user_id: The account whose collections you want: its secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted.
- Optional parameters:
  - page_token: Page token for user_mixes. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping user_id unchanged. Tokens last 24 hours.
- Returns a list of records. Main fields of each record: mix_id (Douyin collection ID (user_mixes)), name (Name of the collection (user_mixes)), description (Description of the collection (user_mix…), url, cover_image_url (Cover image URL: the cover of a video o…), author_id, author_name, episode_count (How many episodes the collection has (u…), play_count (Real only on Hot Spot Treasure and mixes), created_at, updated_at (When the collection was last updated (u…), mix_count (How many collections the account has in…).
- Example request body:
{
  "platform": "douyin",
  "action": "user_mixes",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}
- Price: $0.79 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.
actionbodystringYesuser_mixesCapability identifier, fixed value.
user_idbody.paramsstringYes-The account whose collections you want: its secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted.
page_tokenbody.paramsstringNo-Page token for user_mixes. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping user_id unchanged. Tokens last 24 hours; the last page has no next_page_token. A page holds up to 20 collections.

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": "user_mixes",  "results": [    {      "mix_id": …,      "name": …,      "description": …,      "url": …,      "cover_image_url": …,      "author_id": …,      "author_name": …,      "episode_count": …,      "play_count": …,      "created_at": …,      "updated_at": …,      "mix_count": …,      "platform": …    }  ],  "next_page_token": …,  "pagination": { … },  "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
mix_idDouyin collection ID (user_mixes). Pass it as mix_id to mix_posts to list the collection's videos.
nameName of the collection (user_mixes).
descriptionDescription of the collection (user_mixes).
urlLink to the record on the platform.
cover_image_urlCover image URL: the cover of a video or image post on search, user_posts, posts_batch, related_posts, mix_posts, music_posts and media_links rows; the music cover on music_search and music_detail; the topic image on billboard_topic_hot; the collection cover on user_mixes; the room cover on live_room. Signed links expire.
author_idAuthor's unique ID on the platform.
author_nameAuthor's display name.
episode_countHow many episodes the collection has (user_mixes).
play_countReal only on Hot Spot Treasure and mixes. On the boards billboard_video_hot, billboard_low_fan_explosion and billboard_high_completion it is Douyin's own play figure. On mix_posts it is the plays of that episode, and on user_mixes the plays of the whole collection. Elsewhere Douyin does not publish play counts, so the value is usually 0 and does not reflect real plays; judge reach by likes, comments and shares.
created_atCreation time, same format as posted_at.
updated_atWhen the collection was last updated (user_mixes, ISO 8601, UTC).
mix_countHow many collections the account has in all (user_mixes); the same on every row. Some accounts return fewer collections than this.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

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 mix list API return?

One row per mix: mix_id, name, description, url, cover_image_url, author_id, author_name, episode_count, play_count, created_at, updated_at and mix_count.

How do I read the posts in a mix once I have its ID?

Pass mix_id to mix_posts. To read only the mix itself, pass it to mix_detail.

How much does one page of mixes cost?

It costs $0.000792 per call, or $0.79 per 1,000 calls, billed per call and not per row. 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