tiktok-creative-center/
top-ads

Récupérez les publicités les plus performantes du TikTok Creative Center par mot-clé, sur une période de 7, 30 ou 180 jours et selon un ordre de tri, avec légendes, CTR, likes, objectif, secteur et vidéo de la publicité.

TikTok Creative Center Top Ads API

Publicités les plus performantes
CTR par publicité
Fichiers vidéo des publicités
0,5 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 Creative Center Top Ads

Top Ads du TikTok Creative Center est une sélection de publicités qui performent bien sur TikTok, chacune présentée avec sa légende, son secteur, son objectif de campagne, son taux de clics, ses likes et sa vidéo. Les parcourir révèle quelles accroches, quels formats et quelles offres continuent de gagner dans une catégorie, ce qui sert la veille créative, la surveillance de la concurrence et la rédaction de briefs publicitaires.

Fonctionnalités de la TikTok Creative Center Top Ads API

  • La liste Top Ads propre au Creative CenterLes résultats viennent des publicités que Creative Center classe parmi les plus performantes, ordonnées par pertinence selon TikTok ou par likes.
  • CTR, likes et contexte de campagne par publicitéChaque publicité contient ctr et likes, ainsi que son secteur et son objectif tels que Creative Center les libelle.
  • La vidéo, pas seulement les chiffresmedia renvoie l’URL de la vidéo de la publicité avec sa vignette, sa largeur, sa hauteur et sa durée, et text contient la légende.
  • Mot-clé, période et volume au choixquery affine par mot-clé, time_range remonte sur 7, 30 ou 180 jours, et results_limit renvoie jusqu’à 300 publicités par requête.

Paramètres de la TikTok Creative Center Top Ads API

ParamètresObligatoireDescription
queryFacultatifMot-clé facultatif pour filtrer les publicités, par exemple une catégorie de produits.
time_rangeFacultatifPériode de recherche : 7d, 30d (par défaut) ou 180d.
sort_byFacultatifrelevance pour l’ordre propre à TikTok (par défaut), ou likes pour les publicités les plus aimées en premier.
results_limitFacultatifNombre de publicités à renvoyer, de 1 à 300. 20 par défaut.

Comment utiliser la TikTok Creative Center Top Ads API

Filtrez les meilleures publicités et parcourez les résultats page par page.

  1. Envoyez {"query": "skincare", "time_range": "30d", "sort_by": "likes"} en POST à /v1/tiktok-creative-center/top-ads.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les publicités dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
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"}'

# Each item's id can be sent to TikTok Creative Center Ad Analysis.

Cas d’usage de la TikTok Creative Center Top Ads API

  • Constituer une banque d’inspiration pour une catégorie de produits : Interrogez un mot-clé de produit et conservez les légendes, les vidéos et les duration_seconds des publicités en tête comme jeu de référence pour les graphistes et les monteurs.
  • Distinguer les accroches éphémères des accroches durables : Lancez un même mot-clé avec 7d puis 180d : les publicités présentes dans les deux fenêtres sont des formats qui continuent de fonctionner, celles qui n’apparaissent que dans la fenêtre courte sont des expérimentations en cours.
  • Présélectionner par CTR au sein d’un objectif : Récupérez un grand lot, regroupez-le par objectif et classez chaque groupe par ctr pour trouver les publicités qui méritent un examen plus poussé.
  • Étiqueter accroches et formats à grande échelle : Injectez légendes, fichiers vidéo et durées dans votre propre chaîne d’étiquetage pour compter quels types d’accroches et quelles durées dominent une catégorie.

Conseils d’expert pour la TikTok Creative Center Top Ads API

  • Ne comparez ctr qu’entre publicités du même jeu de résultats et du même objectif : son unité n’est pas documentée et le résultat ne contient ni budget ni données d’offre, alors classez les publicités entre elles plutôt que par rapport à un repère CTR général de TikTok.
  • sort_by n’offre que relevance et likes : demandez un results_limit plus grand et triez par ctr dans votre propre code.
  • Lisez les champs avec prudence : industry et objective reviennent sous forme de codes d’étiquette du Creative Center, comme campaign_objective_video_view, et advertiser ainsi que les nombres de commentaires, de partages et de vues dans metrics valent null dans l’exemple documenté.
  • Enregistrez l’id de chaque publicité à chaque exécution et dédoublonnez dessus, car une même publicité peut revenir pour des requêtes et des périodes différentes.
  • N’envoyez que les id de votre présélection à TikTok Creative Center Ad Analysis, qui coûte 1 crédit par publicité et ajoute les pays de diffusion et les courbes seconde par seconde.

En complément de la TikTok Creative Center Top Ads API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok Creative Center.

Explorer d’autres plateformes

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

TikTok Creative Center Top Ads API — FAQ

TikTok Creative Center Top Ads API est une interface programmatique pour collecter les publicités les plus performantes listées dans TikTok Creative Center, filtrées par mot-clé, période et ordre de tri. Elle renvoie pour chaque publicité la légende, le secteur, l’objectif, le taux de clics, les likes et la vidéo.

Non. Top Ads est une liste sélectionnée de publicités performantes présentées avec leur CTR et leurs likes, alors que la TikTok Ad Library est une archive de transparence des publicités diffusées, que l’on cherche par annonceur ou par mot-clé et qui n’indique pas de CTR.

Non. Top Ads ne liste que les publicités dont les annonceurs ont autorisé l’affichage dans Creative Center : c’est un échantillon de publicités performantes, pas un relevé complet. Pour chercher par annonceur, utilisez les endpoints de la TikTok Ad Library.

Pas avec cet endpoint, qui filtre par mot-clé et time_range. Le secteur et l’objectif reviennent sur chaque publicité : filtrez donc dessus après la requête, et lisez les pays de diffusion d’une publicité dans TikTok Creative Center Ad Analysis.

sort_by n’accepte que relevance ou likes. Demandez jusqu’à 300 publicités et triez vous-même sur le ctr renvoyé.

Chaque publicité renvoyée coûte 0,5 crédit : 300 publicités coûtent donc 150 crédits. Une requête qui ne renvoie aucune publicité n’est pas facturée.

L’entrée media de chaque publicité contient l’URL de la vidéo, la vignette, la taille et la durée, ce qui permet de récupérer le fichier. Les vidéos appartiennent à leurs annonceurs : servez-vous-en pour la recherche et la référence, pas pour les republier.