Retour aux API
Données de recherche du TikTok Creative Center

TikTok Creative Center API

Transformez les classements du TikTok Creative Center en données interrogeables : publicités les plus performantes, hashtags tendance par pays, classements de vidéos et fiches Creator Marketplace.

API TikTok Creative Center disponibles

Top Ads, Trending Hashtags et Top Videos lisent les classements ; Ad Analysis, Hashtag Insights et Creator Marketplace approfondissent une publicité, un hashtag ou un ensemble de créateurs tirés de ces classements.

Quelles données du Creative Center pouvez-vous récupérer ?

Chaque endpoint renvoie des enregistrements SocQ stables, construits à partir de ce que le Creative Center affiche pour la publicité, le hashtag, le classement ou le créateur choisi.

Publicités les plus performantes

Légende, secteur, objectif, score de clics, likes et vidéo des publicités que le Creative Center sélectionne, plus, pour une publicité donnée, les pays ciblés, le percentile d’impressions et les courbes de clics et de rétention seconde par seconde.

Hashtags tendance

Classements par pays sur 7, 30 ou 90 jours avec rang, nombres de publications et de vues et courbe de popularité quotidienne ; Hashtag Insights ajoute, pour un hashtag, les pays principaux par score et des ID de vidéos d’exemple.

Classements de vidéos

Classements quotidiens, hebdomadaires et long terme par pays, avec légende, créateur, vues de la période, vues organiques et totales, taux d’engagement, taux de visionnage à six secondes et ID Marketplace du créateur.

Fiches Creator Marketplace

Répartition des abonnés par âge, sexe, pays et appareil, vues médianes, taux d’engagement et de croissance des abonnés, et tarif de départ que chaque créateur affiche pour une vidéo sponsorisée.

SocQ et TikTok Creative Center

Le Creative Center est le site de recherche de TikTok, qui permet de parcourir les classements dans une interface web. SocQ renvoie ces mêmes classements sous forme d’enregistrements d’API que vous pouvez stocker, comparer et combiner.

FonctionnalitéSocQTikTok Creative Center
AccèsClé API et enregistrements JSONInterface web
Collecte en volumeJusqu’à 300 publicités, 100 hashtags ou 100 vidéos par tâcheNavigation page par page
Analyse approfondieLes ID d’un classement alimentent l’endpoint suivantNavigation manuelle d’une page à l’autre
SortieChamps SocQ stables et documentésGraphiques et fiches visuels

Fonctionnement des API TikTok Creative Center

Les six endpoints suivent le même cycle asynchrone d’envoi, d’interrogation et de lecture.

  1. 1. Lire un classement

    Envoyez des filtres à Top Ads, Trending Hashtags ou Top Videos, par exemple un mot-clé, un pays ou une période.

  2. 2. Interroger la tâche

    Utilisez le task_id renvoyé avec /v1/tasks/{task_id} jusqu’à la réussite ou l’échec du traitement.

  3. 3. Approfondir

    Envoyez l’id d’une publicité à Ad Analysis, l’id d’un hashtag à Hashtag Insights ou des valeurs creator_id à Creator Marketplace.

Démarrer avec une seule requête d’API

Authentifiez-vous avec une clé API SocQ. Top Ads renvoie 20 résultats par défaut et en accepte jusqu’à 300.

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"skincare","time_range":"30d","sort_by":"likes"}'

# Then analyze one ad:
# POST /v1/tiktok-creative-center/ad-analysis
# {"ad_id":"7697084527089729557"}
# Poll GET /v1/tasks/{task_id}

Cas d’usage courants de l’API TikTok Creative Center

Recherche de publicités concurrentes

Cherchez dans Top Ads par mot-clé, triez par likes et lisez le secteur, l’objectif et le score de clics de chaque publicité pour voir quels angles créatifs une catégorie récompense.

Diagnostic des décrochages d’une publicité

Envoyez un id de Top Ads à Ad Analysis et comparez click_through_curve et retention_curve seconde par seconde pour voir où les spectateurs cliquent et où ils partent.

Suivi des hashtags par marché

Récupérez à intervalles réguliers les hashtags tendance de chaque pays cible et servez-vous de popularity_curve pour voir lesquels montent encore avant de planifier vos publications.

Étalonnage des accroches et de la portée

Classez le palmarès vidéo d’un pays par six_second_view_rate et comparez organic_views_count avec views_count pour voir quelles ouvertures retiennent les spectateurs et quelles vidéos ont surtout été promues.

Présélection de créateurs

Reprenez les valeurs de creator_id des classements vidéo et comparez, sur leurs fiches Creator Marketplace, les parts d’audience, les vues médianes, l’engagement et le tarif de départ affiché.

Périmètre des données

Les résultats reflètent ce que le Creative Center publie pour chaque classement, marché et période.

  • Top Ads liste les publicités qui atteignent les seuils de performance du Creative Center et que leurs annonceurs ont autorisées : c’est une sélection, et non l’ensemble des publicités de TikTok.
  • Les classements de vidéos sont publiés avec un décalage, environ deux jours pour le classement quotidien et des semaines se terminant un dimanche pour l’hebdomadaire ; un marché sans classement renvoie zéro résultat et n’est pas facturé.
  • Les fiches Creator Marketplace n’existent que pour les créateurs inscrits au Creator Marketplace de TikTok et se consultent par ID Marketplace : les ID pris ailleurs ne correspondent à aucune fiche.
  • Les classements de hashtags n’acceptent qu’un pays et une période, sans filtre par secteur, et leurs lignes laissent les pays principaux et les vidéos d’exemple à Hashtag Insights.
  • Les scores de clics, les percentiles et les valeurs de popularité sont des mesures relatives fournies par le Creative Center, et non un reporting de campagne au niveau d’un compte.

Questions fréquentes sur l’API TikTok Creative Center

Qu’est-ce que l’API TikTok Creative Center ?

TikTok Creative Center API est une interface programmatique pour lire les publicités les plus performantes, les hashtags tendance, les classements de vidéos et les fiches Creator Marketplace du TikTok Creative Center sous forme d’enregistrements JSON normalisés.

Faut-il un compte TikTok ou un compte publicitaire ?

Non. Les requêtes utilisent votre clé API SocQ et lisent les classements que le Creative Center publie sur ses pages de recherche publiques.

Comment passer d’un classement à une publicité, un hashtag ou un créateur précis ?

Chaque classement renvoie l’ID que prend son endpoint de détail : l’id de publicité va à Ad Analysis, l’id de hashtag à Hashtag Insights avec le même pays, et le creator_id de Top Videos à Creator Marketplace.

Quelle différence entre Top Ads et Top Videos ?

Top Ads renvoie des publicités TikTok payantes avec leur score de clics, leur secteur et leur objectif. Top Videos renvoie le classement de vidéos d’un pays avec vues, vues organiques et taux d’engagement, plus l’ID Marketplace de chaque créateur.

Les données sont-elles à jour ?

Chaque requête renvoie ce que le Creative Center a publié à cet instant, et chaque enregistrement porte un horodatage collected_at. Les classements vidéo quotidiens ont environ deux jours de retard sur la date du jour et les classements hebdomadaires se terminent un dimanche.

Quels sont les tarifs des endpoints ?

Top Ads, Trending Hashtags, Top Videos et Creator Marketplace coûtent 0,5 crédit par résultat renvoyé. Ad Analysis coûte 1 crédit et Hashtag Insights 0,5 crédit par requête.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

YouTube API

Collectez les profils de chaînes YouTube publics pris en charge, les détails de vidéos, les vidéos de chaînes, les commentaires, les Shorts, les résultats par mot-clé et par hashtag, ainsi que les transcriptions disponibles, dans un seul flux asynchrone normalisé.

Facebook API

Collectez des profils de Pages Facebook publiques, des publications, des publications de groupes, des commentaires, des événements correspondant à un mot-clé et les transcriptions vidéo disponibles, avec des champs normalisés d’identité, de contenu, de source, de format, de lieu, de médias, de réactions, de participation et d’engagement.

X API

Collectez des profils publics, les relations d’abonnés et d’abonnements, des posts, des réponses, des citations, les comptes qui ont reposté, des résultats de recherche et les tendances actuelles. Des résultats homogènes pour vos recherches et votre veille.

LinkedIn API

Récupérez des données LinkedIn publiques de profils, d’entreprises, de publications et d’offres d’emploi à partir d’URL connues, avec des champs normalisés d’identité, de carrière, d’entreprise, de contenu, d’engagement et d’offre.

Reddit API

Récupérez les publications et commentaires Reddit publics à partir d’URL connues, parcourez les publications récentes, les mieux notées ou tendance d’un subreddit, ou recherchez des discussions par mot-clé et par période de publication.

Pinterest API

Récupérez les données de profils Pinterest publics, résolvez des Pins connus, collectez les Pins de profils sélectionnés ou lancez une recherche par mot-clé pour étudier les créateurs, les contenus et les tendances visuelles.