API de ID de usuario por nombre de TikTok
Convierte un nombre de usuario de TikTok, un enlace de perfil o un sec_uid en el user_id numérico y el sec_uid de la cuenta, junto con username y url, a $0.56 por cada 1000 llamadas.
- Devuelve solo los campos de identificación
user_id,sec_uid,usernameyurl - No incluye datos de perfil como seguidores o biografía
- Las llamadas fallidas y los resultados vacíos no se cobran.
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "tiktok", "action": "resolve_user", "params": { "username": "nasa" } }2Respuesta JSON
{ "results": { "user_id": "", "username": "nasa", … } }3Campos
user_id username nasa 4CSV
tiktok-resolve_user-sample.csv user_id,sec_uid,username,url,platform
username y sale un objeto JSON con solo campos de identificación: user_id, sec_uid, username y url, que se muestra como tabla de campos y se puede descargar en CSV.Qué datos obtienes
La tabla muestra una llamada real para nasa, obtenida el 21 de noviembre de 2026, 07:21 (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 | sec_uid | username | url | platform |
|---|---|---|---|---|
| nasa | https://www.tiktok.com/@nasa | tiktok |
Casos de uso
Convertir nombres de usuario de una lista en ID
Llama una vez por cada nombre de usuario de una lista y guarda
user_idysec_uid, para no tener que buscarlos de nuevo.Obtener el nombre de usuario de un enlace de perfil
Pasa un enlace de perfil y lee
usernamepara obtener el nombre de usuario sin ruta.Volver a convertir un `sec_uid` en nombre de usuario
El parámetro
usernametambién acepta unsec_uid, y losusernameyurldevueltos son el nombre de usuario y el enlace de perfil de esa cuenta.Leer después el perfil de la cuenta
Para seguidores y biografía, pasa
usernameaprofile.
Límites y detalles a tener en cuenta
usernamees obligatorio: un nombre de usuario (como nasa, con o sin @), el enlace de perfil https://www.tiktok.com/@<usuario> o elsec_uidde la cuenta.- Una llamada convierte una cuenta y devuelve un objeto.
- La respuesta no trae seguidores, seguidos ni biografía. Para leer datos de perfil, usa
profile.
Precios
Pagas $0.000556 por llamada. Cada llamada lee un resultado. 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": "tiktok",
"action": "resolve_user",
"params": {
"username": "nasa"
}
}'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 resolve_user, 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 TikTok: ID de usuario por nombre (tiktok/resolve_user).
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 tiktok y action en resolve_user, y los parámetros dentro de params.
- Parámetros obligatorios:
- username: Un nombre de usuario de TikTok como nasa (se quita la @ inicial), un enlace de perfil o el sec_uid de la cuenta.
- Devuelve un objeto. Campos principales: user_id, sec_uid, username, url.
- Cuerpo de solicitud de ejemplo:
{
"platform": "tiktok",
"action": "resolve_user",
"params": {
"username": "nasa"
}
}
- 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í | tiktok | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | resolve_user | Identificador de la capacidad, valor fijo. |
username | body.params | string | Sí | - | Un nombre de usuario de TikTok como nasa (se quita la @ inicial), un enlace de perfil o el sec_uid de la cuenta. |
Ejemplo de respuesta
#{ "id": "req_…", "platform": "tiktok", "action": "resolve_user", "results": { "user_id": "•••", "sec_uid": "•••", "username": "nasa", "url": "https://www.tiktok.com/@nasa", "platform": "tiktok" }, "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. |
sec_uid | Conserva el significado de la plataforma |
username | Nombre de usuario (@usuario). |
url | Enlace al registro en la plataforma. |
platform | Identificador 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.
Preguntas frecuentes
¿Qué devuelve la API de nombre de usuario a ID?
Un objeto: user_id, sec_uid, username y url.
¿Qué endpoint lee seguidores y biografía?
Usa profile para el perfil de la cuenta y followers cuando solo necesitas el número de seguidores. Este endpoint solo convierte identificadores.
¿Cuánto cuesta convertir una cuenta?
Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas. Cada llamada lee un resultado. Las llamadas fallidas y los resultados vacíos no se cobran.
Capacidades de TikTok relacionadas
Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de TikTok, por ejemplo profile.
- Búsqueda
search$0.56 por cada 1000 llamadasBusca en TikTok mediantekeywordy elige la pestaña concontent_type: videos, cuentas o la vista general. - Detalles
profile$0.56 por cada 1000 llamadasResuelve unusernamede TikTok y devuelve biografía, enlace externo, seguidores, seguidos, likes, número de videos y fecha de creación. - Videos del usuario
user_videos$0.56 por cada 1000 llamadasObtiene videos públicos delusernamey permite filtrar por likes mínimos (min_likes), fijar una fecha máxima de publicación (until) u ordenar consort. - Detalles del video
video$0.56 por cada 1000 llamadasAbre laurlde un video de TikTok y recoge texto, autor, fecha y contadores de likes, comentarios, compartidos y vistas. - Comentarios
comments$0.56 por cada 1000 llamadasLee comentarios de laurldel video y distingue respuestas, fijado y reacción del autor cuando existen. - Contenido por hashtag
hashtag$0.56 por cada 1000 llamadasBusca videos publicados bajo elhashtagindicado, con o sin#, conservando autor y métricas por publicación. - Seguidores
followers$0.56 por cada 1000 llamadasRecibeusernamey devuelve contadores y señales de conexión agregadas, conchannelcompatible. - Transcripción
transcript$0.56 por cada 1000 llamadasExtrae el texto disponible del video indicado porurl, con segmentos cuando existen. - Búsqueda de productos de la tienda
shop_search$0.56 por cada 1000 llamadasBusca productos de TikTok Shop mediantekeyword, con país y página opcionales. - Datos del creador de la tienda
shop_creator$0.56 por cada 1000 llamadasConsulta un creador de Shop medianteusernamey país opcional, devolviendo categorías y contadores públicos. - Búsqueda de hashtags
hashtag_search$0.81 por cada 1000 llamadasBusca hashtags de TikTok porkeyword. - Búsqueda de música
music_search$0.81 por cada 1000 llamadasBusca en la biblioteca de sonidos de TikTok porkeyword, como una canción o un artista. - Lista de éxitos musicales
music_chart$0.81 por cada 1000 llamadasLee una lista musical de TikTok:top50(por defecto) oviral50. - Búsqueda de cuentas
user_search$0.56 por cada 1000 llamadasBusca cuentas de TikTok porkeyword, en el orden de la búsqueda de TikTok. - Videos con un sonido
sound_videos$0.56 por cada 1000 llamadasLista los videos de TikTok que usan un sonido, a partir de sumusic_ido del enlace de la página del sonido. - Respuestas a comentarios
comment_replies$0.56 por cada 1000 llamadasLee las respuestas a un comentario de un video de TikTok, con laurldel video y eliddel comentario que devuelvecomments. - Más vendidos de la tienda
shop_hot_products$0.81 por cada 1000 llamadasLee la lista de más vendidos de TikTok Shop de un mercado: ID, JP, MX, MY (por defecto), PH, SG, TH o VN. - Productos de la tienda por categoría
shop_category_products$0.81 por cada 1000 llamadasLista productos de TikTok Shop de una categoría porcategory_id, como 601450 (belleza y cuidado personal), en el mercado elegido. - Cuentas seguidas
following$0.64 por cada 1000 llamadasLista las cuentas que sigue un usuario de TikTok, por su usuario. - Enlaces de descarga del video
video_download$0.64 por cada 1000 llamadasObtiene los enlaces de descarga de un video de TikTok sin marca de agua, a partir de suurl. - Sala en directo
live_room$0.81 por cada 1000 llamadasComprueba si una cuenta de TikTok está en directo ahora, por su usuario. - Productos de una tienda
shop_products$0.81 por cada 1000 llamadasLista los productos de una tienda de TikTok Shop a partir de sushop_ido del enlace de la tienda, en el mercado elegido. - Reseñas de un producto de la tienda
shop_product_reviews$0.76 por cada 1000 llamadasLee reseñas de compradores de un producto de TikTok Shop a partir de suproduct_ido enlace. - Hashtags en tendencia
trending_hashtags$0.81 por cada 1000 llamadasLee los hashtags en tendencia de TikTok en un mercado durante los últimos 7, 30 o 90 días, opcionalmente de un sector. - Reconocimiento de enlaces
resolve_links$0.56 por cada 1000 llamadasLee el ID del video de un enlace de TikTok enurl, incluidos los enlaces cortos de vm.tiktok.com y vt.tiktok.com. - Detalles del hashtag
hashtag_detail$0.56 por cada 1000 llamadasConsulta un hashtag de TikTok a partir dehashtag(el nombre, con o sin #, un enlace de la etiqueta o el ID numérico):hashtag_id,hashtag_name,url,video_countyview_countexactos, eis_commercial. - Detalles de la música
music_detail$0.56 por cada 1000 llamadasConsulta un sonido de TikTok pormusic_ido enlace:title,author_name,album,duration_seconds, cuántos videos lo usan (use_count),is_original,is_copyrighted, un enlace de portada y un enlace de audio de muestra que caduca.