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.
uidson solo dígitos.- El
user_iddevuelto es el secUid, listo paraprofileyuser_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
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "douyin", "action": "profile_by_id", "params": { "uid": "1929015166249580" } }2Respuesta JSON
{ "results": { "user_id": "", "douyin_id": "63970939507", "bio": "📚英语爱好者\n🧸努力学习英语中\n❤️好好吃饭💛好好睡觉💚好好生活\n🎇文本群里分享视频的文本,有需要的小伙伴可以进群", "follower_count": 48149, … } }3Campos
user_id douyin_id bio follower_count 63970939507 📚英语爱好者 🧸努力学习英语中 ❤️好好吃饭💛好好睡觉💚好好生活 🎇文本群里分享视频的文本,有需要的小伙伴可以进群 48149 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
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_id | douyin_id | nickname | bio | url | follower_count | following_count | like_count | video_count | is_verified | avatar_url | platform | uid |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 63970939507 | 木•••语 | 📚英语爱好者 🧸努力学习英语中 ❤️好好吃饭💛好好睡觉💚好好生活 🎇文本群里分享视频的文本,有需要的小伙伴可以进群 | https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS | 48149 | 21 | 92404 | 212 | false | douyin |
Casos de uso
Convertir a quien comenta en una cuenta que puedes leer
Si solo guardaste el
author_uidde quien comenta, pásalo comouidpara obteneruser_id,follower_countyvideo_count, y lee después su perfil y sus videos.Completar el autor de un video
El
author_uidde una fila de video te da elfollower_county elvideo_countdel autor.Guardar los dos ID de una cuenta
Una cuenta tiene un
uidnumérico y unuser_idcon secUid. Con una sola llamada puedes guardar ambos en tu ficha.Comprobar la verificación
Lee
is_verifiedpara 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.
| Aspecto | Plataforma abierta de Douyin | EveryInfra |
|---|---|---|
| Información pública | La 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 acceso | La 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
uides obligatorio y son solo dígitos. Sale delauthor_uidde las filas de video y de comentario, o deluidde un resultado deprofile.- El resultado trae menos campos que
profile. Por ejemplo, no traegenderniip_location. user_id(el secUid) yuidson dos ID de la misma cuenta, así que guarda los dos.like_countyfollower_countson instantáneas del momento de la llamada.
Precios
Pagas $0.000556 por llamada. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 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
#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.
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
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | 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. |
platform | body | string | Sí | douyin | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | profile_by_id | Identificador de la capacidad, valor fijo. |
uid | body.params | string | Sí | - | 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
#{ "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.
| Campo | Significado |
|---|---|
user_id | Identificador único del usuario en la plataforma. |
douyin_id | Douyin ID: el identificador buscable que elige el titular de la cuenta. |
nickname | Nombre visible de la cuenta. |
bio | Biografía escrita por la cuenta; puede incluir saltos de línea y emoji. |
url | Enlace al registro en la plataforma. |
follower_count | Seguidores. null significa no publicado, no 0. |
following_count | Cuentas seguidas. null significa no publicado, no 0. |
like_count | Me gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0. |
video_count | Nú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_verified | Si la plataforma verificó la cuenta. null significa que no se puede determinar. |
avatar_url | Enlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
uid | ID 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.
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.
Capacidades de Douyin relacionadas
Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Douyin.
- Búsqueda
search$8.33 por cada 1000 llamadasBusca videos de Douyin mediantekeywordy permite escoger ventana de publicación u orden. - Detalles
profile$0.56 por cada 1000 llamadasConsulta una cuenta poruser_idy recoge Douyin ID, apodo, biografía y contadores públicos. - Publicaciones del usuario
user_posts$0.56 por cada 1000 llamadasLista los videos de una cuenta a partir de suuser_id(el secUid), con texto, tipo de medio, duración y métricas. - Detalles del video
video$0.56 por cada 1000 llamadasAbre laurlde un video de Douyin y devuelve contenido, autor, fecha y métricas visibles. - Comentarios
comments$0.56 por cada 1000 llamadasLee comentarios de laurldel video y distingue respuesta, autor, ubicación IP mostrada y reacción del creador cuando existen. - Respuestas a comentarios
comment_replies$0.56 por cada 1000 llamadasLee las respuestas bajo un comentario de primer nivel de un video de Douyin, a partir de laurldel video y elcomment_idde una fila decommentscon respuestas. - Tendencias
trending$0.56 por cada 1000 llamadasConsulta el tablero de tendencias sin entrada obligatoria y permite seleccionarboards. - Transcripción
transcript$0.56 por cada 1000 llamadasExtrae texto disponible del video indicado porurl, junto con metadatos y métricas de la pieza. - Búsqueda de creadores
creator_search$0.56 por cada 1000 llamadasBusca cuentas candidatas mediantekeywordy permite acotar por los valores declarados defollower_rangeyuser_type. - Audiencia del creador
creator_audience$0.56 por cada 1000 llamadasPara unuser_id, consulta la distribución, el TGI y el código de ladimensionelegida; si se omite, usa el rango de precio del dispositivo. - Evolución de seguidores
creator_trend$0.56 por cada 1000 llamadasConsulta para unuser_idla seriefollower_trendy el promedio de seguidores disponibles. - Comparación del creador
creator_benchmark$0.56 por cada 1000 llamadasCompara promedios y percentiles de publicaciones, comentarios, compartidos, crecimiento y me gusta para unuser_id. - Búsqueda de creadores en Xingtu
xingtu_creator_search$0.56 por cada 1000 llamadasBusca registros de creadores de Xingtu mediantekeyword. - Analítica de creador en Xingtu
xingtu_creator_analytics$0.56 por cada 1000 llamadasUsa eldouyin_idvisible devuelto por la acción ordinariacreator_searchpara consultar una ficha analítica de Xingtu;xingtu_creator_searchno proporciona este dato. - Tarifas de creador en Xingtu
xingtu_rate_card$0.56 por cada 1000 llamadasUsa eldouyin_iddevuelto porcreator_search, no la salida dexingtu_creator_search, para consultar losrate_tiersdisponibles de un creador en Xingtu. - Rankings de creadores en Xingtu
xingtu_creator_rankings$0.56 por cada 1000 llamadasSeleccionaindustry,ranking_typeytime_windowpara consultar una instantánea acotada de un ranking de Xingtu. - Búsqueda de productos
product_search$8 por cada 1000 llamadasBusca productos mediantekeyword, hasta 30 por página, y devuelve precio, ventas, tienda, comisión y creadores colaboradores. - Productos de una tienda
shop_products$8 por cada 1000 llamadasLista los productos de una tienda de Douyin Mall a partir de sushop_idnumérico, 10 por página. - Detalles del producto
product_detail$8 por cada 1000 llamadasConsulta un producto mediante unproduct_idnumérico, con galería, variantes, tienda y cifra pública de unidades vendidas. - Productos en directo
live_product_search$0.56 por cada 1000 llamadasBusca productos actualmente en directo mediantekeywordy devuelve sulive_room_idhasta el límite indicado. - Búsqueda de hashtags
hashtag_search$15.56 por cada 1000 llamadasBusca hashtags de Douyin cuyo nombre contienekeyword, ordenados por popularidad. - Detalles del hashtag
hashtag_detail$15.56 por cada 1000 llamadasConsulta un hashtag de Douyin por suhashtag_idnumérico (dehashtag_search): nombre, reproducciones totales desde su creación, usuarios que participan, fecha de creación y enlace para compartir. - Tablero de vídeos en tendencia
billboard_video_hot$0.81 por cada 1000 llamadasLee el tablero de vídeos de Hot Spot Treasure, la herramienta de tendencias del propio Douyin: general (all), de mayor captación de seguidores o de mayor tasa de «me gusta», en la última hora, día, 3 días o 7 días. - Éxitos de cuentas pequeñas
billboard_low_fan_explosion$0.81 por cada 1000 llamadasDetecta obras de cuentas con pocos seguidores que se dispararon en Douyin, según el tablero de éxitos de cuentas pequeñas. - Tablero de visionado completo
billboard_high_completion$0.81 por cada 1000 llamadasMuestra qué obras de Douyin ven los usuarios hasta el final, a partir del tablero de alta tasa de visionado completo. - Tablero de búsquedas en alza
billboard_search_hot$0.81 por cada 1000 llamadasDescubre qué términos suben en el buscador de Douyin. - Búsqueda de cuentas en Hot Spot Treasure
billboard_account_search$0.81 por cada 1000 llamadasEncuentra cuentas de Douyin relacionadas con unakeywordobligatoria, con seguidores, «me gusta» recibidos y número de vídeos. - Búsqueda de música
music_search$8 por cada 1000 llamadasBusca en la biblioteca musical de Douyin por título, artista o nombre del sonido. - Sugerencias del buscador
search_suggest$8 por cada 1000 llamadasObtén las sugerencias que el cuadro de búsqueda de Douyin muestra al escribir unakeyword, en el orden de Douyin y conrankdesde 1. - Temas en ascenso
billboard_rise_list$0.81 por cada 1000 llamadasDetecta los temas que más rápido suben en Douyin, a partir del tablero de ascenso de Hot Spot Treasure. - Tablero de retos
billboard_challenge_hot$0.81 por cada 1000 llamadasLee de una vez el tablero de retos de Hot Spot Treasure: los 50 temas completos. - Hashtags en alza
billboard_topic_hot$0.81 por cada 1000 llamadasMira qué hashtags de Douyin se están calentando en la última hora, día, 3 días o 7 días. - Detalles de la música
music_detail$0.81 por cada 1000 llamadasConsulta una pista de Douyin con elmusic_idnumérico demusic_searcho un enlace douyin.com/music. - Capacidad de conversión en Xingtu
xingtu_conversion_ability$1.6 por cada 1000 llamadasConsulta las cifras de conversión que Xingtu muestra para los vídeos de pedidos de Xingtu de un creador en los últimos 7, 30 o 90 días (time_window, por defecto30d): vídeos relacionados, mediana de reproducciones, clics en el componente y su tasa, CPC, GPM, ventas medias, productos promocionados y sus categorías. - Usuarios conectados por nivel en Xingtu
xingtu_link_structure$16 por cada 1000 llamadasConsulta cuántos usuarios cuenta Xingtu como conectados a un creador de Douyin, repartidos en los cuatro niveles de Xingtu, con su número, su proporción del total y la mediana de los creadores del mismo sector. - Vídeos recomendados en Xingtu
xingtu_recommended_videos$1.6 por cada 1000 llamadasLista los cuatro grupos de vídeos de la página de Xingtu de un creador: vídeos representativos, últimos vídeos, vídeos de pedidos de Xingtu más reproducidos y vídeos personales más reproducidos. - Origen de usuarios conectados en Xingtu
xingtu_touch_distribution$16 por cada 1000 llamadasConsulta de qué categorías de contenido proceden los usuarios conectados de un creador según Xingtu: un árbol de hasta tres niveles, normalmente contenido personal frente a contenido de Xingtu y luego categoría y subcategoría, cada nodo con su recuento. - Rendimiento de vídeos en Xingtu
xingtu_video_performance$16 por cada 1000 llamadasCompara los vídeos personales y los vídeos de pedidos de Xingtu de un creador en tasa de interacción, mediana de reproducciones y tasa de finalización. - Publicaciones en lote
posts_batch$0.56 por cada 1000 llamadasConsulta hasta 20 vídeos de Douyin a la vez conurls, cada uno como ID numérico, enlacehttps://www.douyin.com/video/<ID_de_vídeo>, enlace cortov.douyin.como texto completo de compartir que incluya un enlace corto. - Perfiles en lote
profiles_batch$0.56 por cada 1000 llamadasConsulta hasta 20 cuentas de Douyin a la vez conurls, cada una comosecUid(empieza porMS4w) o enlace de perfilhttps://www.douyin.com/user/<secUid>. - Enlaces de descarga de medios
media_links$0.56 por cada 1000 llamadasObtén enlaces de descarga de hasta 20 vídeos de Douyin a la vez conurls, cada uno como ID numérico o enlacehttps://www.douyin.com/video/<ID_de_vídeo>; no se aceptan enlaces cortos ni textos de compartir. - Publicaciones relacionadas
related_posts$0.56 por cada 1000 llamadasLista los vídeos que Douyin recomienda junto a un vídeo, a partir de suurl: ID numérico, enlacehttps://www.douyin.com/video/<ID_de_vídeo>, enlace cortov.douyin.como texto completo de compartir. - Historial de métricas de una publicación
post_history$0.79 por cada 1000 llamadasLee el historial guardado delike_count,comment_count,share_countycollect_countde un vídeo de Douyin. - Publicaciones que usan una pista
music_posts$0.79 por cada 1000 llamadasLista los vídeos que usan una pista de Douyin, a partir de sumusic_id(tomado delmusic.idde un vídeo o demusic_detail; también vale un enlace douyin.com/music). - Reconocimiento de enlaces
resolve_links$0.79 por cada 1000 llamadasEncuentra enlaces e IDs de Douyin dentro de un texto, por ejemplo un texto completo de compartir. - Historial de tendencias
trending_history$0.79 por cada 1000 llamadasConsulta cómo se movieron los términos en tendencia de Douyin durante las últimas horas. - Colecciones de una cuenta
user_mixes$0.79 por cada 1000 llamadasLista las colecciones (mixes) que ha publicado una cuenta de Douyin, a partir de susecUidenuser_id(una cadenaMS4w) o de un enlacehttps://www.douyin.com/user/<secUid>. - Publicaciones de una colección
mix_posts$0.79 por cada 1000 llamadasLista los vídeos de una colección de Douyin a partir de sumix_id(tomado deuser_mixes; también vale un enlacehttps://www.douyin.com/collection/<ID>). - Resumen de una cuenta
user_overview$1.6 por cada 1000 llamadasObtén un resumen de una cuenta de Douyin a partir de susecUidenuser_id(una cadenaMS4w) o de un enlacehttps://www.douyin.com/user/<secUid>; no se aceptan apodos, Douyin ID ni enlaces cortos. - Sala en directo
live_room$0.79 por cada 1000 llamadasConsulta una sala en directo de Douyin a partir de suroom_idnumérico, el número dehttps://live.douyin.com/<room_id>. - Flujo de publicaciones
feed$0.56 por cada 1000 llamadasLista los vídeos que Douyin recomienda en su página de inicio o en un canal. - Canal de microdramas
series_feed$0.56 por cada 1000 llamadasLista los microdramas del canal de microdramas de Douyin, 16 por página. - Episodios de un microdrama
series_posts$0.79 por cada 1000 llamadasLista los episodios de un microdrama de Douyin a partir de suseries_id, por orden de episodio, hasta 20 por página. - Microdramas de una cuenta
user_series$0.79 por cada 1000 llamadasLista los microdramas que ha publicado una cuenta de Douyin, a partir de susecUidenuser_id(una cadenaMS4w) o de un enlacehttps://www.douyin.com/user/<secUid>, hasta 20 por página. - Comentarios superpuestos en el video
danmaku$0.56 por cada 1000 llamadasLee los comentarios superpuestos (danmaku) de un vídeo de Douyin a partir de suurl: un ID numérico, un enlacehttps://www.douyin.com/video/<ID_de_vídeo>, un enlace cortov.douyin.como un texto completo de compartir que incluya un enlace corto. - Clasificación de espectadores
live_viewers$0.56 por cada 1000 llamadasLee la clasificación de espectadores de una emisión de Douyin a partir de sulive_id: hasta 200 espectadores en una respuesta, cada uno conrank,user_id,douyin_id,nickname,avatar_url,is_verifiedyurl. - Detalles de un microdrama
series_detail$0.79 por cada 1000 llamadasConsulta un microdrama de Douyin a partir de suseries_idnumérico (deseries_feedouser_series; también vale un enlace para compartir). - Detalles de una colección
mix_detail$0.56 por cada 1000 llamadasConsulta una colección (mix) de Douyin a partir de sumix_idnumérico (deuser_mixes; también vale un enlacehttps://www.douyin.com/collection/<ID>). - Detalles de una emisión
live_session$0.79 por cada 1000 llamadasConsulta una emisión de Douyin a partir de sulive_id(de las filas delive_roomouser_live; cambia en cada directo y no es el número del enlace de la sala). - Estado de directo del usuario
user_live$0.79 por cada 1000 llamadasComprueba si un anfitrión de Douyin está en directo ahora, a partir de susecUidenuser_id(una cadenaMS4w) o de un enlacehttps://www.douyin.com/user/<secUid>.