TikTok Live Shopping
Le panier d’un live shopping TikTok LIVE est l’ensemble des produits qu’un hôte vend pendant une diffusion ; chaque produit y a un titre, un prix dans une devise précisée, un nombre d’unités vendues, un vendeur et une image. Lire un panier montre ce que le live met en avant, à quel prix les articles sont proposés pendant que l’hôte est à l’antenne et lesquels se vendent déjà en volume.
Fonctionnalités de la TikTok Live Shopping API
- Tous les produits du panierroom_id associé au user_id de l’hôte renvoie chaque produit du panier de la salle sous forme d’un enregistrement distinct, jusqu’aux 500 permis par results_limit.
- Prix en montant, devise et texte affichéprice.amount, price.currency et price.formatted donnent le nombre, le code de la devise, par exemple USD, et la chaîne affichée que voient les spectateurs.
- Unités vendues en nombre entiersold_count est un nombre entier, comme 101600, ce qui permet de trier et de comparer directement les paniers.
- Lien du produit, ID du vendeur et imageChaque enregistrement contient la page du produit dans url, l’ID du vendeur dans seller.id et l’image du produit avec sa largeur et sa hauteur dans media.
Paramètres de la TikTok Live Shopping API
| Paramètres | Obligatoire | Description |
|---|---|---|
room_id | Obligatoire | ID numérique de la salle LIVE, repris de l’id d’un résultat de TikTok Live Search. |
user_id | Obligatoire | ID utilisateur TikTok numérique de l’hôte, repris de author.id du même résultat de Live Search. |
results_limit | Facultatif | Nombre de produits à renvoyer, de 1 à 500. 100 par défaut. |
Comment utiliser la TikTok Live Shopping API
Trouvez un live shopping, puis listez son panier pendant qu’il est en direct.
- Lancez TikTok Live Search avec un mot-clé d’achat et relevez l’id et l’author.id d’un résultat.
- Envoyez {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} en POST à /v1/tiktok/live-products.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez les produits dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id":"7704767945901132575","user_id":"7153432386608251946","results_limit":100}'
# Each item is one product with title, price and sold_count.Cas d’usage de la TikTok Live Shopping API
- Lire le panier d’un concurrent en live : Prenez le room_id et le user_id d’un hôte concurrent dans Live Search et listez tout le panier pour voir quels produits et quelles gammes de prix il propose.
- Surveiller l’évolution des prix pendant une diffusion : Relisez la même salle toutes les quelques minutes et comparez price.amount pour chaque id de produit afin de repérer les remises annoncées à l’antenne.
- Trouver les meilleures ventes d’un panier : Triez un panier par sold_count pour voir quels articles ont déjà écoulé le plus d’unités, puis rapprochez-les de leur prix.
Conseils d’expert pour la TikTok Live Shopping API
- Vérifiez price.currency avant de comparer des prix entre salles : un montant n’a de sens qu’avec sa devise.
- Rapprochez un même produit d’une lecture à l’autre par son id ; price.amount et sold_count sont les champs qui évoluent.
API associées
En complément de la TikTok Live Shopping 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 Comments API — Collectez les commentaires publics de premier niveau, leurs auteurs, l’engagement, les mentions et les indicateurs d’interaction du créateur.
- TikTok Videos API — Récupérez le créateur, la légende, les médias, la musique, les tags, les mentions et l’engagement à partir d’URL de vidéos.
- 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 Live Search API — Trouvez par mot-clé les LIVE en cours de diffusion, avec hôtes, titres et spectateurs actuels.
- TikTok Search 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 Search Users 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