Necesitas obtener programáticamente los detalles del usuario de TikTok para potenciar los flujos de gestión de usuarios: verificar cuentas durante la incorporación, enriquecer perfiles o reconciliar registros almacenados con datos en vivo. Al final de esta guía, podrás llamar a un verdadero endpoint de “Obtener Información del Usuario”, manejar su respuesta e integrarlo en un flujo de trabajo de producción, con ejemplos funcionales de curl y Python que puedes pegar en tu base de código hoy.
Qué hace esta API y cómo ayuda a la Gestión de Usuarios
La API de Datos de TikTok en Zyla API Hub expone dos endpoints de solo lectura que puedes llamar con una única clave de API:
- Obtener Información del Usuario: devuelve información sobre un usuario de TikTok por
user_id. Este es el bloque de construcción central para tareas de verificación y sincronización de usuarios. - Obtener Información del Video: devuelve metadatos a nivel de video por
url. Esto es útil cuando tu flujo de gestión de usuarios tiene que asociar usuarios con su contenido compartido o validar que una URL de video enviada es válida y pertenece a la cuenta deseada.
Los casos de uso típicos de gestión de usuarios incluyen:
- Validar un
user_idde TikTok proporcionado durante el registro o vincular un perfil existente a una cuenta de cliente. - Enriquecer tu tabla de usuarios con IDs canónicos que puedas utilizar de manera confiable en sistemas posteriores.
- Revisar una URL de video que un usuario proporcionó y correlacionarla con su cuenta antes de otorgar acceso a funciones restringidas.
Accedes a ambos endpoints desde una única cuenta de mercado y clave de API, con facturación basada en suscripción y cuota. La primera API aquí ofrece una prueba de 7 días (o 50 solicitudes). No hay un plan gratuito; consulta la página de la API para opciones de acceso y precios actuales.
Comenzando en Zyla API Hub
Abre la lista de la API de Datos de TikTok en Zyla API Hub, haz clic en Suscribirse o Comenzar Prueba Gratuita cuando esté disponible, y copia tu clave de API. Todas las solicitudes incluyen un único encabezado para autenticación:
- Encabezado:
Authorization: Bearer YOUR_API_KEY
Comienza tu prueba aquí: Comienza prueba de 7 días en la API de Datos de TikTok. Estarás llamando a endpoints de calidad de producción en minutos.
Referencia de endpoints
Obtener Información del Usuario
Usa este endpoint cuando tengas un user_id de TikTok y necesites obtener la información de ese usuario. Este es el centro para la verificación y sincronización de usuarios.
- Método: GET
- URL: https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info
- Parámetro requerido:
user_id(cadena): ID de usuario de TikTok. Ejemplo:107955
Ejemplo oficial de curl:
curl -s -X GET "https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info?user_id=107955" \
-H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta oficial:
{
"code": -1,
"msg": "userinfo is failed! Please check unique_id or user_id.",
"processed_time": 0.1441
}
Notas de campo que realmente usarás:
code: indicador de resultado entero. Un valor negativo aquí indica que la solicitud no devolvió datos de usuario para el identificador proporcionado.msg: mensaje de diagnóstico para ayudar en el manejo de errores (por ejemplo, ID inválido o inexistente).processed_time: tiempo de procesamiento en segundos (flotante). Útil para la observabilidad y la planificación de reintentos.
Consejo de producción: almacena el msg junto a tu intento de validación para que tu equipo de soporte pueda distinguir un ID malformado de una condición de no encontrado al revisar problemas de incorporación de usuarios.
Obtener Información del Video
Usa este endpoint cuando necesites validar o enriquecer una presentación de un usuario que contiene una URL de video de TikTok. Esto es común cuando los usuarios vinculan contenido para probar propiedad o elegibilidad.
- Método: GET
- URL: https://zylalabs.com/api/2516/tiktok-data-api/2504/get-video-info
- Parámetro requerido:
url(cadena): Una URL de video de TikTok en el formato específico que se muestra a continuación.
Nota: La URL del video debe estar en el siguiente formato https://www.tiktok.com/@khaby.lame/video/7411964588809342241. Ejemplo oficial de curl:
Usa los campos devueltos para confirmar que el video existe y para extraer identificadores que te ayuden a correlacionar el contenido con un perfil de usuario en tu sistema. Si recopilas el nombre de usuario de TikTok de un usuario junto con esta URL, puedes verificar ambos antes de permitir una acción como unirse a un programa de creadores o desbloquear funciones avanzadas.
Ejemplo funcional en Python
El fragmento a continuación llama a Obtener Información del Usuario con los parámetros documentados y el esquema de autenticación, luego ramifica en el code para determinar si adjuntar la cuenta de TikTok a tu registro interno de usuario o marcarla para revisión.
import requests
API_KEY = "YOUR_API_KEY"
USER_ID = "107955" # proporciona el user_id que recopilaste durante tu flujo de usuario
url = "https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info"
params = {"user_id": USER_ID}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# Lógica mínima de ramificación para flujos de gestión de usuarios
if isinstance(data, dict) and data.get("code") == 0:
# Ejemplo: persiste la vinculación verificada de TikTok en tu tabla de usuarios
# save_user_tiktok_link(internal_user_id, USER_ID, data)
print("Información del usuario recuperada y almacenada.")
else:
# Registra diagnósticos y alerta a tu soporte o sistema de riesgo
print(f"La verificación del usuario falló para {USER_ID}.")
print(f"code={data.get('code')} msg={data.get('msg')} processed_time={data.get('processed_time')}")
Notas:
- Timeouts: establece uno apropiado para tu entorno; 20 segundos arriba es un ejemplo.
- Reintentos: solo reintenta GETs idempotentes en timeouts a nivel de red o 5xx, no en códigos de error a nivel de aplicación en el JSON.
- Observabilidad: almacena
processed_timecon tu contexto de registro para rastrear desaceleraciones a lo largo del tiempo.
Diseñando flujos de gestión de usuarios alrededor de estos endpoints
A continuación se presentan patrones mínimos pero efectivos que puedes adaptar directamente en tu capa de servicio y colas.
- Registro con ID de TikTok:
- Recoge
user_iden tu formulario y almacénalo en un estado pendiente. - Llama a Obtener Información del Usuario de inmediato; si
codeindica éxito, marca la vinculación como verificada y continúa tu flujo. - Si la respuesta indica un fallo, devuelve un error en línea preciso al usuario basado en
msg, y pon en cola una auditoría de soporte si es necesario.
- Recoge
- Vincular un video de TikTok a un perfil de usuario:
- Recoge una
urlde video del usuario en el formato documentado. - Llama a Obtener Información del Video y confirma que el video se resuelve. Si también tienes el
user_idde TikTok del usuario, correlaciona identificadores de los metadatos del video para mayor seguridad antes de persistir.
- Recoge una
- Re-sincronización periódica:
- Programa un trabajo para revalidar los valores de
user_idalmacenados, usando Obtener Información del Usuario para un conjunto de cuentas de muestra o completo dependiendo de tu cuota. - Registra cambios y alerta a operaciones de producto si una vinculación previamente válida comienza a fallar.
- Programa un trabajo para revalidar los valores de
Consejos operativos que ahorran tiempo
- Autenticación: siempre envía
Authorization: Bearer YOUR_API_KEY. No agregues encabezados adicionales ni intentes clave-en-consulta a menos que esté documentado explícitamente (no lo es para esta API). - Forma de solicitud: ambos endpoints son GET con parámetros de consulta solamente; no hay cuerpo de solicitud.
- Tiempo procesado: el flotante
processed_timeestá en segundos; es útil para paneles de rendimiento y SLOs. - Cacheo: si almacenas búsquedas de usuarios, respeta el hecho de que las identidades visibles para el usuario pueden cambiar. Usa TTL cortos para flujos de verificación críticos, más largos para enriquecimiento no crítico.
- Manejo de errores: ramifica en el
codedel JSON e inspeccionamsgpara orientación visible para el usuario o registro interno; trata los errores de red y los errores a nivel de JSON de manera diferente. - Planificación de cuotas: el mercado utiliza suscripción + cuota (no pago por llamada). La primera API aquí admite una prueba de 7 días o 50 solicitudes para ayudarte a integrar. Monitorea el uso en tu panel de Zyla y dimensiona trabajos por lotes en consecuencia.
Referencia rápida: parámetros y URLs exactos
- Obtener Información del Usuario
- GET https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info
- Params:
user_id(cadena, requerido)
- Obtener Información del Video
- GET https://zylalabs.com/api/2516/tiktok-data-api/2504/get-video-info
- Params:
url(cadena, requerido), formato comohttps://www.tiktok.com/@khaby.lame/video/7411964588809342241
Casos de uso mapeados a endpoints
- Vinculación de cuentas: usa Obtener Información del Usuario para confirmar que la cuenta de TikTok existe antes de guardarla en el perfil de usuario.
- Verificaciones de elegibilidad para funciones de creador: valida una URL de video enviada con Obtener Información del Video, luego procede solo si la búsqueda tiene éxito.
- Herramientas de soporte: agrega un botón “Re-verificar TikTok” en tu administración que llame a Obtener Información del Usuario y muestre
msga tu equipo.
Llama a esta API desde agentes de IA a través de MCP
También puedes invocar estos endpoints HTTP desde herramientas y agentes de desarrollador compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf) usando la puerta de enlace MCP de Zyla. Apunta tu cliente al endpoint MCP y pasa tu clave de API:
- URL de MCP:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Desde tu agente, emite las mismas solicitudes GET HTTPS que se muestran arriba (incluido el encabezado de Autorización). Esto te permite scriptar verificaciones de un clic durante revisiones de código o operaciones impulsadas por runbook sin codificar secretos en scripts locales. Para más información, consulta la documentación: MCP.
Resolución de problemas
- Obteniendo
code: -1en Obtener Información del Usuario: confirma que eluser_idproporcionado es correcto. Muestra elmsga los usuarios de manera amigable (por ejemplo, “Por favor, verifica tu ID de usuario de TikTok”). - Desajustes de URL de video: asegúrate de que la URL siga el formato documentado, incluida la estructura de la ruta. Si capturas parámetros de consulta de idioma (por ejemplo,
?lang=en), mantenlos codificados en URL como en el ejemplo de curl. - HTTP 401: verifica que tu encabezado de Autorización use el esquema Bearer y que la clave no haya expirado o sido rotada.
- Observabilidad: registra
processed_timepara cada solicitud para identificar respuestas lentas intermitentes y afinar reintentos.
Preguntas frecuentes
¿Qué encabezado de autenticación espera la API de Datos de TikTok?
Envía Authorization: Bearer YOUR_API_KEY en cada solicitud.
¿Puedo enviar un cuerpo POST a estos endpoints?
No. Ambos endpoints documentados son GET y aceptan parámetros solo a través de la cadena de consulta.
¿Qué representa processed_time?
Es el tiempo de procesamiento del lado del servidor en segundos para tu solicitud. Úsalo para monitoreo de rendimiento y alertas.
¿Hay un plan gratuito?
No. El mercado utiliza suscripción + cuota, no pago por llamada. La primera API aquí ofrece una prueba de 7 días o 50 solicitudes para que puedas integrar antes de comprometerte. Para opciones de acceso y precios actuales, consulta la página de la API.
¿Qué tan estricto es el formato de la URL del video?
Debes proporcionar una URL en el formato mostrado en la descripción del endpoint (por ejemplo, https://www.tiktok.com/@khaby.lame/video/7411964588809342241). Mantén los parámetros de consulta codificados en URL si están presentes.
Envía tu integración
Ahora tienes las URLs exactas, parámetros y ejemplos funcionales para verificar usuarios de TikTok y validar su contenido enviado dentro de tus flujos de gestión de usuarios. Crea tu cuenta, obtén una clave de API y comienza tu prueba de 7 días aquí: Comienza prueba de 7 días en la API de Datos de TikTok. Una cuenta cubre miles de APIs listas para producción en Zyla API Hub con una única clave y modelo de suscripción.