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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-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_by | Facultatif | Ordre 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_within | Facultatif | Pé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. |
region | Facultatif | Code 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_limit | Facultatif | Nombre 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.
- 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.
- 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.
- 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.
- 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.
- 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.
API associées
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.
- 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 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 Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API