API de Episodios de un microdrama de Douyin

Lee los episodios de una serie corta de Douyin con series_id, una fila por episodio: episode, is_paid, duration_seconds, like_count y comment_count, a $0.79 por cada 1000 llamadas.

  • is_paid indica si un episodio es de pago.
  • El enlace del video de un episodio de pago está cifrado y no se reproduce tras descargarlo.
  • 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": "series_posts",
      "params": {
        "series_id": "7703828515069626394"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "author_name": "月•••场",
          "text": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",
          "media_type": "video",
          "video_url": "https://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"
        },
        …
      ],
      "count": 20
    }
  3. 3Filas

    author_nametextmedia_typevideo_url
    月•••场《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘videohttps://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…
    月•••场《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘videohttps://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…
  4. 4CSV

    douyin-series_posts-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,episode,series_id,is_paid

Entra una solicitud con series_id y sale una página de episodios de esa serie; cada fila de results es un episodio, y se muestra como tabla de campos y se puede descargar en CSV.

Qué datos obtienes

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

idurltextmedia_typevideo_urllike_countcomment_countshare_countcollect_countauthor_nameauthor_idauthor_douyin_idauthor_bioauthor_avatar_urlauthor_follower_countauthor_following_countauthor_like_countauthor_video_countauthor_is_verifiedcover_image_urlvideo_widthvideo_heightvideo_bitrateshas_watermarkduration_secduration_secondshashtagsposted_attitlemusiclocationimage_urlsis_deletedis_privateplatformepisodeseries_idis_paid
https://www.douyin.com/video/7703828500301565211《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘videohttps://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…879891574725845233月•••场0000truehttps://p3-pc-sign.douyinpic.com/image-cut-tos-priv/a5d7f7e3643ab1b2597d9413fa3cd08d~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2110604400&x-signature=H4X6sOZA0gfnw2QNCSNxSyOG03o%3D&from=327834062&s=PackSourceEnum_SERIES_AWEME&se=false&sc=cover&biz_tag=pcw…10801920[{"bitrate":1255744,"width":1080,"height":1920,"url":"https://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"},{"bitrate":1013582,"width":576,"height":1024,"url":"https://v3-dy-o.zjcdn.com/20e5ebf4086fb947fa3914d3500a1951/6b0297c1/video/tos/cn/tos-cn-ve-15/o0L5WSpV0A0sBPxQIf9vH7NCE4teEAfMBaUAIG/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=989&bt=989&cs=0&ds=6&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"},{"bitrate":951491,"width":720,"height":1280,"url":"https://v3-dy-o.zjcdn.com/46718b45735e8a4044eed46901db081a/6b0297c1/video/tos/cn/tos-cn-ve-15/o0rw9gMxQXA5I1C0ogQEJfBiB9v887eSV33nAe/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=929&bt=929&cs=0&ds=3&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"}]false151151["因为一个片段看了整部剧","抖音短剧新番计划","短剧"]2026-11-06T02:00:07+00:00《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘{"id":"•••","title":"@•••","author":"月•••场","is_original":true,"duration_sec":150,"cover_url":"https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-ke512zj2cu_88d4450285154a308fd4e0afa6a580a9.jpeg?from=327834062","play_url":"https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7703828583453674281.mp3"}nullnullfalsefalsedouyin17703828515069626394false
https://www.douyin.com/video/7703828517959552290《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘videohttps://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…33380458164013467月•••场0000truehttps://p3-pc-sign.douyinpic.com/image-cut-tos-priv/ca39cf70869db9f0da75aef5f30e6b76~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2110604400&x-signature=yI88VOEPXUc0DWyDLWEDN1NZyNE%3D&from=327834062&s=PackSourceEnum_SERIES_AWEME&se=false&sc=cover&biz_tag=pcw…10801920[{"bitrate":1305274,"width":1080,"height":1920,"url":"https://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"},{"bitrate":1036153,"width":576,"height":1024,"url":"https://v3-dy-o.zjcdn.com/f9e3ce47cb765892d8a5569819de4a12/6b029765/video/tos/cn/tos-cn-ve-15/oEZt7v6HVQaOBaBXNC0Xdf5QIfMgyjAf7A8hgD/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1011&bt=1011&cs=0&ds=6&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"},{"bitrate":993216,"width":720,"height":1280,"url":"https://v3-dy-o.zjcdn.com/fea21356fc0e4e4e33eef91c93efffc8/6b029765/video/tos/cn/tos-cn-ve-15/o0eAHStpguAkfSAAit7Yo3f9fnf3zvXl6EH4Jq/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=969&bt=969&cs=0&ds=3&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"}]false5858["因为一个片段看了整部剧","抖音短剧新番计划","短剧"]2026-11-06T02:00:09+00:00《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘{"id":"•••","title":"@•••","author":"月•••场","is_original":true,"duration_sec":58,"cover_url":"https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-ke512zj2cu_88d4450285154a308fd4e0afa6a580a9.jpeg?from=327834062","play_url":"https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7703828581427759891.mp3"}nullnullfalsefalsedouyin27703828515069626394false

Casos de uso

  • Comparar la interacción por episodio

    Ordena las filas por episode y compara like_count, comment_count y collect_count para ver qué episodios atraen más atención.

  • Encontrar dónde empieza el pago

    Mira desde qué episodio is_paid pasa a true y compáralo con paid_episode_count de series_detail.

  • Sumar la duración total

    Lee duration_seconds de cada episodio y súmalos para obtener la duración total de la serie.

  • Obtener las direcciones de los episodios gratuitos

    En los episodios con is_paid en false, toma la dirección de url y video_url. video_url va firmada y caduca.

Plataforma abierta de Douyin frente a EveryInfra

Así se comparan la documentación de la plataforma abierta de Douyin y series_posts 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 series_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 documentación de series cortas de la plataforma abierta trata de miniprogramas que alojan sus propios episodios. No tiene ningún endpoint que lea los episodios de cualquier serie pública, 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

  • series_id es obligatorio: el ID numérico de una serie corta, tomado del series_id de una fila de series_feed o user_series. También se acepta el enlace para compartir https://www.iesdouyin.com/share/playlet/detail/<ID>.
  • Una llamada devuelve una página en orden de episodio 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.
  • En un episodio con is_paid en true, el enlace del video está cifrado y no se reproduce tras descargarlo.
  • episode empieza en 1 y es la posición del episodio en la serie.
  • video_url va firmada y caduca, así que descárgala pronto si necesitas conservarla.

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": "series_posts",
  "params": {
    "series_id": "7703828515069626394"
  }
}'

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 series_posts, 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: Episodios de un microdrama (douyin/series_posts).

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 series_posts, y los parámetros dentro de params.
- Parámetros obligatorios:
  - series_id: ID numérico de un microdrama de Douyin, tomado del series_id de las filas de series_feed o user_series; también vale un enlace para compartir el microdrama.
- Parámetros opcionales:
  - page_token: Token de paginación de series_posts. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar los demás parámetros. Los tokens duran 24 horas.
- 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); 37 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "series_posts",
  "params": {
    "series_id": "7703828515069626394"
  }
}
- 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íseries_postsIdentificador de la capacidad, valor fijo.
series_idbody.paramsstringSí-ID numérico de un microdrama de Douyin, tomado del series_id de las filas de series_feed o user_series; también vale un enlace para compartir el microdrama.
page_tokenbody.paramsstringNo-Token de paginación de series_posts. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar los demás parámetros. Los tokens duran 24 horas; la última página no trae next_page_token. Una página trae hasta 20 episodios, por orden de episodio.

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); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "douyin",  "action": "series_posts",  "results": [    {      "id": "•••",      "url": "https://www.douyin.com/video/7703828500301565211",      "text": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",      "media_type": "video",      "video_url": "https://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…",      "like_count": 87989,      "comment_count": 1574,      "share_count": 7258,      "collect_count": 45233,      "author_name": "月•••场",      "author_id": "•••",      "author_douyin_id": "•••",      "author_bio": "•••",      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",      "author_follower_count": 0,      "author_following_count": 0,      "author_like_count": 0,      "author_video_count": 0,      "author_is_verified": true,      "cover_image_url": "https://p3-pc-sign.douyinpic.com/image-cut-tos-priv/a5d7f7e3643ab1b2597d9413fa3cd08d~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2110604400&x-signature=H4X6sOZA0gfnw2QNCSNxSyOG03o%3D&from=327834062&s=PackSourceEnum_SERIES_AWEME&se=false&sc=cover&biz_tag=pcw…",      "video_width": 1080,      "video_height": 1920,      "video_bitrates": [        {          "bitrate": 1255744,          "width": 1080,          "height": 1920,          "url": "https://v3-dy-o.zjcdn.com/3da3ae87fce4e8ff5906f075906cf14d/6b0297c1/video/tos/cn/tos-cn-ve-15/ow29BfeGEIfI7sVBaSUUP0PvtCwA9I5iLQWxEA/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1226&bt=1226&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"        },        {          "bitrate": 1013582,          "width": 576,          "height": 1024,          "url": "https://v3-dy-o.zjcdn.com/20e5ebf4086fb947fa3914d3500a1951/6b0297c1/video/tos/cn/tos-cn-ve-15/o0L5WSpV0A0sBPxQIf9vH7NCE4teEAfMBaUAIG/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=989&bt=989&cs=0&ds=6&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"        },        {          "bitrate": 951491,          "width": 720,          "height": 1280,          "url": "https://v3-dy-o.zjcdn.com/46718b45735e8a4044eed46901db081a/6b0297c1/video/tos/cn/tos-cn-ve-15/o0rw9gMxQXA5I1C0ogQEJfBiB9v887eSV33nAe/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=929&bt=929&cs=0&ds=3&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"        }      ],      "has_watermark": false,      "duration_sec": 151,      "hashtags": [        "因为一个片段看了整部剧",        "抖音短剧新番计划",        "短剧"      ],      "posted_at": "2026-11-06T02:00:07+00:00",      "title": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",      "music": {        "id": "•••",        "title": "@•••",        "author": "月•••场",        "is_original": true,        "duration_sec": 150,        "cover_url": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-ke512zj2cu_88d4450285154a308fd4e0afa6a580a9.jpeg?from=327834062",        "play_url": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7703828583453674281.mp3"      },      "is_deleted": false,      "is_private": false,      "platform": "douyin",      "episode": 1,      "series_id": "7703828515069626394",      "is_paid": false,      "duration_seconds": 151    },    {      "id": "•••",      "url": "https://www.douyin.com/video/7703828517959552290",      "text": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",      "media_type": "video",      "video_url": "https://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…",      "like_count": 33380,      "comment_count": 458,      "share_count": 1640,      "collect_count": 13467,      "author_name": "月•••场",      "author_id": "•••",      "author_douyin_id": "•••",      "author_bio": "•••",      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",      "author_follower_count": 0,      "author_following_count": 0,      "author_like_count": 0,      "author_video_count": 0,      "author_is_verified": true,      "cover_image_url": "https://p3-pc-sign.douyinpic.com/image-cut-tos-priv/ca39cf70869db9f0da75aef5f30e6b76~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2110604400&x-signature=yI88VOEPXUc0DWyDLWEDN1NZyNE%3D&from=327834062&s=PackSourceEnum_SERIES_AWEME&se=false&sc=cover&biz_tag=pcw…",      "video_width": 1080,      "video_height": 1920,      "video_bitrates": [        {          "bitrate": 1305274,          "width": 1080,          "height": 1920,          "url": "https://v3-dy-o.zjcdn.com/c0b2281c06c2d8fd0cb479c4a5cecc16/6b029765/video/tos/cn/tos-cn-ve-15/oQvCJf7eXt7VLBArI5697WsGAIWBaoQB5f0OEF/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1274&bt=1274&cs=0&ds=4&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"        },        {          "bitrate": 1036153,          "width": 576,          "height": 1024,          "url": "https://v3-dy-o.zjcdn.com/f9e3ce47cb765892d8a5569819de4a12/6b029765/video/tos/cn/tos-cn-ve-15/oEZt7v6HVQaOBaBXNC0Xdf5QIfMgyjAf7A8hgD/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=1011&bt=1011&cs=0&ds=6&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs…"        },        {          "bitrate": 993216,          "width": 720,          "height": 1280,          "url": "https://v3-dy-o.zjcdn.com/fea21356fc0e4e4e33eef91c93efffc8/6b029765/video/tos/cn/tos-cn-ve-15/o0eAHStpguAkfSAAit7Yo3f9fnf3zvXl6EH4Jq/?a=6383&ch=0&cr=3&dr=0&er=0&cd=0%7C0%7C0%7C3&cv=1&br=969&bt=969&cs=0&ds=3&ft=c2b7g_QTQO-UXmcusiHFSJcSYFq.raDtGx-UUDRq8_45a&mime_type=video_mp4&qs=0…"        }      ],      "has_watermark": false,      "duration_sec": 58,      "hashtags": [        "因为一个片段看了整部剧",        "抖音短剧新番计划",        "短剧"      ],      "posted_at": "2026-11-06T02:00:09+00:00",      "title": "《温柔以待,终有回甘》 【现代温情】中秋夜继子浑身湿透怯生生敲门,挺着孕肚的她一把拉住:这是你爸的家,想住就住!面黄肌瘦、衣服不合身,每周只给五十块生活费——这孩子从没吃饱过!短剧《温柔以待,终有回甘》#因为一个片段看了整部剧 #抖音短剧新番计划 #短剧 #家庭 #温柔以待终有回甘",      "music": {        "id": "•••",        "title": "@•••",        "author": "月•••场",        "is_original": true,        "duration_sec": 58,        "cover_url": "https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-ke512zj2cu_88d4450285154a308fd4e0afa6a580a9.jpeg?from=327834062",        "play_url": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7703828581427759891.mp3"      },      "is_deleted": false,      "is_private": false,      "platform": "douyin",      "episode": 2,      "series_id": "7703828515069626394",      "is_paid": false,      "duration_seconds": 58    }  ],  "next_page_token": …,  "pagination": { … },  "count": 20,  "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).
episodePosición del vídeo en la colección (mix_posts), contando desde 1.
series_idConserva el significado de la plataforma
is_paidConserva el significado de la plataforma

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 episodios de una serie corta de Douyin?

Una fila por episodio: id, url, episode, series_id, is_paid, text, media_type, video_url, like_count, comment_count, share_count, collect_count, duration_seconds y posted_at, más campos del autor.

¿De dónde sale series_id?

Tómalo del series_id de una fila de series_feed o user_series, o pasa directamente el enlace para compartir https://www.iesdouyin.com/share/playlet/detail/<ID>.

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

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