API de Perfiles en lote de Douyin

Lee los perfiles públicos de varios autores de Douyin de una vez con urls: nickname, bio, follower_count, following_count, like_count y video_count. Cada elemento de urls es una llamada, a $0.56 por cada 1000 llamadas.

  • Cada elemento es un secUid (empieza por MS4w) o un enlace de perfil de usuario.
  • No se aceptan apodos, IDs de Douyin ni enlaces cortos.
  • 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": "profiles_batch",
      "params": {
        "urls": [
          "https://www.douyin.com/user/<SEC_UID_A>",
          "<SEC_UID_B>"
        ]
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "user_id": string,
          "douyin_id": string,
          "nickname": string,
          "bio": string
        },
        …
      ]
    }
  3. 3Filas

    user_iddouyin_idnicknamebio
    stringstringstringstring
  4. 4CSV

    douyin-profiles_batch-sample.csv user_id,douyin_id,nickname,bio,url,follower_count,following_count,like_count,video_count,is_verified,avatar_url,platform,input

Entra una solicitud con urls y sale una fila por autor; input 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
user_idstringIdentificador único del usuario en la plataforma.
douyin_idstringDouyin ID: el identificador buscable que elige el titular de la cuenta.
nicknamestringNombre visible de la cuenta.
biostringBiografía escrita por la cuenta; puede incluir saltos de línea y emoji.
urlstringEnlace al registro en la plataforma.
follower_countnumberSeguidores. null significa no publicado, no 0.
following_countnumberCuentas seguidas. null significa no publicado, no 0.
like_countnumberMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
video_countnumberNúmero de videos: los de la cuenta en profile, profiles_batch, user_overview y billboard_account_search, y los relacionados con la entrada en trending.
is_verifiedbooleanSi la plataforma verificó la cuenta. null significa que no se puede determinar.
avatar_urlstringEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
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

  • Crear fichas para una lista de creadores

    Pon en urls los secUid de tu lista, lee nickname, bio y douyin_id, y empareja las filas con la lista mediante input.

  • Actualizar los seguidores de forma periódica

    Lee follower_count cada cierto tiempo y resta para ver quién de la lista crece más rápido.

  • Comprobar la verificación

    Lee is_verified para separar las cuentas verificadas del resto.

  • Encontrar al autor en un texto de compartir

    Cuando un texto contiene un enlace de perfil de usuario, usa primero resolve_links para hallar el secUid y ponlo luego en urls.

Plataforma abierta de Douyin frente a EveryInfra

Así se comparan la solución de acceso a la información de usuario de la plataforma abierta de Douyin y profiles_batch de EveryInfra en el acceso.

AspectoPlataforma abierta de DouyinEveryInfra
De quién es el perfilLa documentación indica que la solución lee la información pública de Douyin de un usuario, como el apodo y el avatar, y el apodo y el avatar públicos en Xigua y Toutiao.urls lleva el secUid o el enlace de perfil de cada autor que quieres leer, y las filas devuelven nickname, bio, follower_count, video_count y más. Los autores no tienen que autorizar nada.
Acceso necesarioLa documentación indica que los datos están disponibles para los desarrolladores externos que han completado la solicitud del permiso, cuando el usuario lo ha autorizado.Una clave de API de EveryInfra en la cabecera Authorization: Bearer. No solicitas ningún permiso de gestión de usuarios.

La documentación de la plataforma abierta de Douyin está en chino; la tabla muestra una traducción, cotejada con su solución de acceso a la información de usuario el 2026-11-22. La página no indica fecha de actualización. La documentación no describe la lectura por lotes de perfiles públicos de autores cualesquiera, así que aquí se comparan de quién es el perfil y el acceso necesario. Fuentes oficiales: Solución de acceso a la información de usuario

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 debe ser un secUid (empieza por MS4w) o un enlace de perfil de usuario, https://www.douyin.com/user/<secUid>; no se aceptan apodos, IDs de Douyin ni enlaces cortos.
  • 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.
  • follower_count, video_count y los demás contadores son los valores del momento de la lectura.
  • 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": "profiles_batch",
  "params": {
    "urls": [
      "https://www.douyin.com/user/<SEC_UID_A>",
      "<SEC_UID_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 profiles_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: Perfiles en lote (douyin/profiles_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 profiles_batch, y los parámetros dentro de params.
- Parámetros obligatorios:
  - urls: Las cuentas que quieres leer, en una lista de hasta 20 entradas; cada entrada solo puede aparecer una vez. Cada entrada es un secUid (empieza por MS4w) o un enlace de perfil https://www.douyin.com/user/<secUid>.
- 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: user_id, douyin_id (Douyin ID: el identificador buscable qu…), nickname (Nombre visible de la cuenta), bio, url, follower_count, following_count, like_count, video_count (Número de videos: los de la cuenta en p…), is_verified, avatar_url, input (La entrada de urls a la que responde es…).
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "profiles_batch",
  "params": {
    "urls": [
      "https://www.douyin.com/user/<SEC_UID_A>",
      "<SEC_UID_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íprofiles_batchIdentificador de la capacidad, valor fijo.
urlsbody.paramsarraySí-Las cuentas que quieres leer, en una lista de hasta 20 entradas; cada entrada solo puede aparecer una vez. Cada entrada es un secUid (empieza por MS4w) o un enlace de perfil https://www.douyin.com/user/<secUid>. No se aceptan apodos, Douyin ID ni enlaces cortos. Se cobra por cuenta; las 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": "profiles_batch",  "results": [    {      "user_id": …,      "douyin_id": …,      "nickname": …,      "bio": …,      "url": …,      "follower_count": …,      "following_count": …,      "like_count": …,      "video_count": …,      "is_verified": …,      "avatar_url": …,      "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
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.
bioBiografía escrita por la cuenta; puede incluir saltos de línea y emoji.
urlEnlace al registro en la plataforma.
follower_countSeguidores. null significa no publicado, no 0.
following_countCuentas seguidas. null significa no publicado, no 0.
like_countMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
video_countNúmero de videos: los de la cuenta en profile, profiles_batch, user_overview y billboard_account_search, y los relacionados con la entrada en trending.
is_verifiedSi la plataforma verificó la cuenta. null significa que no se puede determinar.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
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 perfiles por lotes de Douyin?

Una fila por cada autor leído: user_id, douyin_id, nickname, bio, url, follower_count, following_count, like_count, video_count, is_verified y avatar_url, además de input.

¿Sirve si solo tengo un ID de Douyin o un apodo?

No. Este endpoint acepta solo un secUid o un enlace de perfil de usuario, no un apodo, un ID de Douyin ni un enlace corto.

¿Cómo obtengo un secUid a partir de un texto de compartir?

Usa primero resolve_links. Cuando el texto contiene un enlace de perfil de usuario, reconoce al usuario, y resource_id es el secUid.

¿Cómo se factura un lote de perfiles?

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