TikTok Search
Les résultats de TikTok Search sont des vidéos publiques correspondant à un mot-clé ou à une expression, avec les détails du créateur, les légendes, les médias, le contexte de publication et l’engagement visible. Ces enregistrements servent à découvrir des sujets, à étudier les tendances, à surveiller la concurrence et à analyser les opportunités de contenu.
Fonctionnalités de la TikTok Search API
- Découverte de vidéos par mot-cléTransformez un sujet, une marque, un produit ou un événement en jeu de vidéos candidates.
- Tri par pertinence et par récenceBasculez entre pertinence, date et mentions J’aime pour obtenir une vue thématique, récente ou centrée sur les vidéos les plus aimées.
- Fenêtres de publicationDélimitez la période d’étude avec day, week, month, three_months ou six_months.
- Champs de contenu et de créateurRenvoie les champs de vidéo, de créateur, d’engagement, de hashtags et de musique dans une structure de résultat de recherche cohérente.
- Instantanés de recherche traçablesConsignez chaque essai de recherche grâce à search_query et collected_at.
Paramètres de la TikTok Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Requête par mot-clé obligatoire et non vide pour la découverte de vidéos TikTok publiques. |
results_limit | Facultatif | Limite positive de vidéos demandées. Vaut 100 par défaut. |
sort_by | Facultatif | Ordre des résultats : relevance, date ou likes. Vaut relevance par défaut. |
published_within | Facultatif | Fenêtre de publication facultative : day, week, month, three_months ou six_months. |
Comment utiliser la TikTok Search API
Définissez d’abord la question de recherche, puis choisissez le mot-clé, l’objectif de classement et la fenêtre de publication.
- Transformez le sujet d’étude en requête précise et choisissez results_limit, sort_by et published_within.
- Envoyez la requête en POST à /v1/tiktok/search et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
- Lisez data.results.items. Tant que has_more vaut true, poursuivez avec next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la TikTok Search API
- Veille de marché et de catégorie : Servez-vous de termes de produit, de catégorie et de cas d’usage pour cartographier le paysage de contenus TikTok et un échantillon de créateurs.
- Suivi de l’élan d’un événement : Combinez le tri par date avec une fenêtre d’un jour ou d’une semaine pour suivre les contenus récents autour de lancements, d’événements et d’actualités.
- Étude des créations les plus aimées : Triez par mentions J’aime et étudiez les accroches, légendes, choix musicaux et combinaisons de hashtags qui reviennent.
- Surveillance des mentions de marque : Lancez à intervalles réguliers des requêtes de marque et de produit et enregistrez des instantanés pour les équipes contenu et communication.
Conseils d’expert pour la TikTok Search API
- Découpez un sujet large en requêtes de marque, de besoin, d’occasion et de tendance, puis fusionnez les jeux de vidéos obtenus.
- Choisissez relevance pour cartographier un sujet, date pour suivre les nouvelles publications et likes pour étudier les schémas créatifs populaires.
- Utilisez published_within pour garder des échantillons sur une échelle de temps cohérente, par exemple week pour des rapports récurrents.
- Stockez ensemble query, sort_by, published_within et collected_at afin de pouvoir reproduire la recherche.
- Dédoublonnez d’une requête à l’autre par id de vidéo et conservez chaque search_query qui a retrouvé la vidéo.
- Répétez vos requêtes clés à intervalles réguliers pour comparer l’évolution des créateurs, des thèmes et de l’engagement.
API associées
En complément de la TikTok 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 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 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 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