tiktok/
search-live

Recherchez des lives TikTok par mot-clé et obtenez les diffusions en cours : ID de la salle, ID de l’hôte, titre, spectateurs actuels, likes et heure de début, prêts pour les recherches sur le live shopping.

TikTok Live Search API

Recherche par mot-clé
Lives en cours uniquement
ID de salle et d’hôte
0,6 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

TikTok Live Search

Une salle de TikTok LIVE correspond à une diffusion en cours, identifiée par un ID de salle et dotée d’un titre, d’un hôte, d’un nombre de spectateurs en temps réel, de likes cumulés et d’une heure de début. Rapprocher ces salles d’un mot-clé montre qui est en direct sur un sujet à cet instant et quelle audience chacun rassemble, ce qui est le point de départ du live shopping, du repérage d’hôtes et du suivi de l’activité live autour d’une marque.

Fonctionnalités de la TikTok Live Search API

  • Un mot-clé en entrée, des lives en cours en sortiequery prend un mot-clé et renvoie les diffusions en cours à cet instant, chacune avec status réglé sur live.
  • ID de salle et ID d’hôte dans le même enregistrementid est l’ID de la salle et author.id l’ID utilisateur de l’hôte : ce sont les deux valeurs dont TikTok Live Shopping a besoin pour lister les produits de ce live.
  • L’audience au moment de la collectemetrics.viewers_count indique le nombre de personnes présentes dans la salle et metrics.likes_count les likes accumulés, le tout horodaté par collected_at.
  • Titre, heure de début, couverture et page LIVEChaque enregistrement contient le titre du live, son heure de début dans published_at, l’image de couverture dans media et un lien vers la page LIVE de l’hôte dans url, ainsi que l’identifiant, le nom affiché et l’avatar de l’hôte.

Paramètres de la TikTok Live Search API

ParamètresObligatoireDescription
queryObligatoireMot-clé pour lequel chercher des lives.
results_limitFacultatifNombre de lives à renvoyer, de 1 à 200. 20 par défaut.

Comment utiliser la TikTok Live Search API

Cherchez un mot-clé et lisez les lives en cours.

  1. Envoyez {"query": "deals", "results_limit": 20} en POST à /v1/tiktok/search-live.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les lives dans results.items et renvoyez results.next_cursor tant que has_more vaut 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.

Cas d’usage de la TikTok Live Search API

  • Repérer les ventes en live de vos concurrents : Cherchez les mots de produit que les vendeurs prononcent à l’antenne, par exemple deals, puis transmettez id et author.id de chaque salle à TikTok Live Shopping pour lire le contenu du panier.
  • Mesurer l’activité live autour d’un mot-clé : Relancez la même requête à intervalles réguliers et consignez le nombre de lives en cours et leur viewers_count, pour voir quand un sujet ou une marque attire des audiences en direct.
  • Présélectionner des hôtes pour des collaborations : Rassemblez les hôtes en direct sur votre sujet et classez-les par viewers_count et likes_count avant de les contacter.

Conseils d’expert pour la TikTok Live Search API

  • Cherchez plusieurs formulations de la même niche et fusionnez les listes sur id : chaque mot-clé renvoie son propre ensemble de lives, et un live peut répondre à plusieurs requêtes.
  • Stockez id et author.id séparément : id identifie une diffusion et author.id l’hôte, ce qui permet de suivre un hôte d’un jour à l’autre grâce à author.id.
  • Pour suivre les spectateurs d’une seule salle dans le temps, passez des recherches répétées à TikTok Live Room Info avec ce room_id et ce user_id.

En complément de la TikTok Live Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok.

  • TikTok Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, indicateurs de compte et nombres d’audience.
  • TikTok Hashtags API — Collectez les vidéos publiques, créateurs, médias, sons et l’engagement pour des hashtags donnés.
  • TikTok Search API — Recherchez des vidéos publiques par mot-clé avec tris et filtres de publication pris en charge.
  • TikTok Live Room Info API — Consultez un live connu à partir de la paire d’ID de salle et de propriétaire, et obtenez le statut, le contexte du propriétaire, le média de couverture et les nombres d’audience.
  • TikTok Search Users API — Recherchez des comptes TikTok publics par mot-clé.
  • TikTok Live Shopping API — Listez les produits du panier d’achat d’un LIVE, avec prix actuels et unités vendues.

Explorer d’autres plateformes

Combinez les données TikTok avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Live Search API — FAQ

TikTok Live Search API est une interface programmatique pour trouver les lives TikTok en cours qui correspondent à un mot-clé, results_limit fixant le nombre de résultats renvoyés. Chaque enregistrement contient l’ID de la salle, l’ID de l’hôte, le titre, les spectateurs actuels, les likes, l’image de couverture et l’heure de début.

Envoyez l’id d’un résultat comme room_id et son author.id comme user_id à TikTok Live Shopping. Les deux valeurs doivent provenir du même résultat.

results_limit accepte de 1 à 200, avec 20 par défaut, et la liste s’arrête plus tôt si moins de lives correspondent. Chaque live renvoyé est facturé 0,6 crédit, et une recherche sans résultat n’est pas facturée.

Non. La recherche liste les lives en cours au moment où vous la soumettez, et chaque enregistrement a le status live. Les diffusions passées ne sont pas renvoyées.

Des lives démarrent et s’arrêtent toute la journée : l’ensemble des diffusions en cours change d’une exécution à l’autre. Utilisez id comme clé du live et collected_at comme heure de chaque collecte.

La requête n’accepte que query et results_limit. Lisez metrics.viewers_count dans les résultats et filtrez de votre côté.

Cet endpoint cherche par mot-clé. Pour un compte connu, utilisez TikTok User Live, qui prend des noms d’utilisateur et indique l’état du live de chacun.