tiktok/
search

Recherchez des vidéos TikTok publiques par mot-clé, avec filtres de pertinence, de date, de mentions J’aime et de fenêtre de publication, et obtenez des enregistrements normalisés de créateur, de contenu, de médias et d’engagement.

TikTok Search API

Découverte par mot-clé
Échantillons de recherche
Fenêtres temporelles
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 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ètresObligatoireDescription
queryObligatoireRequête par mot-clé obligatoire et non vide pour la découverte de vidéos TikTok publiques.
results_limitFacultatifLimite positive de vidéos demandées. Vaut 100 par défaut.
sort_byFacultatifOrdre des résultats : relevance, date ou likes. Vaut relevance par défaut.
published_withinFacultatifFenê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.

  1. Transformez le sujet d’étude en requête précise et choisissez results_limit, sort_by et published_within.
  2. Envoyez la requête en POST à /v1/tiktok/search et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
  4. 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 true

Cas 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.

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é.

Explorer d’autres plateformes

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

TikTok Search API — FAQ

TikTok Search API trouve des vidéos accessibles publiquement à partir d’un mot-clé ou d’une expression. Elle renvoie des données normalisées de vidéo, de créateur, de légende, de médias, de publication et d’engagement, avec les tris et filtres temporels pris en charge.

query est un mot-clé ou une expression obligatoire et non vide, par exemple une marque, un produit, une campagne, une personne ou un sujet d’étude.

relevance classe les résultats par pertinence thématique, date privilégie les publications récentes et likes privilégie les vidéos les plus aimées publiquement. relevance est la valeur par défaut.

published_within accepte day, week, month, three_months et six_months pour les vidéos publiées durant la période récente correspondante.

results_limit fixe le plafond de vidéos demandées, doit être un entier positif et vaut 100 par défaut.

Les résultats comprennent l’ID de la vidéo, l’URL canonique, la légende, la langue, l’heure de publication, le créateur, l’engagement public, les hashtags, les mentions, les médias et les données musicales.

search_query enregistre le terme qui a produit le résultat, tandis que collected_at consigne l’heure de collecte pour des instantanés de recherche traçables.

Chaque vidéo de recherche normalisée renvoyée coûte 0,7 crédit.