API de Estado de directo del usuario de Douyin

Comprueba por user_id (un secUid o un enlace de perfil) si un anfitrión está en directo ahora. Cuando is_live es true, el objeto añade room_id, live_id, title, viewer_count y streams, por $0.79 por cada 1000 llamadas.

  • No se admiten apodos, ID de Douyin ni enlaces cortos.
  • En directo, live_id pasa directamente a live_session y live_viewers.
  • 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_live",
      "params": {
        "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "author_name": "木•••语",
        "is_live": false,
        "author_id": "MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS",
        "author_is_verified": false,
        …
      }
    }
  3. 3Campos

    author_nameis_liveauthor_idauthor_is_verified
    木•••语falseMS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezSfalse
  4. 4CSV

    douyin-user_live-sample.csv room_id,live_id,title,is_live,url,cover_image_url,author_name,author_id,author_douyin_id,author_avatar_url,author_is_verified,like_count,viewer_count,started_at,streams,platform,author_uid,author_follower_count,is_paid

Entra una solicitud con user_id y sale un objeto JSON con campos como is_live y author_name, y room_id y live_id mientras está en directo, que se muestran como tabla de campos y se pueden descargar en CSV.

Qué datos obtienes

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

room_idlive_idtitleis_liveurlcover_image_urlauthor_nameauthor_idauthor_douyin_idauthor_avatar_urlauthor_is_verifiedlike_countviewer_countstarted_atstreamsplatformauthor_uidauthor_follower_countis_paid
nullnullnullfalsenullnull木•••语MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezSfalsenullnullnullnulldouyinnullnull

Casos de uso

  • Detectar cuándo un anfitrión empieza

    Lee is_live a intervalos fijos y, cuando pase a true, anota started_at y title.

  • Encontrar la sala que está en el aire

    Cuando is_live es true, lee room_id y pásalo a live_room para ver el estado de la sala.

  • Enlazar con la sesión y la lista de espectadores

    Pasa live_id a live_session para el detalle de la sesión y a live_viewers para la lista de espectadores.

  • Confirmar la cuenta del anfitrión

    Cuando el anfitrión no está en directo, el objeto sigue trayendo campos de autor como author_name, author_id y author_douyin_id, para confirmar que la cuenta es la que buscabas.

Plataforma abierta de Douyin frente a EveryInfra

Así se comparan la documentación de la Plataforma abierta de Douyin sobre el componente de estado de la sala de directo y user_live de EveryInfra según la cuenta y el acceso que necesitas.

AspectoPlataforma abierta de DouyinEveryInfra
Qué cuentaSobre el parámetro aweme-id, la documentación dice que solo se admiten las cuentas de marca y las cuentas asociadas vinculadas al miniprograma.user_id admite el secUid de un usuario de Douyin (empieza por MS4w) o un enlace de perfil https://www.douyin.com/user/<secUid>. La cuenta no tiene que estar vinculada a un miniprograma.
AccesoLa documentación dice que el desarrollador debe solicitar antes, en la consola de desarrollo, la capacidad del componente de luz de respiración de directo para la cuenta de Douyin.No hay ninguna capacidad que solicitar: la petición lleva solo tu clave de API de EveryInfra y user_id.

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. Fuentes oficiales: Componente de estado de la sala de directo aweme-data

Límites y detalles a tener en cuenta

  • user_id es obligatorio. Pasa el secUid de un usuario de Douyin (empieza por MS4w) o un enlace de perfil https://www.douyin.com/user/<secUid>. No se admiten apodos, ID de Douyin ni enlaces cortos.
  • Solo cuando is_live es true trae el objeto room_id, live_id, title, viewer_count y streams; no existen cuando el anfitrión no está en directo.
  • is_live es el estado en el momento de la llamada. Para detectar que empieza un directo, vuelve a leer a intervalos fijos.
  • streams trae direcciones de emisión firmadas que caducan.
  • is_paid es true cuando la sesión es un directo de pago.
  • Una llamada comprueba a un anfitrión y devuelve un objeto.

Precios

Pagas $0.000792 por llamada, no por campo, y cada llamada comprueba a un anfitrión. 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_live",
  "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_live, 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: Estado de directo del usuario (douyin/user_live).

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_live, y los parámetros dentro de params.
- Parámetros obligatorios:
  - user_id: El anfitrión cuyo estado de directo quieres: 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.
- Devuelve un objeto. Campos principales: room_id (ID de la sala en directo (live_room): e…), live_id (ID de esta emisión en directo (live_roo…), title, is_live (Indica si la cuenta (profile, creator_s…), url, cover_image_url (URL de la imagen de portada: la portada…), author_name, author_id, author_douyin_id (Douyin ID del autor), author_avatar_url (URL del avatar del autor: el creador en…), author_is_verified (Si el autor está verificado (filas de s…), like_count; 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": "user_live",
  "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_liveIdentificador de la capacidad, valor fijo.
user_idbody.paramsstringSí-El anfitrión cuyo estado de directo quieres: 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.

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": "user_live",  "results": {    "is_live": false,    "author_name": "木•••语",    "author_id": "MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS",    "author_douyin_id": "•••",    "author_avatar_url": "https://p3-pc.douyinpic.com/•••",    "author_is_verified": false,    "platform": "douyin",    "author_uid": "•••"  },  "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
room_idID de la sala en directo (live_room): el número de live.douyin.com/<room_id>.
live_idID de esta emisión en directo (live_room); la misma sala recibe uno nuevo cada vez que empieza a emitir.
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
is_liveIndica si la cuenta (profile, creator_search) o la sala (live_room) estaba en directo en el momento de la llamada; es un estado puntual.
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_nameNombre visible del autor.
author_idIdentificador único del autor en la plataforma.
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).
like_countMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
viewer_countPersonas que ven la sala ahora (live_room); una cifra puntual.
started_atCuándo empezó la emisión (live_room, ISO 8601, UTC); no aparece si no se indica.
streamsURL de emisión en directo (live_room): [{quality, format (como flv, hls), url}]. Las URL van firmadas y caducan; no aparecen si la sala no está en directo.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
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_follower_countSeguidores del autor. null significa no publicado.
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 estado de directo de un anfitrión de Douyin?

Un objeto: is_live, author_name, author_id, author_douyin_id, author_avatar_url, author_is_verified y author_uid; en directo, además room_id, live_id, title, url, like_count, viewer_count, started_at, streams e is_paid.

¿Qué devuelve cuando el anfitrión no está en directo?

is_live es false. room_id, live_id, title, viewer_count y streams no existen, y los campos de autor como author_name y author_id siguen estando.

¿Cuándo uso user_live y cuándo live_room?

Usa user_live cuando tienes la cuenta del anfitrión (un secUid o un enlace de perfil) y quieres saber si está en directo. Usa live_room cuando ya tienes el ID de la sala (room_id).

¿Cuánto cuesta comprobar a un anfitrión?

$0.000792 por llamada, o $0.79 por cada 1000 llamadas, según el número de llamadas y no de campos. 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