Necesitas obtener programáticamente el perfil y las estadísticas de seguidores de un usuario de TikTok por nombre de usuario, y necesitas que funcione esta semana. Al final de esta guía, recuperarás los detalles del usuario (ID, apodo, verificación, conteos de seguidores y más) utilizando un solo HTTP GET, y sabrás cómo encadenar eso en la recuperación de videos y búsquedas de detalles de elementos.
Por qué esta API y qué devuelve
La API de Medios Públicos de TikTok en Zyla API Hub expone puntos finales de solo lectura para extraer datos públicos de TikTok. Con ella, puedes:
- Resolver un nombre de usuario de TikTok a un perfil completo (ID, secUid, apodo, URLs de avatar, estado de verificación y estadísticas de seguidores).
- Obtener los videos publicados por un usuario a través de su secUid.
- Obtener información detallada de un video o foto específica de TikTok por URL o ID.
Esto es útil para paneles sociales, enriquecimiento de CRM, análisis de creadores, monitoreo de contenido y automatizaciones del lado del servidor que necesitan acceso reproducible a los metadatos públicos de TikTok.
Zyla API Hub centraliza miles de APIs bajo una sola clave y un modelo de suscripción. Puedes explorar más de 10,000 APIs públicas en zylalabs.com y suscribirte sin gestionar múltiples proveedores.
Comenzando en Zyla API Hub
Para probar estos puntos finales, abre la lista de la API de Medios Públicos de TikTok y comienza una prueba. Recibirás una clave API para colocar en el encabezado de Autorización.
- Ve a la lista: Comienza prueba de 7 días en la API de Medios Públicos de TikTok.
- Haz clic en Suscribirse o Comenzar Prueba Gratuita (cuando esté disponible) para obtener tu clave.
- Usa Autorización: Bearer YOUR_API_KEY en cada solicitud.
La facturación es suscripción + cuota (no pago por llamada). Para opciones de acceso y precios actuales, siempre verifica la página de la API. También puedes explorar otras categorías en Zyla API Hub con la misma cuenta y clave.
Puntos finales que usarás
1) Obtener Detalles del Usuario — resolver un nombre de usuario a perfil y estadísticas
Método: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail
Descripción: Recuperar información detallada del perfil de un usuario de TikTok utilizando su nombre de usuario. Devuelve metadatos del usuario como conteo de seguidores, conteo de seguidos y detalles del perfil.
Parámetro requerido: username (cadena)
Ejemplo con nombre de usuario = _ttqueen:
curl -s -X GET "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail?username=_ttqueen" \
-H "Authorization: Bearer YOUR_API_KEY"
Muestra de respuesta oficial:
{
"data": {
"id": "6644110999556227073",
"nickname": "Quynh Truong",
"signature": "Thấy mình đáng iu thì fl mình nhé hehee
💬For work: 097.136.3242",
"hdAvatarUrlList": [
"https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/dcb917fff48aacab462620b08f13b4e0~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=c1870c0f&x-expires=1790154000&x-signature=nO62jhA4bUQvXuz5YAr8WEwl6ns%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a"
],
"uniqueId": "_ttqueen",
"secUid": "MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L",
"isVerified": false,
"statistics": {
"followerCount": 3100000,
"followingCount": 139,
"friendCount": 84,
"heartCount": 117100000,
"videoCount": 559,
"diggCount": 0
}
}
}
Campos clave que realmente usarás:
data.id: ID interno del usuario que puedes almacenar como una clave estable.data.uniqueIdydata.nickname: identificador y nombre para mostrar en la interfaz de usuario.data.hdAvatarUrlList: URLs de avatar de alta calidad.data.isVerified: indicador de verificación.data.statistics: conteos de seguidores/seguidos/corazones/videos para KPIs.data.secUid: requerido para recuperar los videos de un usuario con el siguiente punto final.
2) Obtener lista de videos — listar videos por secUid
Método: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list
Descripción: Recuperar una lista de videos publicados por un usuario de TikTok utilizando su secUid. Devuelve metadatos de video incluyendo IDs, descripciones y estadísticas.
Parámetro requerido: secUid (cadena)
Obtienes secUid de la respuesta de Obtener Detalles del Usuario. Proporciónalo a este punto final para enumerar las publicaciones del creador.
Ejemplo de forma de URL de solicitud (no olvides el encabezado de Autorización):
https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list?secUid=MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L
3) Obtener Detalles de Video o Foto — inspeccionar una publicación específica
Método: GET
URL: https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details
Descripción: Recuperar detalles de video de TikTok por ID o URL incluyendo estadísticas de descripción, información del autor y URLs de medios.
Parámetro requerido: idOrUrl (cadena)
Proporciona una URL de elemento de TikTok o su ID para recibir metadatos detallados de esa única publicación. Ejemplo de valor de parámetro:
https://www.tiktok.com/@khaby.lame/video/7661681676719869214?lang=en
Flujo de trabajo: de nombre de usuario a detalles del usuario (y más allá)
- Llama a Obtener Detalles del Usuario con el nombre de usuario objetivo para resolver:
- Identidad del usuario y avatar: mostrar en tu página de perfil o registro de CRM.
- Conteos de seguidores y videos: poblar métricas e indicadores de salud.
- secUid: almacénalo; lo necesitarás para listar videos.
- Opcionalmente, llama a Obtener lista de videos con el secUid devuelto para enumerar contenido reciente para feeds o análisis.
- Opcionalmente, llama a Obtener Detalles de Video o Foto con una URL o ID de video seleccionado para análisis profundos (por ejemplo, mostrar detalles por publicación al hacer clic).
Ejemplo rápido en Python: obtener detalles del usuario y leer campos clave
Este ejemplo llama a Obtener Detalles del Usuario, extrae la información básica del perfil y las estadísticas de seguidores, y muestra cómo mantener el secUid si planeas obtener videos más tarde.
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BASE_USER_DETAIL = "https://zylalabs.com/api/12389/tiktok-public-media-api/23413/get-user-detail"
def get_user_detail(username: str) -> dict:
url = f"{BASE_USER_DETAIL}?username={username}"
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, timeout=30)
resp.raise_for_status()
return resp.json()
if __name__ == "__main__":
username = "_ttqueen"
data = get_user_detail(username)
user = data.get("data", {})
stats = user.get("statistics", {})
print("User ID:", user.get("id"))
print("Unique ID:", user.get("uniqueId"))
print("Nickname:", user.get("nickname"))
print("Verified:", user.get("isVerified"))
print("Avatar URL:", (user.get("hdAvatarUrlList") or [None])[0])
print("Followers:", stats.get("followerCount"))
print("Following:", stats.get("followingCount"))
print("Hearts:", stats.get("heartCount"))
print("Video Count:", stats.get("videoCount"))
print("secUid (for video list):", user.get("secUid"))
Notas:
- La autorización es un encabezado Bearer con tu clave de la lista de API.
- Siempre verifica si faltan campos antes de indexar para evitar KeyError.
- Persiste
idouniqueIdcomo tu clave foránea local, y guardasecUidsi planeas obtener videos más tarde.
Detalles prácticos que ahorran tiempo
- Autenticación: Todos los puntos finales requieren el encabezado de Autorización exactamente como Autorización: Bearer YOUR_API_KEY.
- Frescura de datos: Trata los conteos de seguidores y corazones como valores en un momento dado. Si almacenas en caché, decide tu cadencia de actualización según las necesidades de tu producto.
- Marcas de tiempo: Al obtener videos, verás valores numéricos de
createdAt. Normalízalos en tu aplicación a tu zona horaria y formato deseados. - Identificadores: Almacena tanto
idcomouniqueIdpara resiliencia;secUides necesario para listar los videos de un usuario. - Manejo de errores: Usa códigos de estado HTTP y la presencia/ausencia de campos para ramificar la lógica. Registra la URL de la solicitud y el nombre de usuario para reintentos.
- Cuotas: La API utiliza un modelo de suscripción + cuota. Verifica la lista para tus límites actuales y la prueba gratuita de 7 días disponible.
Casos de uso que puedes implementar esta semana
- Widget de búsqueda de creadores: Escribe un nombre de usuario, muestra instantáneamente el avatar, la insignia de verificación y el conteo de seguidores.
- Enriquecimiento de CRM: Almacena IDs de TikTok y estadísticas de seguidores junto a los registros de influencers.
- Herramientas de moderación/curaduría: Resuelve un identificador, luego obtiene sus videos para construir colas de revisión o resúmenes destacados.
- Tareas de informes: Tareas nocturnas que actualizan los conteos de seguidores, corazones y videos para alimentar paneles de análisis.
Llamando a esta API desde agentes de IA a través de MCP
Si automatizas con asistentes de código o IDEs agentes, puedes llamar a cualquier API de Zyla a través del punto final MCP. Configura tu cliente compatible con MCP para apuntar a:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Esto hace que la API de Medios Públicos de TikTok sea llamable como una herramienta desde clientes como Claude Code, Cursor, Windsurf y otros. Para más información, consulta la página de MCP.
Encadenando los otros puntos finales (patrones opcionales)
Obtener los videos de un usuario después de resolver el perfil
Una vez que leas secUid de Obtener Detalles del Usuario, envíalo a:
GET https://zylalabs.com/api/12389/tiktok-public-media-api/23414/get-video-list?secUid=MS4wLjABAAAA6e26Ok_w7ReVcKXUIZoygasHXTl9ZPPvhmuTQz1GGRaMU5RLQk6-yftHzzfIfr9L
Usa esto para poblar una pestaña de “Subidas recientes” o para ejecutar análisis a través de los elementos.
Obtener detalles para un elemento específico
Cuando un usuario haga clic en un video en tu interfaz de usuario, obtén detalles profundos pasando la URL o ID de TikTok a:
GET https://zylalabs.com/api/12389/tiktok-public-media-api/23415/get-video-or-photo-details?idOrUrl=https%3A%2F%2Fwww.tiktok.com%2F%40khaby.lame%2Fvideo%2F7661681676719869214%3Flang%3Den
Esto es útil para páginas a nivel de elemento, vistas previas y desenlaces de enlaces del lado del servidor.
Lista de verificación de verificación de un minuto
- El encabezado de autorización está presente y correctamente formateado.
- La cadena de nombre de usuario está codificada en URL cuando es necesario.
- Almacena
id,uniqueIdysecUiddel perfil del usuario para operaciones posteriores. - Maneja de manera elegante los arreglos vacíos como
hdAvatarUrlList. - Registra las URL de las solicitudes para informes de errores reproducibles.
FAQ
¿Cómo autentico mis solicitudes?
Incluye Autorización: Bearer YOUR_API_KEY en cada llamada. Obtén tu clave de la lista de API después de suscribirte o comenzar la prueba.
¿Dónde obtengo el secUid necesario para el punto final de la lista de videos?
Llama a Obtener Detalles del Usuario con el nombre de usuario; la respuesta incluye data.secUid. Usa ese valor con Obtener lista de videos.
¿Puedo pasar una URL de video de TikTok directamente para obtener detalles?
Sí. Usa Obtener Detalles de Video o Foto y establece el parámetro idOrUrl en la URL de TikTok o en el ID del elemento.
¿Cuáles son los precios y cuotas?
El acceso es suscripción + cuota (no pago por llamada). Verifica la página de la API para opciones de acceso actuales. Una prueba de 7 días está disponible en la lista.
¿Hay un Plan Gratuito?
No hay un Plan Gratuito. Usa la prueba de 7 días en la lista para evaluar, luego elige una suscripción que se ajuste a tu uso.
¿Listo para implementar tu integración de detalles de usuario? Obtén tu clave y comienza a probar con los puntos finales oficiales aquí: Comienza prueba de 7 días en la API de Medios Públicos de TikTok. Una cuenta y una clave funcionan en miles de APIs en Zyla API Hub.