API de Publicaciones en lote de Douyin

Lee varias publicaciones de Douyin de una vez con urls; cada publicación es una fila con text, like_count, comment_count, share_count, collect_count y los campos del autor. Cada elemento de urls es una llamada, a $0.56 por cada 1000 llamadas.

  • input de cada fila es el elemento que enviaste, para que puedas emparejar las filas.
  • Los elementos que no se pudieron leer no se cobran y aparecen en missed de la respuesta.
  • 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": "posts_batch",
      "params": {
        "urls": [
          "https://www.douyin.com/video/<VIDEO_ID_A>",
          "<VIDEO_ID_B>"
        ]
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "text": string,
          "media_type": string,
          "video_url": string,
          "like_count": number
        },
        …
      ]
    }
  3. 3Filas

    textmedia_typevideo_urllike_count
    stringstringstringnumber
  4. 4CSV

    douyin-posts_batch-sample.csv id,url,text,media_type,video_url,like_count,comment_count,share_count,collect_count,author_name,author_id,author_douyin_id,author_bio,author_avatar_url,author_follower_count,author_following_count,author_like_count,author_video_count,author_is_verified,cover_image_url,video_width,video_height,video_bitrates,has_watermark,duration_sec,duration_seconds,hashtags,posted_at,title,music,location,image_urls,is_deleted,is_private,platform,input

Entra una solicitud con urls y sale una fila por publicación; input en results es el elemento que enviaste, 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
idstringIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
urlstringEnlace al registro en la plataforma.
textstringTexto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma).
media_typestringTipo de medio: video, o image en las publicaciones de imágenes.
video_urlstringURL de reproducción del vídeo (firmada y con caducidad; descárgala pronto si necesitas conservarla). Null para notas de imágenes o si la fuente no la trae.
like_countnumberMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
comment_countnumberComentarios. null significa no publicado, no 0.
share_countnumberVeces compartido. null significa no publicado, no 0.
collect_countnumberGuardados o favoritos. null significa no publicado, no 0.
author_namestringNombre visible del autor.
author_idstringIdentificador único del autor en la plataforma.
author_douyin_idstringDouyin ID del autor.
author_biostringBiografía del perfil del autor (filas de search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts).
author_avatar_urlstringURL 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_follower_countnumberSeguidores del autor. null significa no publicado.
author_following_countnumberCuántas cuentas sigue el autor (filas de search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts).
author_like_countnumberTotal de «me gusta» que ha recibido el perfil del autor (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts / transcript).
author_video_countnumberNúmero total de publicaciones del perfil del autor (filas de search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts).
author_is_verifiedbooleanSi 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).
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.
video_widthnumberAncho del vídeo en píxeles.
video_heightnumberAlto del vídeo en píxeles.
video_bitratesarrayConserva el significado de la plataforma
has_watermarkbooleanConserva el significado de la plataforma
duration_secnumberDuración del video en segundos.
duration_secondsnumberDuración en segundos. null en contenido que no es video ni audio.
hashtagsarrayHashtags del texto, en orden de aparición; no aparece si no hay ninguno.
posted_atstringFecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica.
titlestringTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
musicobjectMúsica de fondo: id, title (título), author (autor), is_original (si es sonido original), duration_sec (segundos), cover_url y play_url (enlace de audio, puede caducar). No aparece si no hay información musical.
location—Descripción de la ubicación tal como la da la plataforma; el formato varía.
image_urls—Lista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes.
is_deletedbooleantrue cuando el vídeo ha sido eliminado; solo aparece cuando Douyin lo indica en la fila.
is_privatebooleantrue cuando el vídeo solo lo ve su autor (privado); solo aparece cuando Douyin lo indica en la fila.
platformstringIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
input—La entrada de urls a la que responde esta fila, devuelta tal como la enviaste (posts_batch, profiles_batch, media_links). Úsala para emparejar cada fila con tu entrada.

Casos de uso

  • Actualizar los contadores de una biblioteca de publicaciones

    Pon en urls los enlaces de video de tu biblioteca, lee like_count y comment_count de cada fila y empareja las filas con tus registros mediante input.

  • Comprobar que un conjunto de videos sigue ahí

    Lee is_deleted y is_private para hallar publicaciones eliminadas o visibles solo para su dueño.

  • Comparar los autores de un conjunto de videos

    Lee author_name, author_follower_count y author_is_verified para ver de qué tamaño son las cuentas de las que salen los videos.

  • Usarlo tras el reconocimiento de enlaces

    Si un montón de textos de compartir contiene varios videos, usa primero resolve_links para separar cada matched_text y ponlos luego en urls; posts_batch ya acepta enlaces cortos y textos de compartir completos.

Plataforma abierta de Douyin frente a EveryInfra

Así se comparan la guía general de autorización de la plataforma abierta de Douyin y posts_batch de EveryInfra en el acceso.

AspectoPlataforma abierta de DouyinEveryInfra
Cómo se llamaLa documentación indica que las llamadas a la API se hacen con el access_token para leer la información básica del usuario y hacer otras operaciones.No obtienes antes un access_token. La cabecera lleva tu clave de API de EveryInfra, y urls contiene las publicaciones que quieres leer.

La documentación de la plataforma abierta de Douyin está en chino; la tabla muestra una traducción, cotejada con su guía general de autorización el 2026-11-22. La página no indica fecha de actualización. La documentación no describe la lectura por lotes de publicaciones públicas cualesquiera, así que aquí solo se compara el acceso. Fuentes oficiales: Guía general de autorización

Límites y detalles a tener en cuenta

  • urls es un arreglo; la referencia de parámetros indica cuántos elementos admite una llamada; el mismo elemento solo puede aparecer una vez.
  • Cada elemento puede ser un ID numérico de video, un enlace de video (https://www.douyin.com/video/<ID del video>), un enlace corto v.douyin.com o un texto de compartir completo que contenga un enlace corto.
  • Se factura por elemento, una llamada cada uno; los elementos que no se pudieron leer no se cobran y aparecen en missed de la respuesta.
  • is_deleted es true cuando la publicación se eliminó e is_private es true cuando solo su dueño puede verla; la clave existe solo cuando Douyin la marca.
  • Los contadores de interacción son los valores del momento de la lectura; para ver cómo cambian, usa post_history.
  • Solo admite llamadas síncronas.

Precios

Cada elemento de urls cuenta como una llamada de $0.000556, así que pagas por el número de elementos y no por campo; los elementos que no se pudieron leer no se cobran. 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": "posts_batch",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>",
      "<VIDEO_ID_B>"
    ]
  }
}'

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 posts_batch, 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: Publicaciones en lote (douyin/posts_batch).

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 posts_batch, y los parámetros dentro de params.
- Parámetros obligatorios:
  - urls: Los vídeos que quieres leer, en una lista de hasta 20 entradas; cada entrada solo puede aparecer una vez.
- Parámetros opcionales:
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.
- Devuelve una lista de registros. Campos principales de cada registro: id, url, text, media_type (Tipo de medio: video, o image en las pu…), video_url (URL de reproducción del vídeo (firmada…), like_count, comment_count, share_count, collect_count, author_name, author_id, author_douyin_id (Douyin ID del autor); 35 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "posts_batch",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>",
      "<VIDEO_ID_B>"
    ]
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Este endpoint solo funciona en modo síncrono; no añadas "mode": "async" al cuerpo.
- 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íposts_batchIdentificador de la capacidad, valor fijo.
urlsbody.paramsarraySí-Los vídeos que quieres leer, en una lista de hasta 20 entradas; cada entrada solo puede aparecer una vez. Cada entrada es un ID numérico de vídeo, un enlace https://www.douyin.com/video/<ID_de_vídeo>, un enlace corto v.douyin.com o un texto completo de compartir que incluya un enlace corto. Se cobra por vídeo; los que no se encuentran no se cobran. Las filas llevan input, la entrada que enviaste.
limitbody.paramsinteger (1–)No-Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.

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": "posts_batch",  "results": [    {      "id": …,      "url": …,      "text": …,      "media_type": …,      "video_url": …,      "like_count": …,      "comment_count": …,      "share_count": …,      "collect_count": …,      "author_name": …,      "author_id": …,      "author_douyin_id": …,      "author_bio": …,      "author_avatar_url": …,      "author_follower_count": …,      "author_following_count": …,      "author_like_count": …,      "author_video_count": …,      "author_is_verified": …,      "cover_image_url": …,      "video_width": …,      "video_height": …,      "video_bitrates": …,      "has_watermark": …,      "duration_sec": …,      "duration_seconds": …,      "hashtags": …,      "posted_at": …,      "title": …,      "music": …,      "location": …,      "image_urls": …,      "is_deleted": …,      "is_private": …,      "platform": …,      "input": …    }  ],  "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
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
urlEnlace al registro en la plataforma.
textTexto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma).
media_typeTipo de medio: video, o image en las publicaciones de imágenes.
video_urlURL de reproducción del vídeo (firmada y con caducidad; descárgala pronto si necesitas conservarla). Null para notas de imágenes o si la fuente no la trae.
like_countMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
comment_countComentarios. null significa no publicado, no 0.
share_countVeces compartido. null significa no publicado, no 0.
collect_countGuardados o favoritos. null significa no publicado, no 0.
author_nameNombre visible del autor.
author_idIdentificador único del autor en la plataforma.
author_douyin_idDouyin ID del autor.
author_bioBiografía del perfil del autor (filas de search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts).
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_follower_countSeguidores del autor. null significa no publicado.
author_following_countCuántas cuentas sigue el autor (filas de search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts).
author_like_countTotal de «me gusta» que ha recibido el perfil del autor (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts / transcript).
author_video_countNúmero total de publicaciones del perfil del autor (filas de search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts).
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).
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.
video_widthAncho del vídeo en píxeles.
video_heightAlto del vídeo en píxeles.
video_bitratesConserva el significado de la plataforma
has_watermarkConserva el significado de la plataforma
duration_secDuración del video en segundos.
duration_secondsDuración en segundos. null en contenido que no es video ni audio.
hashtagsHashtags del texto, en orden de aparición; no aparece si no hay ninguno.
posted_atFecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica.
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
musicMúsica de fondo: id, title (título), author (autor), is_original (si es sonido original), duration_sec (segundos), cover_url y play_url (enlace de audio, puede caducar). No aparece si no hay información musical.
locationDescripción de la ubicación tal como la da la plataforma; el formato varía.
image_urlsLista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes.
is_deletedtrue cuando el vídeo ha sido eliminado; solo aparece cuando Douyin lo indica en la fila.
is_privatetrue cuando el vídeo solo lo ve su autor (privado); solo aparece cuando Douyin lo indica en la fila.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
inputLa entrada de urls a la que responde esta fila, devuelta tal como la enviaste (posts_batch, profiles_batch, media_links). Úsala para emparejar cada fila con tu entrada.

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 publicaciones por lotes de Douyin?

Una fila por cada publicación leída: id, url, text, media_type, like_count, comment_count, share_count, collect_count, los campos del autor, hashtags, posted_at, is_deleted, is_private y más, además de input.

¿Cómo emparejo un resultado con el elemento que envié?

input de cada fila es el elemento que enviaste, sin cambios. Empareja por él.

¿Qué pasa si algunos elementos no se pudieron leer?

Mira missed en la respuesta. Esos elementos no se leyeron y no se cobran; puedes solicitarlos de nuevo por separado.

¿Cómo se factura un lote de publicaciones?

Cada elemento de urls es una llamada de $0.000556, o $0.56 por cada 1000 llamadas. 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