tiktok/
search-live

Busque en TikTok LIVE por palabra clave y obtenga las transmisiones que están al aire ahora mismo: ID de sala, ID del anfitrión, título, espectadores actuales, Me gusta y hora de inicio, listos para consultar ventas en vivo.

TikTok Live Search API

Búsqueda por palabra clave
Solo transmisiones al aire
IDs de sala y anfitrión
0.6 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
queryObligatorioPalabra clave con la que se buscan transmisiones LIVE.
results_limitOpcionalCuá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.

  1. Envíe {"query": "deals", "results_limit": 20} por POST a /v1/tiktok/search-live.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. 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.

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.

Explorar otras plataformas

Combine los datos de TikTok con datos públicos de otras plataformas sociales compatibles.

TikTok Live Search API — FAQ

TikTok Live Search API es una interfaz programática para encontrar las transmisiones de TikTok LIVE que están al aire y coinciden con una palabra clave, y results_limit fija cuántas se devuelven. Cada registro trae el ID de sala, el ID del anfitrión, el título, los espectadores actuales, los Me gusta, la portada y la hora de inicio.

Envíe el id de un resultado como room_id y su author.id como user_id a TikTok Live Shopping. Los dos valores deben provenir del mismo resultado.

results_limit acepta de 1 a 200 y vale 20 por defecto, y la lista termina antes si coinciden menos transmisiones. Cada transmisión devuelta se factura a 0.6 créditos, y una búsqueda sin coincidencias no se factura.

No. Lista las transmisiones que estaban al aire cuando usted envió la búsqueda, y todos los registros tienen status en live. Las transmisiones pasadas no se devuelven.

Las transmisiones empiezan y terminan durante todo el día, así que el conjunto al aire cambia entre ejecuciones. Use id como clave de la transmisión y collected_at como la hora de cada consulta.

La solicitud solo recibe query y results_limit. Lea metrics.viewers_count en los resultados y filtre de su lado.

Este endpoint busca por palabra clave. Para una cuenta que ya conoce, use TikTok User Live, que recibe nombres de usuario e informa el estado en vivo de cada uno.