Illustration de l’extracteur TikTok Creative CenterTop Ads et pistes créatives

Extracteur TikTok Creative Center.

Choisissez marché et secteur, puis collectez les Top Ads. Examinez vidéos et contexte de classement avant vos propres tests.

Lancer sur Apify

Comment utiliser cet extracteur.

Essayez ces exemples pour le marketing, la croissance et l’analyse concurrentielle.

01

Gardez des références créatives chaque semaine

Pour une marque beauté, examinez chaque semaine les Top Ads de votre marché et secteur. Regardez vidéos, accroches et démonstrations pour préparer vos tests.

Gardez vidéos sources, notes et contexte de classement dans une bibliothèque.

02

Comparez les durées entre classements

Collectez des listes classées par CTR et taux de vue à six secondes. Comparez exemples et durées. Un bon classement ne garantit pas le même résultat pour une autre marque.

Préparez des tests en séparant observations et idées à essayer.

03

Vérifiez la cohérence entre annonce et destination

Activez les détails et comparez textes, objectifs et pages de destination. Vérifiez le lien entre promesse créative et expérience produit ou page.

Gardez un audit annonce-destination avec vos notes.

DU PREMIER ESSAI AU FLUX RÉCURRENT

Votre premier essai, pas à pas.

  1. Ouvrez l’Actor sur Apify, choisissez Input et passez à l’éditeur JSON pour coller une configuration.
  2. Commencez avec un pays, comme US, et un classement, comme ctr. Laissez secteur, objectif et langue vides jusqu’au premier échantillon. Vous éviterez ainsi de multiplier les recherches involontairement.
  3. Utilisez period 7, maxAds 20 et maxQueries 1 pour un essai rapide. Laissez scrapeAdDetails sur false. Augmenter maxAds ne supprime pas la limite d’environ 20 annonces par combinaison imposée par la source.
  4. Lancez l’exécution et consultez le journal. Vérifiez les cibles et filtres retenus avant de conclure qu’aucun résultat n’existe.
  5. Ouvrez Storage → Dataset, vérifiez quelques lignes et exportez en JSON pour les données imbriquées ou en CSV pour un premier examen dans un tableur.
Configuration de départ
{
  "countries": ["US"],
  "period": "7",
  "sortBy": ["ctr"],
  "maxAds": 20,
  "maxQueries": 1,
  "scrapeAdDetails": false
}

Collez ceci dans l’éditeur JSON de l’Actor. Remplacez les cibles d’exemple avant de lancer.

Voir le formulaire actuel sur Apify

Choisissez votre mode de recherche.

Creative Center est une sélection de Top Ads, pas une archive complète d’annonceurs. Utilisez-le pour étudier des exemples, accroches et choix de montage. Pays, secteur, objectif, langue et classement créent des combinaisons de recherche distinctes.

Méthode de rechercheQuand l’utiliserCe qui change
Choix des marchésQuand l’utiliserVous voulez une vue d’un pays ou d’un marché précis.Ce qui changeChoisissez les marchés Top Ads ci-dessous. Vide signifie tous. Cette couverture diffère d’Ad Library et inclut les États-Unis. Chaque pays ajoute des combinaisons.
Choix du classementQuand l’utiliserVous voulez des références créatives classées selon une métrique précise.Ce qui changeChaque tri crée une liste Top Ads distincte. for_you, like, ctr, impression, cvr, play_6s_rate et play_2s_rate sélectionnent les classements ; all les demande tous.
Secteur et objectif de campagneQuand l’utiliserVous souhaitez une couverture plus large et pouvez augmenter la collecte.Ce qui changeUtilisez les noms de secteurs Creative Center, comme beauty. La correspondance est souple et un parent inclut ses sous-secteurs. Plusieurs secteurs créent des requêtes séparées.

La différence à retenir

Plafonne les annonces uniques sur toutes les combinaisons. Une requête sans connexion donne au plus 20 ; maxAds 100 ne la force pas à en donner 100. Ajoutez des combinaisons pertinentes.

Comparer le scraper associé

Tous les paramètres, expliqués.

Utilisez les noms exacts ci-dessous en JSON. Dans le formulaire Apify, saisissez les éléments des listes séparément et respectez les types numériques et booléens.

Valeur par défaut et préremplissage sont différents. La valeur par défaut s’applique si vous omettez un réglage ; le préremplissage est un exemple déjà saisi dans le formulaire Apify. Vérifiez cibles et limites avant chaque collecte. Certains réglages n’ont pas de valeur par défaut dans le schéma. Indiquez au moins une cible prise en charge.

Cibles et recherches4
countries
ListeExemple prérempli : ["US"]

Choisissez les marchés Top Ads ci-dessous. Vide signifie tous. Cette couverture diffère d’Ad Library et inclut les États-Unis. Chaque pays ajoute des combinaisons.

Valeurs JSON proposées
AR AU BR CA CO FR DE ID IT JP MY MX NL PK PH RO SA SG ZA KR ES SE TH TR AE GB US VN
industries
Liste

Utilisez les noms de secteurs Creative Center, comme beauty. La correspondance est souple et un parent inclut ses sous-secteurs. Plusieurs secteurs créent des requêtes séparées.

objectives
Liste

Filtres d’objectif de campagne, comme traffic ou product sales. Chaque choix ajoute des combinaisons. L’objectif décrit le contexte, pas vos performances futures.

Valeurs JSON proposées
traffic app installs conversions video views reach lead generation product sales
adLanguages
Liste

Langue des annonces, pas de l’interface. Plusieurs langues ajoutent des combinaisons. Laissez vide pour toutes si vous n’avez pas besoin d’un filtre linguistique.

Valeurs JSON proposées
en es ar vi th de id pt fr ms nl ja it ro zh-Hant ko
Marchés, dates et filtres2
period
TextePar défaut : 30

Période de classement de 7, 30 ou 180 jours, en texte. Ce n’est pas une collecte de toutes les annonces diffusées pendant ces dates.

Valeurs JSON proposées
7 30 180
sortBy
ListeExemple prérempli : ["for you"]

Chaque tri crée une liste Top Ads distincte. for_you, like, ctr, impression, cvr, play_6s_rate et play_2s_rate sélectionnent les classements ; all les demande tous.

Valeurs JSON proposées
for_you like ctr impression cvr play_6s_rate play_2s_rate all
Limites, détails et proxys4
maxAds
EntierExemple prérempli : 100

Plafonne les annonces uniques sur toutes les combinaisons. Une requête sans connexion donne au plus 20 ; maxAds 100 ne la force pas à en donner 100. Ajoutez des combinaisons pertinentes.

maxQueries
EntierPar défaut : 500

Limite pays × secteur × objectif × langue × classement. Deux pays et deux classements font quatre requêtes sans autres choix multiples. Les premières combinaisons peuvent épuiser ce plafond.

scrapeAdDetails
Vrai ou fauxPar défaut : true

Ajoute pages de destination, pays, commentaires, partages et mots-clés. Une requête par annonce. Désactivez pour une liste rapide ; les détails manquants apparaissent dans le résumé.

proxyConfiguration
ObjetPar défaut : {"useApifyProxy":true}Exemple prérempli : {"useApifyProxy":true}

Apify Proxy est le défaut. L’Actor réessaie les sorties refusées et peut passer au résidentiel. Gardez le défaut au départ ; une liste vide ne signifie pas toujours absence d’annonces.

Réglages avancés et reprise2
resume
Vrai ou fauxPar défaut : true

Sauvegarde la progression environ toutes les 30 secondes pour reprendre après un redémarrage ou une migration Apify. Laissez-le activé.

continueFromLastRun
Vrai ou fauxPar défaut : false

Poursuit le travail inachevé du run précédent avec la même entrée. Les résultats précédents restent dans son dataset. Gardez false pour une collecte nouvelle ou régulière.

Cette référence reprend les paramètres de l’Actor. Vérifiez le formulaire actuel avant de modifier un flux de production. Voir le formulaire actuel sur Apify.

Des configurations à copier.

Chaque exemple est une exécution distincte. Commencez petit, vérifiez les résultats, puis élargissez. Adaptez les cibles, pays et dates à votre recherche.

Comparer deux classements créatifs

Deux pays et deux classements donnent quatre combinaisons. Avec environ 20 annonces par combinaison, 80 est un plafond de planification, pas un nombre unique garanti. Une annonce peut figurer dans plusieurs classements.

Comparer deux classements créatifs
{
  "countries": ["US", "FR"],
  "period": "7",
  "sortBy": ["ctr", "play_6s_rate"],
  "maxAds": 80,
  "maxQueries": 4,
  "scrapeAdDetails": false
}

Trouver des exemples pour un brief de vente

Combinez beauté, vente de produits et annonces en anglais aux États-Unis sur 30 jours. Activez les détails de ce petit échantillon. Étudiez accroches et réalisation ; le classement ne prédit pas les résultats de votre campagne.

Trouver des exemples pour un brief de vente
{
  "countries": ["US"],
  "period": "30",
  "industries": ["beauty"],
  "objectives": ["product sales"],
  "adLanguages": ["en"],
  "sortBy": ["ctr"],
  "maxAds": 20,
  "maxQueries": 1,
  "scrapeAdDetails": true
}

Créer une sélection d’inspiration plus large

Utilisez tous les classements d’un pays sur 180 jours, sans requêtes de détails. Les sept ordres pris en charge sont parcourus, puis les résultats dédupliqués. maxQueries 7 borne le plan de recherche.

Créer une sélection d’inspiration plus large
{
  "countries": ["US"],
  "period": "180",
  "sortBy": ["all"],
  "maxAds": 100,
  "maxQueries": 7,
  "scrapeAdDetails": false
}

Exécutez, vérifiez, exportez, recommencez.

Conservez identifiant, vidéos, pays et combinaison avec les métriques disponibles. Elles appartiennent à l’échantillon Top Ads et ne supposent pas une exposition égale des campagnes. Les détails peuvent échouer malgré une collecte de liste réussie ; vérifiez SUMMARY.adsWithoutDetails et sauvegardez vite les liens média temporaires.

  1. Consultez le dataset et le record SUMMARY. Comparez le total à votre limite, vérifiez les entrées ignorées ou échouées et contrôlez quelques liens sources.
  2. Conservez les identifiants et ajoutez collected_at et run_id à l’enregistrement. Utilisez CSV pour les colonnes simples et JSON pour les listes ou détails imbriqués.
  3. Enregistrez la configuration testée comme Apify Task et programmez-la. Pour des observations régulières, laissez continueFromLastRun à false. Dédupliquez par identifiant en conservant chaque date d’observation.
  4. Dans Make ou n8n, attendez la fin du run, récupérez son dataset et mappez les champs vers Sheets ou votre entrepôt. Alimentez Looker Studio avec une table de reporting et utilisez dbt pour transformer et tester les modèles.
  5. Le même JSON fonctionne avec l’API Actors d’Apify. Dans Claude avec Apify MCP, nommez cet Actor, demandez la lecture du schéma et précisez cibles, marchés et limites avant l’exécution.

Reprendre ne crée pas une nouvelle observation

resume protège le run actuel si Apify le redémarre. continueFromLastRun poursuit un ancien run avec la même configuration ; ses données restent dans son dataset. Réunissez les deux datasets et augmentez une limite déjà atteinte. Relancez de zéro pour observer les changements d’aujourd’hui.

Suivre les guides Sheets, Claude, Looker et BigQuery
Lancer cet Actor par l’API

Enregistrez une configuration ci-dessus dans input.json. Définissez APIFY_TOKEN avec votre jeton Apify dans le terminal, puis envoyez le fichier comme corps de requête.

Démarrer la collecte
curl --fail-with-body --request POST \
  --url "https://api.apify.com/v2/actors/jmlp~tiktok-creative-center-scraper/runs" \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header "Content-Type: application/json" \
  --data-binary @input.json

La réponse contient un identifiant de collecte et defaultDatasetId, pas les résultats finaux. Attendez la réussite, définissez DATASET_ID avec cet identifiant et récupérez les lignes. Pour les gros jeux, utilisez limit et offset pour paginer.

Récupérer les données
curl --fail-with-body \
  --url "https://api.apify.com/v2/datasets/$DATASET_ID/items?format=json" \
  --header "Authorization: Bearer $APIFY_TOKEN"

Référence API de lancement et d’export d’Apify
Options d’export des données

Si les résultats vous surprennent.

Modifiez un réglage à la fois, gardez une petite limite et consultez le résumé avant d’élargir.

Pourquoi une recherche s’arrête-t-elle à environ 20 annonces ?

Plafonne les annonces uniques sur toutes les combinaisons. Une requête sans connexion donne au plus 20 ; maxAds 100 ne la force pas à en donner 100. Ajoutez des combinaisons pertinentes.

Quelques filtres ont créé de nombreuses combinaisons de recherche.

Limite pays × secteur × objectif × langue × classement. Deux pays et deux classements font quatre requêtes sans autres choix multiples. Les premières combinaisons peuvent épuiser ce plafond.

Le résultat existe, mais les champs détaillés manquent.

Ajoute pages de destination, pays, commentaires, partages et mots-clés. Une requête par annonce. Désactivez pour une liste rapide ; les détails manquants apparaissent dans le résumé.

Le run a réussi, mais reste vide

Un succès indique que l’Actor a terminé, pas que la source a fourni des données. Consultez SUMMARY.inputProblem, SUMMARY.problem et le journal : cible manquante, filtre non pris en charge ou requête refusée. Essayez une cible connue avec moins de filtres.

Moins de lignes que prévu

Vérifiez les limites globales, par recherche et par page, la couverture et les doublons. Plusieurs recherches peuvent trouver la même ligne. Le total annoncé par la source peut inclure des données non accessibles publiquement. Vérifiez les tâches inachevées avant de considérer le dataset complet.

Utilisez les résultats dans vos outils.

Google Sheets

Gardez ad_id, brand_name, ctr, video_duration, rank, scraped_sort et creative_center_url. Regardez les vidéos avant vos annotations d’accroche et d’offre.

Lire le guide
Claude + MCP

Demandez à Claude d’organiser textes et métriques avec sources. Pour la vidéo, fournissez médias ou transcriptions : URL et légende ne décrivent pas toute la création.

Lire le guide
Looker Studio

Comparez durées et métriques par secteur, pays et classement. Affichez le contexte de requête et précisez qu’il s’agit d’un échantillon Top Ads.

Lire le guide
BigQuery + dbt

Gardez toutes les dimensions de requête. Notez la première liste ayant trouvé chaque annonce dédupliquée et conservez les métriques brutes avant normalisation.

Lire le guide
Copier une consigne pour Claude
Consigne pour Claude + Apify MCP
Vérifie jmlp/tiktok-creative-center-scraper et collecte les Top Ads beauté US des sept derniers jours par CTR, maximum 50 annonces et 10 requêtes. Résume textes, durées et métriques, cite creative_center_url et précise l’échantillon Top Ads. Ne déduis ni contenu non vu ni performance garantie.

Les champs disponibles.

Conservez la date de collecte et les identifiants d’origine pour vérifier la provenance d’un résultat ou le comparer à une exécution ultérieure.

Avant de tirer des conclusions

Top Ads est une sélection classée de TikTok. Sans connexion, jusqu’à 20 annonces par combinaison. Classement et CTR décrivent ce contexte, pas vos futurs résultats. Les URL vidéo peuvent expirer en quelques heures. Pas de listes de tendances hashtags, chansons ou créateurs.

ad_id / creative_center_url
Identifiant stable et page source de l’annonce.
ad_title / brand_name / industry / objective
Texte, marque et catégories Creative Center.
ctr / likes / comments / shares
Métriques créatives et d’engagement publiées si disponibles.
video_url / video_duration / video_cover
Vidéo, durée et aperçu.
landing_page / countries / keywords
Champs supplémentaires avec collecte détaillée.
rank / scraped_country / scraped_period / scraped_sort
Contexte de la liste Top Ads ayant trouvé le résultat.

Questions fréquentes.

Quelle différence avec TikTok Ad Library ?

Creative Center sélectionne et classe les Top Ads pour l’inspiration, notamment aux États-Unis. Ad Library collecte les annonces commerciales des marchés pris en charge dans l’UE/EEE, au Royaume-Uni et en Suisse. Choisissez selon votre question.

Pourquoi une requête ne donne-t-elle que 20 annonces ?

C’est la limite Top Ads sans connexion par combinaison de filtres. D’autres pays, classements et secteurs créent plus de requêtes ; l’extracteur retire les doublons.

Source et informations actuelles : Actor TikTok Creative Center de JMLP sur Apify.

D’autres extracteurs
qui pourraient vous être utiles.

Parlons de
votre projet.

Dites-moi ce que vous devez collecter ou comprendre. Je peux vous aider avec un extracteur sur mesure, un pipeline ou l’analyse.

Parlons de votre projet