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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé pour lequel chercher des lives. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"query": "deals", "results_limit": 20} en POST à /v1/tiktok/search-live.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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.
API associées
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.
- 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