TikTok Live Search
Una sala de TikTok LIVE es una transmisión en curso, identificada por un ID de sala, con un título, un anfitrión, un conteo de espectadores en tiempo real, los Me gusta acumulados y una hora de inicio. Cruzar esas salas con una palabra clave muestra quién está en vivo sobre un tema en este momento y qué tan grande es cada audiencia, que es el punto de partida de la investigación de ventas en vivo, la búsqueda de anfitriones y el seguimiento de la actividad en vivo alrededor de una marca.
Funcionalidades de la TikTok Live Search API
- Una palabra clave, las transmisiones al airequery recibe una palabra clave y devuelve las transmisiones que se emiten en ese instante, cada una con status en live.
- ID de sala e ID del anfitrión en un registroid es el ID de la sala y author.id el ID de usuario del anfitrión, los dos valores que TikTok Live Shopping necesita para listar los productos de esa transmisión.
- Audiencia al momento de la recolecciónmetrics.viewers_count es cuánta gente hay en la sala y metrics.likes_count los Me gusta que ha reunido, con la marca de tiempo collected_at.
- Título, hora de inicio, portada y página LIVECada registro incluye el título de la transmisión, su hora de inicio en published_at, la imagen de portada en media y un enlace a la página LIVE del anfitrión en url, además del usuario, el nombre visible y el avatar del anfitrión.
Parámetros de la TikTok Live Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave con la que se buscan transmisiones LIVE. |
results_limit | Opcional | Cuántas transmisiones se devuelven, de 1 a 200. El valor predeterminado es 20. |
Cómo usar la TikTok Live Search API
Busque una palabra clave y lea las transmisiones que están en vivo ahora.
- Envíe {"query": "deals", "results_limit": 20} por POST a /v1/tiktok/search-live.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea las transmisiones en results.items y devuelva results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"deals","results_limit":20}'
# id is the room ID; author.id is the host ID for TikTok Live Shopping.Casos de uso de la TikTok Live Search API
- Vigilar las ventas en vivo de la competencia: Busque las palabras de producto que los vendedores dicen al aire, como deals, y envíe el id y el author.id de cada sala a TikTok Live Shopping para leer qué productos están ofreciendo.
- Medir la actividad en vivo en torno a una palabra clave: Ejecute la misma consulta de forma periódica y registre cuántas transmisiones están al aire y su viewers_count, para ver cuándo un tema o una marca atrae audiencias en vivo.
- Armar una lista de anfitriones para colaborar: Reúna a los anfitriones que están en vivo sobre su tema y ordénelos por viewers_count y likes_count antes de contactarlos.
Consejos de expertos para la TikTok Live Search API
- Busque varias formulaciones de un mismo nicho y combine las listas por id, porque cada palabra clave devuelve su propio conjunto de transmisiones y una misma transmisión puede coincidir con más de una.
- Guarde id y author.id por separado: id identifica una transmisión concreta y author.id al anfitrión, así que siga a un anfitrión entre días con author.id.
- Para seguir los espectadores de una sola sala a lo largo del tiempo, pase de las búsquedas repetidas a TikTok Live Room Info con ese room_id y user_id.
APIs relacionadas
Además de la TikTok Live Search API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.
- TikTok Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, indicadores de cuenta y conteos de audiencia.
- TikTok Hashtags API — Recolecta videos públicos, creadores, contenido multimedia, sonido e interacción de los hashtags indicados.
- TikTok Search API — Busca videos públicos por palabra clave con filtros de orden y de publicación compatibles.
- TikTok Live Room Info API — Consulta una transmisión en vivo conocida mediante el par de IDs de la sala y del propietario, y devuelve su estado, el contexto del propietario, la portada y los conteos de audiencia.
- TikTok Search Users API — Busca cuentas públicas de TikTok por palabra clave.
- TikTok Live Shopping API — Enumera los productos de la bolsa de compras de una transmisión en vivo, con precios actuales y unidades vendidas.
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API