API de Microdramas de una cuenta de Douyin

Lista las series cortas que publicó un autor de Douyin con user_id, una fila por serie: name, status_text, episode_count, is_paid y created_at, a $0.79 por cada 1000 llamadas.

  • Los campos de cada fila son los mismos que en series_detail.
  • Aquí sub_genres suele faltar; para ese dato usa series_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_series",
      "params": {
        "user_id": "https://www.douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "author_uid": "",
          "series_id": "7709817571482011689",
          "name": "短剧 · 远赴边城相见,才知他另有牵挂",
          "description": "结婚五年、求子多年的林茵终于等来怀孕。她揣着孕检单坐了二十多个小时车,去西北边城给驻守项目的丈夫贺临惊喜,却在挂满红灯笼的小院里听见另一个孩子喊他爸爸。贺临解释是报答救命恩人、照顾工友遗孀。林茵从画册、照片和招待所登记本里,一点点拼出他在边城的四年。她藏起孕检单追问到项目部,真相浮出——安安与贺临、许曼关系不简单。她不再哭闹,面对以孩子为由的挽留和长辈劝说,她会如何选择?"
        },
        …
      ],
      "count": 20
    }
  3. 3Filas

    author_uidseries_idnamedescription
    7709817571482011689短剧 · 远赴边城相见,才知他另有牵挂结婚五年、求子多年的林茵终于等来怀孕。她揣着孕检单坐了二十多个小时车,去西北边城给驻守项目的丈夫贺临惊喜,却在挂满红灯笼的小院里听见另一个孩子喊他爸爸。贺临解释是报答救命恩人、照顾工友遗孀。林茵从画册、照片和招待所登记本里,一点点拼出他在边城的四年。她藏起孕检单追问到项目部,真相浮出——安安与贺临、许曼关系不简单。她不再哭闹,面对以孩子为由的挽留和长辈劝说,她会如何选择?
    7709794114602010678短剧 · 我大专毕业当柜姐,亮出实力后他们慌了大专毕业的苏念隐去家世,在珠宝店做柜姐,实则是雕刻泰斗苏万钧的孙女,承袭一手月牙雕刻绝技。她凭实力拿下大客户,却因戳破前男友未婚妻高价买下注油祖母绿的真相,遭投诉刁难。结识方家后,她受邀做订婚宴珠宝顾问,却在鉴定藏品时发现有人调包变卖。停职危机压来,她不肯低头——而鉴赏会上,那个姓氏背后的秘密,才刚刚浮出水面。
  4. 4CSV

    douyin-user_series-sample.csv series_id,name,description,url,cover_image_url,genres,sub_genres,status_text,episode_count,updated_to_episode,play_count,collect_count,is_paid,paid_episode_count,episode_price_cny,full_price_cny,icp_number,author_id,author_uid,author_name,author_douyin_id,author_avatar_url,author_is_verified,author_follower_count,created_at,updated_at,last_episode_at,platform

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

Qué datos obtienes

La tabla muestra una llamada real para douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY, 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.

series_idnamedescriptionurlcover_image_urlgenressub_genresstatus_textepisode_countupdated_to_episodeplay_countcollect_countis_paidpaid_episode_countepisode_price_cnyfull_price_cnyicp_numberauthor_idauthor_uidauthor_nameauthor_douyin_idauthor_avatar_urlauthor_is_verifiedauthor_follower_countcreated_atupdated_atlast_episode_atplatform
7709817571482011689短剧 · 远赴边城相见,才知他另有牵挂结婚五年、求子多年的林茵终于等来怀孕。她揣着孕检单坐了二十多个小时车,去西北边城给驻守项目的丈夫贺临惊喜,却在挂满红灯笼的小院里听见另一个孩子喊他爸爸。贺临解释是报答救命恩人、照顾工友遗孀。林茵从画册、照片和招待所登记本里,一点点拼出他在边城的四年。她藏起孕检单追问到项目部,真相浮出——安安与贺临、许曼关系不简单。她不再哭闹,面对以孩子为由的挽留和长辈劝说,她会如何选择?https://www.iesdouyin.com/share/playlet/detail/7709817571482011689/?schema_type=43&object_id=7709817571482011689&from_ssr=1https://p3-sign.douyinpic.com/tos-cn-i-dy/b78f360b14c95f2af5ee2ac6868adb59~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=GMqnVuqf2dF9fu4Dqn67sGSaVLc%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_tag=aw…["其他"]nullnull67000true66nullnull(抖音)微短剧备字(2026)第116470号MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY月•••场true02026-11-19T09:49:47+00:002026-11-20T10:08:46+00:002026-11-19T10:30:33+00:00douyin
7709794114602010678短剧 · 我大专毕业当柜姐,亮出实力后他们慌了大专毕业的苏念隐去家世,在珠宝店做柜姐,实则是雕刻泰斗苏万钧的孙女,承袭一手月牙雕刻绝技。她凭实力拿下大客户,却因戳破前男友未婚妻高价买下注油祖母绿的真相,遭投诉刁难。结识方家后,她受邀做订婚宴珠宝顾问,却在鉴定藏品时发现有人调包变卖。停职危机压来,她不肯低头——而鉴赏会上,那个姓氏背后的秘密,才刚刚浮出水面。https://www.iesdouyin.com/share/playlet/detail/7709794114602010678/?schema_type=43&object_id=7709794114602010678&from_ssr=1https://p3-sign.douyinpic.com/tos-cn-i-dy/56aefa2df51ff3eed392f5c4730b17ef~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=hLrAC3m%2BXRdN%2BSDVWSL9yEUBCpM%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_ta…["其他"]nullnull96000true95nullnull(抖音)微短剧备字(2026)第115873号MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY月•••场true02026-11-19T08:18:46+00:002026-11-20T11:03:07+00:002026-11-19T08:32:27+00:00douyin

Casos de uso

  • Repasar las series de una cuenta productora

    Lee name, episode_count e is_paid de cada serie de un autor para ver cuántas hizo y cuáles son de pago.

  • Seguir los estrenos

    Lee created_at y last_episode_at cada cierto tiempo para ver si apareció una serie nueva o un episodio nuevo.

  • Comparar los precios de un mismo autor

    Lee episode_price_cny y full_price_cny de las series de pago y compara los precios.

  • Pasar a leer el detalle y los episodios

    Pasa series_id a series_detail para el detalle o a series_posts para los episodios.

Plataforma abierta de Douyin frente a EveryInfra

Así se comparan la documentación de la plataforma abierta de Douyin y user_series 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 documentación de series cortas de la plataforma abierta trata de miniprogramas que alojan sus propios episodios. No tiene ningún endpoint que liste las series 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.
  • Aquí sub_genres suele faltar. Cuando falta, la fila no trae la clave sub_genres. Usa series_detail cuando lo necesites.
  • Solo las series de pago traen episode_price_cny y full_price_cny, en yuanes. play_count no es un número real de reproducciones, y un valor de 0 no significa que nadie la haya visto.
  • status_text es el texto de estado de actualización tal como lo muestra la página de Douyin, y algunas series no lo tienen.

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_series",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY"
  }
}'

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_series, 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: Microdramas de una cuenta (douyin/user_series).

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_series, y los parámetros dentro de params.
- Parámetros obligatorios:
  - user_id: La cuenta de la que quieres los microdramas: 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_series. 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: series_id, 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…), genres, sub_genres, status_text, episode_count (Cuántos episodios tiene la colección (u…), updated_to_episode, play_count (Real solo en Hot Spot Treasure y mixes), collect_count; 27 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "user_series",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY"
  }
}
- 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_seriesIdentificador de la capacidad, valor fijo.
user_idbody.paramsstringSí-La cuenta de la que quieres los microdramas: 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_series. 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 microdramas.

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": "user_series",  "results": [    {      "series_id": "7709817571482011689",      "name": "短剧 · 远赴边城相见,才知他另有牵挂",      "description": "结婚五年、求子多年的林茵终于等来怀孕。她揣着孕检单坐了二十多个小时车,去西北边城给驻守项目的丈夫贺临惊喜,却在挂满红灯笼的小院里听见另一个孩子喊他爸爸。贺临解释是报答救命恩人、照顾工友遗孀。林茵从画册、照片和招待所登记本里,一点点拼出他在边城的四年。她藏起孕检单追问到项目部,真相浮出——安安与贺临、许曼关系不简单。她不再哭闹,面对以孩子为由的挽留和长辈劝说,她会如何选择?",      "url": "https://www.iesdouyin.com/share/playlet/detail/7709817571482011689/?schema_type=43&object_id=7709817571482011689&from_ssr=1",      "cover_image_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/b78f360b14c95f2af5ee2ac6868adb59~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=GMqnVuqf2dF9fu4Dqn67sGSaVLc%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_tag=aw…",      "genres": [        "其他"      ],      "episode_count": 67,      "updated_to_episode": 0,      "play_count": 0,      "collect_count": 0,      "is_paid": true,      "paid_episode_count": 66,      "icp_number": "(抖音)微短剧备字(2026)第116470号",      "author_id": "MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY",      "author_uid": "•••",      "author_name": "月•••场",      "author_douyin_id": "•••",      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",      "author_is_verified": true,      "author_follower_count": 0,      "created_at": "2026-11-19T09:49:47+00:00",      "updated_at": "2026-11-20T10:08:46+00:00",      "last_episode_at": "2026-11-19T10:30:33+00:00",      "platform": "douyin"    },    {      "series_id": "7709794114602010678",      "name": "短剧 · 我大专毕业当柜姐,亮出实力后他们慌了",      "description": "大专毕业的苏念隐去家世,在珠宝店做柜姐,实则是雕刻泰斗苏万钧的孙女,承袭一手月牙雕刻绝技。她凭实力拿下大客户,却因戳破前男友未婚妻高价买下注油祖母绿的真相,遭投诉刁难。结识方家后,她受邀做订婚宴珠宝顾问,却在鉴定藏品时发现有人调包变卖。停职危机压来,她不肯低头——而鉴赏会上,那个姓氏背后的秘密,才刚刚浮出水面。",      "url": "https://www.iesdouyin.com/share/playlet/detail/7709794114602010678/?schema_type=43&object_id=7709794114602010678&from_ssr=1",      "cover_image_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/56aefa2df51ff3eed392f5c4730b17ef~tplv-dy-resize-walign-adapt-aq:640:q80.webp?lk3s=f3356eed&x-expires=1795417200&x-signature=hLrAC3m%2BXRdN%2BSDVWSL9yEUBCpM%3D&from=4080365293&s=PackSourceEnum_SERIES_PUBLISH&se=false&sc=series_cover&biz_ta…",      "genres": [        "其他"      ],      "episode_count": 96,      "updated_to_episode": 0,      "play_count": 0,      "collect_count": 0,      "is_paid": true,      "paid_episode_count": 95,      "icp_number": "(抖音)微短剧备字(2026)第115873号",      "author_id": "MS4wLjABAAAAxKtExlVPfMALHjIWbFLJ1HhhJUebELJXNU6UQw42-kY",      "author_uid": "•••",      "author_name": "月•••场",      "author_douyin_id": "•••",      "author_avatar_url": "https://p3-pc.douyinpic.com/•••",      "author_is_verified": true,      "author_follower_count": 0,      "created_at": "2026-11-19T08:18:46+00:00",      "updated_at": "2026-11-20T11:03:07+00:00",      "last_episode_at": "2026-11-19T08:32:27+00:00",      "platform": "douyin"    }  ],  "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
series_idConserva el significado de la plataforma
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.
genresConserva el significado de la plataforma
sub_genresConserva el significado de la plataforma
status_textConserva el significado de la plataforma
episode_countCuántos episodios tiene la colección (user_mixes).
updated_to_episodeConserva el significado de la plataforma
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.
is_paidConserva el significado de la plataforma
paid_episode_countConserva el significado de la plataforma
episode_price_cnyConserva el significado de la plataforma
full_price_cnyConserva el significado de la plataforma
icp_numberConserva el significado de la plataforma
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).
last_episode_atConserva 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 series cortas de un autor de Douyin?

Una fila por serie: series_id, name, description, url, genres, status_text, episode_count, updated_to_episode, play_count, collect_count, is_paid, created_at, updated_at y last_episode_at, campos de precio en las series de pago y campos del autor.

¿Cómo leo los episodios de una serie?

Pasa el series_id de una fila a series_posts. Devuelve una fila por episodio.

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

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