ES
Empezar

TikTok · Posts and media

API de scraping de Estado del directo de TikTok

El endpoint de Estado del directo de TikTok es una llamada a la API: envía un nombre de usuario con tu clave de HProxy y recibe un objeto JSON limpio y estructurado. Comprueba si un creador de TikTok está en directo ahora mismo, con el número de espectadores, el título de la retransmisión y las URL de reproducción en cada calidad. HProxy gestiona los proxies, las sesiones, los antibots y el procesado en el servidor, así que no hay ningún navegador sin interfaz que vigilar ni ningún procesador que arreglar cuando TikTok cambia su código. Tú solo tocas el JSON.
Consigue tu clave de APIReferencia de la API de TikTok
  • 0.15¢ por llamada
  • 1,49 $ por cada 1.000
  • Acepta un nombre de usuario
  • Los errores y los tiempos de espera agotados no se cobran

La llamada

Un GET, y estado del directo vuelve como JSON.

Tu clave va en una cabecera. 1 required parameter, and the answer is the object below it.

La referencia completa
curl "https://hproxy.com/api/v1/scrape/tiktok/live-status?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"
Respuesta200 OK · JSON
{
  "isLive": true,
  "title": "building the thing, live",
  "viewerCount": 4213,
  "startedAt": "2026-07-29T17:02:00Z",
  "playbackUrls": { "hd": "https://.../hd.m3u8", "sd": "https://.../sd.m3u8" }
}

Lo que vuelve

El objeto de estado del directo de TikTok.

isLive
Si el creador está retransmitiendo ahora mismo.
viewerCount
Espectadores simultáneos actuales.
title / startedAt
Título de la retransmisión y cuándo empezó.
playbackUrls
URL de la retransmisión en cada calidad disponible.

Lo que acepta

Parameters.

handlestringRequiredtiktok

Nombre de usuario de la cuenta o @usuario.

trimbooleantrue

Devolver una respuesta reducida (sin los campos extensos).

Cómo funciona

Scraping de estado del directo de TikTok, en tres pasos.

Tú escribes una línea. Los proxies, los muros antibots, el renderizado y el procesado ocurren en nuestro lado.

  1. 1

    Crea una cuenta gratis

    Regístrate y recarga la cantidad que quieras. El saldo sirve para todos los productos de HProxy.
  2. 2

    Coge tu clave de API

    Una clave del panel autentica todos los scrapers.
  3. 3

    Llama al endpoint

    Envía el GET que necesites y lee el JSON. Esa es toda la integración.

Lo que construye la gente con ello

Dónde vale la pena el endpoint de estado del directo de TikTok.

  • Avisa a una comunidad en el segundo en que un creador empieza un directo.
  • Sigue los espectadores simultáneos de un grupo de creadores.
  • Lanza automatizaciones según el estado en directo.

Preguntas sobre estado del directo de TikTok

Respondido antes de que preguntes.

La referencia

Envía una petición HTTPS autenticada al endpoint de Estado del directo de TikTok con un nombre de usuario y tu clave de API de HProxy. Comprueba si un creador de TikTok está en directo ahora mismo, con el número de espectadores, el título de la retransmisión y las URL de reproducción en cada calidad. Sin proxies, sin navegador sin interfaz y sin procesar nada en tu lado. La respuesta es JSON listo para usar.

Este endpoint cuesta 0.15¢ por llamada correcta, que son 1,49 $ por cada 1.000. Se cobra de tu saldo de HProxy sin suscripción y sin mínimo mensual. Los errores se reintentan y nunca se cobran; una consulta cuyo objetivo no existe cuenta como llamada.

La API solo accede a datos públicos de TikTok, las mismas páginas que cualquiera puede abrir en un navegador. Eres responsable de usar los datos conforme a las leyes aplicables y a las condiciones de TikTok para tu caso de uso.

Un objeto JSON estructurado con todos los datos de estado del directo que TikTok expone públicamente. Mira los campos listados arriba. El esquema es constante entre llamadas, así que integras una vez y puedes fiarte de él.

No. Cada llamada funciona por detrás en la propia red residencial de HProxy, así que las peticiones parecen usuarios reales. La capa de proxy ya está incluida en el precio por llamada.

Documentación e IA

Conecta tu scraper a una IA cuando quieras.

Toda la API de scrapers está publicada en markdown, así que un asistente lee cada endpoint, cada parámetro y una respuesta real sin clave y escribe tu integración. Y como un scrape es un GET que responde en JSON, un agente puede ejecutar el scraper por su cuenta, con su propio horario y con tu clave.

Leer la documentación de los scrapersConfigura tu asistente

Claude, ChatGPT, Cursor, Gemini, Copilot, Windsurf, Perplexity, Ollama y cualquier asistente compatible con MCP.

Un agente puede llamarla

Un GET con tu clave devuelve JSON estructurado, así que un agente hace scraping con su propio horario. Sin navegador que manejar ni parser que mantener vivo entre ejecuciones.

Ver los endpoints

Servidor MCP y CLI

Hecho por nosotros para las herramientas gratis y alojado en mcp.hproxy.com: la lista de proxies, el comprobador y la consulta de IPs como herramientas en Claude, ChatGPT, Cursor o cualquier asistente compatible con MCP. Nada que instalar, sin clave.

Añádelo a tu asistente

Documentación de la API

Cada endpoint de scraping documentado de principio a fin, con los parámetros que acepta y la respuesta que devuelve de verdad.

Leer la documentación

Más sobre la API de Estado del directo de TikTok

Qué devuelve el endpoint Estado del directo de TikTok

Comprueba si un creador de TikTok está en directo ahora mismo, con el número de espectadores, el título de la retransmisión y las URL de reproducción en cada calidad. El objeto JSON incluye isLive, viewerCount, title / startedAty playbackUrls. En nuestro lado no se resume ni se recorta nada, así que lo que lees en la respuesta es lo que contiene la propia página de estado del directo en TikTok.

Qué envías a la API Estado del directo de TikTok

La llamada necesita un nombre de usuario. Obligatorio: handle. Opcional: trim. Tu clave viaja en la cabecera X-API-Key, la respuesta es JSON y la llamada se cobra a 0.15¢, 1,49 $ por cada 1.000.

Publicaciones y archivos en otras plataformas

Los mismos datos de publicaciones y archivos están disponibles en 13 plataformas más: Facebook Reels del perfil, YouTube Vídeos del canal, Instagram Publicación, LinkedIn Publicaciones de la empresa, Twitter / X Tweets del usuario, Reddit Publicaciones del subreddit, Threads Publicaciones del usuario, Pinterest Pin, Twitch Vídeos del usuario, Bluesky Publicaciones del usuario, Spotify Canción, Truth Social Publicaciones del usuarioy Kick Clip. Comparten la forma del JSON de este endpoint, su cobro por llamada y tu única clave de API, así que pasar de TikTok a otra red es cambiar una URL y no hacer una segunda integración.

¿Está permitido hacer scraping de estado del directo de TikTok?

El endpoint lee datos públicos de TikTok, las mismas páginas que cualquiera puede abrir en un navegador sin iniciar sesión. No toca cuentas privadas ni nada que esté detrás de una contraseña. Cómo uses después los datos te toca a ti mantenerlo dentro de la ley, según las normas que se te aplican a ti y a TikTok.

Listos cuando tú lo estés.

Tu panel está a diez segundos. Sin llamada comercial, sin suscripción, sin mínimo.