API de Colecciones de una cuenta de Douyin

Lista las colecciones públicas de un autor de Douyin con user_id. Cada fila es una colección con mix_id, name, episode_count y play_count, a $0.79 por cada 1000 llamadas.

  • mix_count indica cuántas colecciones tiene el autor.
  • Pasa mix_id directamente a mix_posts y mix_detail.
  • Las llamadas fallidas y los resultados vacíos no se cobran.

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "user_mixes",
      "params": {
        "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
      }
    }
  2. 2Respuesta JSON

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

    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

Entra una solicitud con user_id y sale una página de colecciones de ese autor; cada fila de results es una colección, y se muestra como tabla de campos y se puede descargar en CSV.

Qué datos obtienes

Este endpoint aún no tiene una muestra real pública. La tabla lista los campos, tipos y significados que devuelve cada fila, sin valores.

CampoTipoSignificado
mix_idstringID de la colección de Douyin (user_mixes). Envíalo como mix_id a mix_posts para listar los vídeos de la colección.
namestringNombre de la colección (user_mixes).
descriptionstringDescripción de la colección (user_mixes).
urlstringEnlace al registro en la plataforma.
cover_image_urlstringURL de la imagen de portada: la portada de un vídeo o nota en las filas de search, user_posts, posts_batch, related_posts, mix_posts, music_posts y media_links; la portada de la música en music_search y music_detail; la imagen del tema en billboard_topic_hot; la portada de la colección en user_mixes; la portada de la sala en live_room. Los enlaces firmados caducan.
author_idstringIdentificador único del autor en la plataforma.
author_namestringNombre visible del autor.
episode_countnumberCuántos episodios tiene la colección (user_mixes).
play_countnumberReal solo en Hot Spot Treasure y mixes. En billboard_video_hot, billboard_low_fan_explosion y billboard_high_completion es la cifra propia de Douyin. En mix_posts son las reproducciones de ese episodio y en user_mixes las de toda la colección. En las demás acciones Douyin no publica reproducciones y el valor suele ser 0, no real; mide el alcance con me gusta, comentarios y compartidos.
created_atstringFecha de creación, con el mismo formato que posted_at.
updated_atstringCuándo se actualizó la colección por última vez (user_mixes, ISO 8601, UTC).
mix_count—Cuántas colecciones tiene la cuenta en total (user_mixes); igual en todas las filas. En algunas cuentas recibes menos colecciones que esta cifra.
platformstringIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Casos de uso

  • Repasar las series de un autor

    Lee name y episode_count de cada colección para ver cómo agrupa el autor su contenido en series y cuántos episodios tiene cada una.

  • Comparar la popularidad de las colecciones

    Ordena por play_count para ver qué colección se ve más. Aquí play_count es el número de reproducciones de toda la colección.

  • Seguir las actualizaciones

    Lee updated_at y episode_count cada cierto tiempo y compáralos para ver si una colección añadió episodios.

  • Obtener las publicaciones de una colección

    Pasa mix_id a mix_posts para leer las publicaciones de la colección, o a mix_detail para leer la colección en sí.

Plataforma abierta de Douyin frente a EveryInfra

Así se comparan la documentación de la plataforma abierta de Douyin y user_mixes de EveryInfra en lo que hace falta para conectar.

AspectoPlataforma abierta de DouyinEveryInfra
Acceso necesarioLa documentación indica que los desarrolladores de terceros que han solicitado el permiso de gestión de usuarios y cuentan con la autorización del usuario pueden obtener los datos correspondientes.Una clave de API de EveryInfra en la cabecera Authorization: Bearer. La solicitud solo lleva user_id y el autor no tiene que autorizar nada.

La documentación de la plataforma abierta de Douyin está en chino. La tabla muestra una traducción, cotejada con la página el 2026-11-22. La página no indica fecha de actualización. La lista de API de la plataforma abierta no tiene ningún endpoint que liste las colecciones de un autor, así que esta fila compara solo lo que hace falta para conectar. Fuentes oficiales: Solución de acceso a la información de usuario

Límites y detalles a tener en cuenta

  • user_id es obligatorio: el secUid de un usuario de Douyin (empieza por MS4w) o el enlace de perfil https://www.douyin.com/user/<secUid>. No se aceptan apodos, ID de Douyin ni enlaces cortos.
  • Una llamada devuelve una página y puede traer menos filas de lo habitual. Para la página siguiente, devuelve next_page_token como page_token y deja los demás parámetros igual. El token vale 24 horas y la última página no trae next_page_token.
  • mix_count es el número de colecciones del autor y es igual en todas las filas. Algunas cuentas devuelven menos colecciones que mix_count.
  • play_count son las reproducciones de toda la colección y episode_count es el número de episodios de la colección.
  • cover_image_url es la portada de la colección. Si el enlace va firmado, caduca.

Precios

Pagas $0.000792 por llamada, no por fila. Cada llamada devuelve una página, así que cada página que lees cuenta como una llamada. Las llamadas fallidas y los resultados vacíos no se cobran.

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

Los totales se calculan con el precio de lista por llamada.

Ejemplos de código

#
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"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Referencia de API

Consulta los parámetros, los campos de respuesta, los errores y la facturación de user_mixes, y copia la página o ábrela en Markdown para dársela a un asistente de IA.

POST

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Douyin: Colecciones de una cuenta (douyin/user_mixes).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en douyin y action en user_mixes, y los parámetros dentro de params.
- Parámetros obligatorios:
  - user_id: La cuenta de la que quieres las colecciones: su secUid (empieza por MS4w) o un enlace de perfil https://www.douyin.com/user/<secUid>. No se aceptan apodos, Douyin ID ni enlaces cortos.
- Parámetros opcionales:
  - page_token: Token de paginación de user_mixes. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar user_id. Los tokens duran 24 horas; la última página no trae next_page_token.
- Devuelve una lista de registros. Campos principales de cada registro: mix_id (ID de la colección de Douyin (user_mixe…), name (Nombre de la colección (user_mixes)), description (Descripción de la colección (user_mixes…), url, cover_image_url (URL de la imagen de portada: la portada…), author_id, author_name, episode_count (Cuántos episodios tiene la colección (u…), play_count (Real solo en Hot Spot Treasure y mixes), created_at, updated_at (Cuándo se actualizó la colección por úl…), mix_count (Cuántas colecciones tiene la cuenta en…).
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "user_mixes",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}
- Precio: $0.79 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSídouyinIdentificador de la plataforma, valor fijo.
actionbodystringSíuser_mixesIdentificador de la capacidad, valor fijo.
user_idbody.paramsstringSí-La cuenta de la que quieres las colecciones: su secUid (empieza por MS4w) o un enlace de perfil https://www.douyin.com/user/<secUid>. No se aceptan apodos, Douyin ID ni enlaces cortos.
page_tokenbody.paramsstringNo-Token de paginación de user_mixes. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar user_id. Los tokens duran 24 horas; la última página no trae next_page_token. Una página trae hasta 20 colecciones.

Ejemplo de respuesta

#
Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según la definición de la API, con … como marcadores. No es el resultado de una llamada real.
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": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
mix_idID de la colección de Douyin (user_mixes). Envíalo como mix_id a mix_posts para listar los vídeos de la colección.
nameNombre de la colección (user_mixes).
descriptionDescripción de la colección (user_mixes).
urlEnlace al registro en la plataforma.
cover_image_urlURL de la imagen de portada: la portada de un vídeo o nota en las filas de search, user_posts, posts_batch, related_posts, mix_posts, music_posts y media_links; la portada de la música en music_search y music_detail; la imagen del tema en billboard_topic_hot; la portada de la colección en user_mixes; la portada de la sala en live_room. Los enlaces firmados caducan.
author_idIdentificador único del autor en la plataforma.
author_nameNombre visible del autor.
episode_countCuántos episodios tiene la colección (user_mixes).
play_countReal solo en Hot Spot Treasure y mixes. En billboard_video_hot, billboard_low_fan_explosion y billboard_high_completion es la cifra propia de Douyin. En mix_posts son las reproducciones de ese episodio y en user_mixes las de toda la colección. En las demás acciones Douyin no publica reproducciones y el valor suele ser 0, no real; mide el alcance con me gusta, comentarios y compartidos.
created_atFecha de creación, con el mismo formato que posted_at.
updated_atCuándo se actualizó la colección por última vez (user_mixes, ISO 8601, UTC).
mix_countCuántas colecciones tiene la cuenta en total (user_mixes); igual en todas las filas. En algunas cuentas recibes menos colecciones que esta cifra.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Preguntas frecuentes

¿Qué devuelve la API de la lista de colecciones de Douyin?

Una fila por colección: mix_id, name, description, url, cover_image_url, author_id, author_name, episode_count, play_count, created_at, updated_at y mix_count.

¿Cómo leo las publicaciones de una colección cuando ya tengo su ID?

Pasa mix_id a mix_posts. Para leer solo la colección, pásalo a mix_detail.

¿Cuánto cuesta una página de colecciones?

Cuesta $0.000792 por llamada, o $0.79 por cada 1000 llamadas, y se factura por llamada, no por fila. Las llamadas fallidas y los resultados vacíos no se cobran.

Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Douyin.

Google Analytics solo si aceptas. Privacidad