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ètres | Obligatoire | Description |
|---|---|---|
query | Facultatif | Mot-clé facultatif pour filtrer les publicités, par exemple une catégorie de produits. |
time_range | Facultatif | Période de recherche : 7d, 30d (par défaut) ou 180d. |
sort_by | Facultatif | relevance pour l’ordre propre à TikTok (par défaut), ou likes pour les publicités les plus aimées en premier. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"query": "skincare", "time_range": "30d", "sort_by": "likes"} en POST à /v1/tiktok-creative-center/top-ads.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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.
API associées
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.
- TikTok Creative Center Ad Analysis API — Analysez seconde par seconde une publicité du classement, avec ses courbes de taux de clics et de rétention.
- TikTok Creative Center Trending Hashtags API — Obtenez le classement des hashtags tendance d’un pays, avec nombres de publications, vues et courbes de popularité.
- TikTok Creative Center Hashtag Insights API — Explorez la courbe de popularité d’un hashtag tendance, ses principaux pays et des vidéos d’exemple.
- TikTok Creative Center Top Videos API — Obtenez le classement des vidéos les plus performantes d’un pays, avec vues et taux d’engagement.
- TikTok Creator Marketplace API — Obtenez des fiches Creator Marketplace avec données démographiques des abonnés, vues médianes et tarifs de départ.