tiktok/
live-products

Listez les produits du panier d’un live TikTok LIVE à partir de l’ID de la salle et de l’ID de l’hôte : titre, prix actuel, unités vendues, ID du vendeur, lien du produit et image.

TikTok Live Shopping API

ID de salle et d’hôte
Produits du panier
Jusqu’à 500 produits
0,1 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 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ètresObligatoireDescription
room_idObligatoireID numérique de la salle LIVE, repris de l’id d’un résultat de TikTok Live Search.
user_idObligatoireID utilisateur TikTok numérique de l’hôte, repris de author.id du même résultat de Live Search.
results_limitFacultatifNombre 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.

  1. Lancez TikTok Live Search avec un mot-clé d’achat et relevez l’id et l’author.id d’un résultat.
  2. Envoyez {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} en POST à /v1/tiktok/live-products.
  3. 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.

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.

Explorer d’autres plateformes

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

TikTok Live Shopping API — FAQ

TikTok Live Shopping API est une interface programmatique pour lister les produits du panier d’un live TikTok LIVE, à partir du room_id du live et du user_id de l’hôte. Elle renvoie pour chaque produit le titre, le prix, les unités vendues, l’ID du vendeur, le lien et l’image.

Lancez TikTok Live Search et reprenez l’id d’un résultat comme room_id et son author.id comme user_id. Le couple doit provenir du même résultat.

results_limit accepte de 1 à 500, avec 100 par défaut, et s’arrête plus tôt si le panier est plus petit. Chaque produit renvoyé est facturé 0,1 crédit : un panier complet de 500 produits coûte donc 50 crédits.

L’hôte n’a aucun panier dans cette salle, ou la salle n’est plus en direct. Un résultat vide n’est pas facturé.

Non, la salle doit être en direct au moment où vous demandez le panier. Lisez-le pendant la diffusion et conservez-le si vous avez besoin de la sélection plus tard.

sold_count est le nombre d’unités vendues que TikTok indique pour le produit, et vaut null quand rien n’est indiqué. Pour voir ce qui se vend pendant une diffusion, lisez le panier deux fois et soustrayez.