API de Detalles de una colección de Douyin

Lee una colección de Douyin con mix_id: name, episode_count, play_count, collect_count y las fechas de creación y actualización created_at y updated_at, a $0.56 por cada 1000 llamadas.

  • is_complete indica si los datos de la colección están completos.
  • Una llamada lee una colección y devuelve un objeto.
  • 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": "mix_detail",
      "params": {
        "mix_id": "7631984690945067058"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "author_id": "",
        "mix_id": "7631984690945067058",
        "name": "肩背手臂",
        "cover_image_url": "https://p26-sign.douyinpic.com/obj/tos-cn-i-dy/8a817b1a7fde4c9eb3ea233a9db61525?lk3s=f3356eed&x-expires=1795266000&x-signature=F%2FuS3k2nvCzB7rWBN5q53VqoLzY%3D&from=4080365293&s=PackSourceEnum_MIX_PUBLISH&se=false&sc=mix_cover&biz_tag=aweme_mix&l=2026112115181301C2C9B3594360895F6…",
        …
      }
    }
  3. 3Campos

    author_idmix_idnamecover_image_url
    7631984690945067058肩背手臂https://p26-sign.douyinpic.com/obj/tos-cn-i-dy/8a817b1a7fde4c9eb3ea233a9db61525?lk3s=f3356eed&x-expires=1795266000&x-signature=F%2FuS3k2nvCzB7rWBN5q53VqoLzY%3D&from=4080365293&s=PackSourceEnum_MIX_PUBLISH&se=false&sc=mix_cover&biz_tag=aweme_mix&l=2026112115181301C2C9B3594360895F6…
  4. 4CSV

    douyin-mix_detail-sample.csv mix_id,name,description,url,cover_image_url,episode_count,play_count,collect_count,author_id,author_uid,author_name,author_douyin_id,author_avatar_url,author_is_verified,author_follower_count,created_at,updated_at,is_complete,platform

Entra una solicitud con mix_id y sale un objeto JSON con campos como name y episode_count, que se muestra como tabla de campos y se puede descargar en CSV.

Qué datos obtienes

La tabla muestra una llamada real para 7631984690945067058, obtenida el 21 de noviembre de 2026, 07:17 (UTC), que devolvió un objeto; las barras grises marcan datos personales eliminados (••• en el CSV). En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.

mix_idnamedescriptionurlcover_image_urlepisode_countplay_countcollect_countauthor_idauthor_uidauthor_nameauthor_douyin_idauthor_avatar_urlauthor_is_verifiedauthor_follower_countcreated_atupdated_atis_completeplatform
7631984690945067058肩背手臂nullhttps://www.douyin.com/collection/7631984690945067058https://p26-sign.douyinpic.com/obj/tos-cn-i-dy/8a817b1a7fde4c9eb3ea233a9db61525?lk3s=f3356eed&x-expires=1795266000&x-signature=F%2FuS3k2nvCzB7rWBN5q53VqoLzY%3D&from=4080365293&s=PackSourceEnum_MIX_PUBLISH&se=false&sc=mix_cover&biz_tag=aweme_mix&l=2026112115181301C2C9B3594360895F6…101676403薇•••养nullfalse431982026-04-23T15:58:27+00:002026-04-24T03:17:05+00:00truedouyin

Casos de uso

  • Comprobar el tamaño de una colección

    Lee episode_count y play_count para ver cuántos episodios tiene una colección y cuánto se ha visto.

  • Ver si una colección se actualizó

    Lee updated_at cada cierto tiempo y compáralo con el valor anterior.

  • Llevar un registro de cada colección

    Usa mix_id como clave y guarda name, url, author_name y author_follower_count.

  • Completar datos parciales

    Cuando is_complete es false, recorre las páginas de user_mixes para encontrar este mix_id y leer los datos completos.

Plataforma abierta de Douyin frente a EveryInfra

Así se comparan la documentación de la plataforma abierta de Douyin y mix_detail 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 mix_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 lea una colección por su ID, 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

  • mix_id es obligatorio: el ID numérico de una colección, tomado del mix_id de una fila de user_mixes. También se acepta el enlace https://www.douyin.com/collection/<ID>.
  • is_complete en false significa que los datos de la colección están incompletos: no se obtuvieron play_count, collect_count, description, created_at ni updated_at. El autor tiene muchas colecciones; para completar los datos, recorre las páginas de user_mixes hasta encontrar este mix_id.
  • author_id es el secUid del autor y author_uid es el ID numérico de usuario. Son dos ID de la misma persona.
  • Una llamada lee una colección y devuelve un objeto. Usa mix_posts para obtener las publicaciones de la colección.

Precios

Pagas $0.000556 por llamada, no por campo. Una llamada lee una colección. Las llamadas fallidas y los resultados vacíos no se cobran.

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

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": "mix_detail",
  "params": {
    "mix_id": "7631984690945067058"
  }
}'

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 mix_detail, 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: Detalles de una colección (douyin/mix_detail).

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 mix_detail, y los parámetros dentro de params.
- Parámetros obligatorios:
  - mix_id: ID numérico de una colección de Douyin, tomado del mix_id de las filas de user_mixes; también vale un enlace https://www.douyin.com/collection/<ID>.
- Devuelve un objeto. Campos principales: 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…), episode_count (Cuántos episodios tiene la colección (u…), play_count (Real solo en Hot Spot Treasure y mixes), collect_count, author_id, author_uid (ID numérico de usuario del autor (en lo…), author_name, author_douyin_id (Douyin ID del autor); 18 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "mix_detail",
  "params": {
    "mix_id": "7631984690945067058"
  }
}
- Precio: $0.56 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ímix_detailIdentificador de la capacidad, valor fijo.
mix_idbody.paramsstringSí-ID numérico de una colección de Douyin, tomado del mix_id de las filas de user_mixes; también vale un enlace https://www.douyin.com/collection/<ID>.

Ejemplo de respuesta

#
Obtenida el 21 de noviembre de 2026, 07:17 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "douyin",  "action": "mix_detail",  "results": {    "mix_id": "7631984690945067058",    "name": "肩背手臂",    "url": "https://www.douyin.com/collection/7631984690945067058",    "cover_image_url": "https://p26-sign.douyinpic.com/obj/tos-cn-i-dy/8a817b1a7fde4c9eb3ea233a9db61525?lk3s=f3356eed&x-expires=1795266000&x-signature=F%2FuS3k2nvCzB7rWBN5q53VqoLzY%3D&from=4080365293&s=PackSourceEnum_MIX_PUBLISH&se=false&sc=mix_cover&biz_tag=aweme_mix&l=2026112115181301C2C9B3594360895F6…",    "episode_count": 10,    "play_count": 167640,    "collect_count": 3,    "author_id": "•••",    "author_uid": "•••",    "author_name": "薇•••养",    "author_avatar_url": "https://p3-pc.douyinpic.com/•••",    "author_is_verified": false,    "author_follower_count": 43198,    "created_at": "2026-04-23T15:58:27+00:00",    "updated_at": "2026-04-24T03:17:05+00:00",    "is_complete": true,    "platform": "douyin"  },  "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.
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.
collect_countGuardados o favoritos. null significa no publicado, no 0.
author_idIdentificador único del autor en la plataforma.
author_uidID numérico de usuario del autor (en los comentarios, de quien comenta). author_id es el secUid; ambos identifican a la misma persona.
author_nameNombre visible del autor.
author_douyin_idDouyin ID del autor.
author_avatar_urlURL del avatar del autor: el creador en las filas de search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts; quien presenta la emisión en live_room; quien comenta en las de comments.
author_is_verifiedSi el autor está verificado (filas de search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts; en live_room, si lo está quien presenta la emisión; en las de comments, si lo está quien comenta).
author_follower_countSeguidores del autor. null significa no publicado.
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).
is_completeConserva el significado de la plataforma
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 detalle de una colección de Douyin?

Un objeto: mix_id, name, description, url, cover_image_url, episode_count, play_count, collect_count, created_at, updated_at e is_complete, más campos del autor como author_id y author_name.

¿Cómo leo las publicaciones de una colección?

Pasa el mismo mix_id a mix_posts. Devuelve una fila por episodio.

¿Cuánto cuesta leer una colección?

Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas, y se factura por llamada, no por campo. 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