API de Perfil por ID numérico de Douyin

Si solo tienes un UID numérico (el author_uid de las filas de video y de comentario), pásalo como uid y obtén user_id, douyin_id, nickname, follower_count y video_count de la cuenta, por $0.56 por cada 1000 llamadas.

  • uid son solo dígitos.
  • El user_id devuelto es el secUid, listo para profile y user_posts.
  • 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": "profile_by_id",
      "params": {
        "uid": "1929015166249580"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "user_id": "",
        "douyin_id": "63970939507",
        "bio": "📚英语爱好者\n🧸努力学习英语中\n❤️好好吃饭💛好好睡觉💚好好生活\n🎇文本群里分享视频的文本,有需要的小伙伴可以进群",
        "follower_count": 48149,
        …
      }
    }
  3. 3Campos

    user_iddouyin_idbiofollower_count
    63970939507📚英语爱好者 🧸努力学习英语中 ❤️好好吃饭💛好好睡觉💚好好生活 🎇文本群里分享视频的文本,有需要的小伙伴可以进群48149
  4. 4CSV

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

Entra una solicitud con uid y sale un objeto JSON con campos como user_id, nickname y follower_count, que se muestra como tabla de campos y se puede descargar en CSV.

Qué datos obtienes

La tabla muestra una llamada real para 1929015166249580, 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.

user_iddouyin_idnicknamebiourlfollower_countfollowing_countlike_countvideo_countis_verifiedavatar_urlplatformuid
63970939507木•••语📚英语爱好者 🧸努力学习英语中 ❤️好好吃饭💛好好睡觉💚好好生活 🎇文本群里分享视频的文本,有需要的小伙伴可以进群https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS481492192404212falsedouyin

Casos de uso

  • Convertir a quien comenta en una cuenta que puedes leer

    Si solo guardaste el author_uid de quien comenta, pásalo como uid para obtener user_id, follower_count y video_count, y lee después su perfil y sus videos.

  • Completar el autor de un video

    El author_uid de una fila de video te da el follower_count y el video_count del autor.

  • Guardar los dos ID de una cuenta

    Una cuenta tiene un uid numérico y un user_id con secUid. Con una sola llamada puedes guardar ambos en tu ficha.

  • Comprobar la verificación

    Lee is_verified para saber si la cuenta está verificada.

Plataforma abierta de Douyin frente a EveryInfra

Así se comparan la documentación de gestión de usuarios de la Plataforma abierta de Douyin y profile_by_id de EveryInfra al leer información pública de usuarios.

AspectoPlataforma abierta de DouyinEveryInfra
Información públicaLa documentación dice que la interfaz devuelve la información pública de un usuario de Douyin.Por uid numérico devuelve nickname, bio, follower_count, following_count, like_count, video_count e is_verified.
Condiciones de accesoLa documentación dice que los desarrolladores externos que han solicitado el permiso de gestión de usuarios y cuentan con la autorización del usuario pueden obtener los datos.Llamas con una clave de API de EveryInfra. uid sale del author_uid de las filas de video y de comentario, o del uid de un resultado de profile.

La documentación de Douyin está en chino. La tabla muestra una traducción de la página de gestión de usuarios, cotejada el 2026-11-22. La página no indica fecha de actualización. Describe el Open ID, el Union ID, el apodo y el avatar de un usuario autorizado. No describe la lectura de un perfil público por UID numérico. Fuentes oficiales: Gestión de usuarios

Límites y detalles a tener en cuenta

  • uid es obligatorio y son solo dígitos. Sale del author_uid de las filas de video y de comentario, o del uid de un resultado de profile.
  • El resultado trae menos campos que profile. Por ejemplo, no trae gender ni ip_location.
  • user_id (el secUid) y uid son dos ID de la misma cuenta, así que guarda los dos.
  • like_count y follower_count son instantáneas del momento de la llamada.

Precios

Pagas $0.000556 por llamada. 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": "profile_by_id",
  "params": {
    "uid": "1929015166249580"
  }
}'

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 profile_by_id, 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: Perfil por ID numérico (douyin/profile_by_id).

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 profile_by_id, y los parámetros dentro de params.
- Parámetros obligatorios:
  - uid: UID numérico de la cuenta de Douyin: el author_uid de las filas de vídeos y comentarios, o el uid de profile.
- Devuelve un objeto. Campos principales: 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, uid (ID numérico de usuario (profile / creat…).
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "profile_by_id",
  "params": {
    "uid": "1929015166249580"
  }
}
- 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íprofile_by_idIdentificador de la capacidad, valor fijo.
uidbody.paramsstringSí-UID numérico de la cuenta de Douyin: el author_uid de las filas de vídeos y comentarios, o el uid de profile.

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": "profile_by_id",  "results": {    "user_id": "•••",    "douyin_id": "63970939507",    "nickname": "木•••语",    "bio": "📚英语爱好者\n🧸努力学习英语中\n❤️好好吃饭💛好好睡觉💚好好生活\n🎇文本群里分享视频的文本,有需要的小伙伴可以进群",    "url": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS",    "follower_count": 48149,    "following_count": 21,    "like_count": 92404,    "video_count": 212,    "is_verified": false,    "avatar_url": "https://p11.douyinpic.com/•••",    "platform": "douyin",    "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
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).
uidID numérico de usuario (profile / creator_search). user_id es el secUid; ambos identifican la misma cuenta.

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 perfil por UID?

Un objeto de cuenta: user_id, douyin_id, nickname, bio, url, follower_count, following_count, like_count, video_count, is_verified, avatar_url y uid.

¿Cuándo uso profile_by_id y cuándo profile?

Si tienes un secUid, usa profile; devuelve más campos. Si solo tienes el uid numérico, usa antes profile_by_id para obtener el secUid y sigue desde ahí.

¿Cuánto cuesta una llamada?

Cuesta $0.000556 por llamada, 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