tiktok/
top-search

Recherchez des vidéos et des carrousels photo TikTok par mot-clé, avec légendes, détails du créateur, liens médias et nombres d’interactions réunis dans une même liste JSON.

TikTok Top Search API

Vidéos et carrousels photo
Recherche par mot-clé
Tri et filtres de publication
0,7 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 Top Search

TikTok Top Search réunit, autour d’un mot-clé ou d’une expression, des vidéos et des carrousels photo, c’est-à-dire des publications composées de plusieurs images. Les légendes, les identités des créateurs, les médias et les nombres d’interactions aident à comparer la façon dont un même sujet apparaît selon ces formats de contenu.

Fonctionnalités de la TikTok Top Search API

  • Trouver vidéos et publications d’images en une rechercheUne même requête par mot-clé peut renvoyer des publications vidéo et des carrousels photo ; le champ type indique le format, pour garder les deux dans un même jeu de données ou les séparer lors de l’examen.
  • Choisir l’ordre et la période de publicationTriez les contenus correspondants par pertinence, date de publication ou mentions J’aime, et ajoutez un filtre de période de publication pour cibler le type de contenu à inspecter.
  • Lire le contenu avec son créateur et ses compteursChaque résultat réunit la légende, les informations sur le créateur, les liens médias et les nombres d’interactions disponibles, afin de relier le sujet et le format d’une publication au compte qui l’a publiée.

Paramètres de la TikTok Top Search API

ParamètresObligatoireDescription
queryObligatoireMot-clé ou expression obligatoire décrivant ce que vous cherchez, par exemple coffee ou home workout ; saisissez un texte de recherche, et non l’URL d’une publication TikTok.
sort_byFacultatifOrdre facultatif : relevance place la pertinence en premier, date utilise l’ordre de date de publication et likes utilise le nombre de mentions J’aime ; la valeur par défaut est relevance.
published_withinFacultatifPériode de publication facultative : day correspond à hier, week à cette semaine, month à ce mois-ci, three_months aux trois derniers mois et six_months aux six derniers mois ; laissez vide pour n’appliquer aucun filtre de date de publication supplémentaire.
regionFacultatifCode de région à deux lettres facultatif, comme US ou GB, qui modifie les contenus accessibles pour la recherche ; il ne prouve pas que les publications ou créateurs renvoyés se trouvent dans ce pays.
results_limitFacultatifNombre maximal facultatif d’enregistrements de contenu, de 1 à 2 000, avec 100 par défaut ; les vidéos et les carrousels photo comptent tous deux dans ce total, et il peut y avoir moins de résultats.

Comment utiliser la TikTok Top Search API

Une collecte démarre en arrière-plan dès l’envoi : vous recevez d’abord un ID de tâche, pas les données finales, puis vous vous en servez pour suivre l’avancement et récupérer les résultats.

  1. Saisissez un mot-clé de sujet, choisissez si la pertinence, la date ou les mentions J’aime constituent le tri le plus utile, et fixez une limite de résultats ; n’ajoutez une période de publication ou une région que si vous en avez besoin.
  2. Avant d’exécuter l’exemple, remplacez $SOCQ_API_KEY par votre propre clé API ou définissez cette variable d’environnement. Envoyez l’entrée JSON en POST à /v1/tiktok/top-search avec l’en-tête Authorization ci-dessous, puis conservez le task_id de la réponse.
  3. Utilisez GET /v1/tasks/{task_id} avec l’ID conservé pour suivre l’avancement. queued signifie en attente, running signifie que la collecte est en cours et retrying qu’une nouvelle tentative a lieu. Attendez succeeded avant de lire les résultats ; si la tâche est failed, lisez error_message pour en connaître la raison.
  4. Quand la tâche réussit, lisez data.results.items : chaque élément de cette liste décrit une publication vidéo ou un carrousel photo. Une liste vide signifie que la tâche s’est terminée sans renvoyer d’enregistrement.
  5. Si data.results.has_more vaut true, la valeur next_cursor est le repère d’une autre page de résultats enregistrés. Copiez-la telle quelle dans le paramètre cursor de GET /v1/tasks/{task_id}?cursor=... et continuez jusqu’à ce que has_more vaille false.
curl -X POST "https://api.socq.ai/v1/tiktok/top-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"coffee","sort_by":"relevance","results_limit":20}'

Cas d’usage de la TikTok Top Search API

  • Constituer une collection de contenus par sujet : Recherchez un sujet comme coffee, puis enregistrez légendes, handles de créateurs, liens et types de contenu dans un tableau d’examen contenant à la fois des exemples de vidéos et de publications d’images.
  • Comparer les nombres d’interactions des publications renvoyées : Combinez les mentions J’aime, commentaires et partages disponibles avec le format et la date de publication de chaque publication pour préparer une feuille de comparaison, en gardant la requête et les filtres pour savoir comment les exemples ont été sélectionnés.

Conseils d’expert pour la TikTok Top Search API

  • À l’affichage d’un résultat, inspectez d’abord type et media : photo_carousel désigne une publication d’images et appelle une galerie d’images plutôt qu’un lecteur vidéo.
  • Si vous collectez plusieurs mots-clés, dédoublonnez les correspondances répétées par ID de publication et associez à chaque collecte son mot-clé, pour qu’une même publication ne soit pas comptée plusieurs fois par erreur.
  • Si votre workflow n’accepte que des vidéos, utilisez TikTok Search ; si vous avez besoin à la fois de vidéos et de publications d’images, gardez Top Search et gérez les deux formats dans votre affichage.
  • Lorsqu’un résultat photo n’a ni durée ni nombre de lectures, laissez cette mesure vide plutôt que de l’interpréter comme une vidéo de zéro seconde ou une publication jamais vue.

En complément de la TikTok Top 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 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 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.

Explorer d’autres plateformes

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

TikTok Top Search API — FAQ

TikTok Top Search API est une interface qui trouve des vidéos et des carrousels photo TikTok publics à partir d’un mot-clé ou d’une expression. Elle renvoie les légendes, les créateurs, les liens médias et les nombres d’interactions, avec des tris et des filtres de période de publication facultatifs.

C’est une publication d’images TikTok contenant plusieurs photos que les spectateurs font défiler. Dans les résultats, type=photo_carousel identifie ce format et media contient les entrées d’images.

TikTok Search ne renvoie que des vidéos, alors que Top Search peut inclure à la fois des vidéos et des carrousels photo. Choisissez selon que votre collecte ou votre affichage doit aussi gérer les publications d’images.

Il n’existe pas de filtre d’entrée réservé aux photos. Après la récupération, sélectionnez les enregistrements dont type vaut photo_carousel ; la limite de résultats s’applique avant votre propre filtrage par format, si bien que le nombre de photos restantes peut être inférieur.

Non. region modifie la disponibilité des contenus pour la recherche, et non l’origine géographique de chaque résultat ; ne l’utilisez pas pour remplacer un champ de localisation du créateur ou de la publication.

Non. results_limit plafonne la sélection renvoyée, sans garantir que chaque publication TikTok correspondante sera incluse. Une recherche peut renvoyer moins d’enregistrements que la limite demandée.

Chaque enregistrement de contenu renvoyé coûte 0,7 crédit, qu’il s’agisse d’une vidéo ou d’un carrousel photo. Il n’y a pas de frais de base ; une limite de 100 donne une estimation de 70 crédits, tandis que 20 enregistrements renvoyés coûtent 14 crédits.