API de Clasificación de espectadores de Douyin

Lee por live_id la lista de espectadores de una sesión de directo de Douyin. Cada fila es un espectador, con rank, nickname, douyin_id, user_id e is_verified, por $0.56 por cada 1000 llamadas.

  • Una llamada da la lista completa, sin paginación.
  • rank empieza en 1 y sigue el orden de la lista.
  • 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": "live_viewers",
      "params": {
        "live_id": "7710380709042457398"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "user_id": "",
          "rank": 1,
          "is_verified": false
        },
        …
      ],
      "count": 106
    }
  3. 3Filas

    user_idrankis_verified
    1false
    2false
  4. 4CSV

    douyin-live_viewers-sample.csv rank,user_id,douyin_id,nickname,avatar_url,is_verified,url,platform

Entra una solicitud con live_id y sale la lista de espectadores de esa sesión; cada fila de results es un espectador, y se muestra como tabla de campos y se puede descargar en CSV.

Qué datos obtienes

La tabla muestra una llamada real para 7710380709042457398, obtenida el 21 de noviembre de 2026, 07:29 (UTC), que devolvió 106 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.

rankuser_iddouyin_idnicknameavatar_urlis_verifiedurlplatform
1五•••伟falsedouyin.com/douyin
2努•••falsedouyin.com/douyin

Casos de uso

  • Ver a los espectadores principales de un directo

    Lee la lista por rank para ver qué cuentas van primero.

  • Identificar las cuentas de los espectadores

    user_id, douyin_id y url apuntan a la cuenta del espectador, y nickname es su nombre visible.

  • Separar las cuentas verificadas

    Lee is_verified para encontrar a los espectadores verificados de la lista.

  • Combinarlo con el detalle de la sesión

    Pasa el mismo live_id a live_session y lee juntos el título, el anfitrión y los «me gusta» de la sesión.

Límites y detalles a tener en cuenta

  • live_id es obligatorio. Es el número de sesión, solo dígitos, que sale del live_id de las filas devueltas por live_room o user_live. Cambia cada vez que la sala empieza un directo y no es el número del enlace de la sala.
  • La lista llega en una llamada, sin paginación.
  • Cuando la sesión termina, en la lista solo quedan unos pocos espectadores.
  • rank empieza en 1 y es el puesto del espectador en la lista.
  • user_id, douyin_id y nickname son datos de la cuenta del espectador, y la muestra los oculta.
  • Una llamada lee la lista de una sesión.

Precios

Pagas $0.000556 por llamada, no por fila, y cada llamada lee la lista completa de una sesió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": "live_viewers",
  "params": {
    "live_id": "7710380709042457398"
  }
}'

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 live_viewers, 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: Clasificación de espectadores (douyin/live_viewers).

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 live_viewers, y los parámetros dentro de params.
- Parámetros obligatorios:
  - live_id: ID numérico de una emisión, tomado del live_id de las filas de live_room o user_live. Cambia cada vez que el anfitrión inicia un directo y no es el número del enlace de la sala.
- 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: rank (Posición desde 1: el puesto en tendenci…), user_id, douyin_id (Douyin ID: el identificador buscable qu…), nickname (Nombre visible de la cuenta), avatar_url, is_verified, url.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "live_viewers",
  "params": {
    "live_id": "7710380709042457398"
  }
}
- 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ílive_viewersIdentificador de la capacidad, valor fijo.
live_idbody.paramsstringSí-ID numérico de una emisión, tomado del live_id de las filas de live_room o user_live. Cambia cada vez que el anfitrión inicia un directo y no es el número del enlace de la sala. Cuando la emisión termina solo quedan unos pocos espectadores en la lista.
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

#
Obtenida el 21 de noviembre de 2026, 07:29 (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": "live_viewers",  "results": [    {      "rank": 1,      "user_id": "•••",      "douyin_id": "•••",      "nickname": "五•••伟",      "avatar_url": "https://p11.douyinpic.com/•••",      "is_verified": false,      "url": "https://www.douyin.com/•••",      "platform": "douyin"    },    {      "rank": 2,      "user_id": "•••",      "douyin_id": "•••",      "nickname": "努•••",      "avatar_url": "https://p11.douyinpic.com/•••",      "is_verified": false,      "url": "https://www.douyin.com/•••",      "platform": "douyin"    }  ],  "count": 106,  "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
rankPosición desde 1: el puesto en tendencias en trending, la posición en el tablero de Xingtu en xingtu_creator_rankings, el puesto en el tablero de búsquedas en billboard_search_hot y el lugar de la sugerencia en el buscador en search_suggest.
user_idIdentificador único del usuario en la plataforma.
douyin_idDouyin ID: el identificador buscable que elige el titular de la cuenta.
nicknameNombre visible de la cuenta.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
is_verifiedSi la plataforma verificó la cuenta. null significa que no se puede determinar.
urlEnlace al registro en 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 espectadores de un directo de Douyin?

Un espectador por fila: rank, user_id, douyin_id, nickname, avatar_url, is_verified y url.

¿Por qué la lista es corta cuando termina el directo?

Cuando la sesión termina, en la lista solo quedan unos pocos espectadores.

¿De dónde sale live_id?

Tómalo de una fila devuelta por live_room o user_live. Es el número de sesión y cambia cada vez que la sala empieza un directo; no es el número del enlace de la sala.

¿Cuánto cuesta leer una lista de espectadores?

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