Bibliothèque de contenus commerciauxCollectez les annonces TikTok dans l’UE/EEE, au Royaume-Uni et en Suisse. Regardez les vidéos, comparez offres et activité, puis préparez des tests pour votre audience.
Essayez ces exemples pour le marketing, la croissance et l’analyse concurrentielle.
Pour une campagne beauté en France, collectez les annonces de la catégorie et regardez les vidéos. Annotez accroches, démonstrations et offres pour choisir vos angles de test.
Gardez les références dans un tableau et sélectionnez des idées de storyboard.
Comparez les annonces en Allemagne et en Espagne. Étudiez annonceurs, contenus et langues avant de choisir la production locale.
Gardez les vidéos sources dans une étude de marché avec les questions de localisation restantes.
Recherchez une marque et vérifiez si chaque résultat appartient à son entité enregistrée ou à un créateur. Gardez les deux identités.
Utilisez la liste d’annonceurs et créateurs pour étudier des partenariats.
DU PREMIER ESSAI AU FLUX RÉCURRENT
{
"searchTerms": ["Nike"],
"regions": ["FR"],
"maxAds": 50,
"adStatus": "all",
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Collez ceci dans l’éditeur JSON de l’Actor. Remplacez les cibles d’exemple avant de lancer.
Voir le formulaire actuel sur ApifyIl s’agit de la bibliothèque de contenu commercial de TikTok, couvrant l’UE/EEE, le Royaume-Uni et la Suisse. Elle convient à la recherche d’annonceurs dans ces marchés. Pour des idées créatives aux États-Unis, utilisez le scraper Creative Center.
| Méthode de recherche | Quand l’utiliser | Ce qui change |
|---|---|---|
| Nom d’annonceur ou de marque | Quand l’utiliserVous avez une liste de concurrents à suivre. | Ce qui changeRecherchez les annonceurs, souvent enregistrés sous leur raison sociale. Des noms partiels, profils TikTok et sites peuvent identifier une marque. Sans annonces, le nom peut devenir un mot-clé. |
| Recherche par mots-clés | Quand l’utiliserVous cherchez des résultats pertinents avant de choisir des cibles précises. | Ce qui changeRecherchez des thèmes comme running shoes dans le contenu, indépendamment de l’annonceur. Utile pour découvrir de nouvelles entreprises. |
| Identifiants d’annonceurs | Quand l’utiliserVous connaissez l’entité exacte à collecter. | Ce qui changeIdentifiants numériques d’entreprise TikTok. Permettent un suivi exact sans correspondance de nom. Copiez un identifiant vérifié, pas un pseudonyme TikTok. |
| URL de la bibliothèque publicitaire | Quand l’utiliserVous avez déjà configuré la recherche sur le site source. | Ce qui changeCollez des liens de recherche library.tiktok.com. Leurs pays, dates, statuts et filtres d’audience priment ; les champs séparés complètent les valeurs absentes. |
Seuls les 32 marchés indiqués sont couverts : UE/EEE, Royaume-Uni et Suisse. Les pays explicites sont recherchés séparément. Une liste regions vide recherche tous les marchés ensemble ; ["all"] recherche chaque pays séparément. Les pays non pris en charge sont ignorés. S’il n’en reste aucun, tous les marchés couverts sont recherchés.
Comparer le scraper associé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.
searchTermsRecherchez les annonceurs, souvent enregistrés sous leur raison sociale. Des noms partiels, profils TikTok et sites peuvent identifier une marque. Sans annonces, le nom peut devenir un mot-clé.
searchTermUn nom d’annonceur au lieu de searchTerms. Utilisez la liste pour plusieurs concurrents et advertiserBusinessIds pour une entité connue.
keywordsRecherchez des thèmes comme running shoes dans le contenu, indépendamment de l’annonceur. Utile pour découvrir de nouvelles entreprises.
advertiserBusinessIdsIdentifiants numériques d’entreprise TikTok. Permettent un suivi exact sans correspondance de nom. Copiez un identifiant vérifié, pas un pseudonyme TikTok.
adLibraryUrlsCollez des liens de recherche library.tiktok.com. Leurs pays, dates, statuts et filtres d’audience priment ; les champs séparés complètent les valeurs absentes.
regionsSeuls les 32 marchés indiqués sont couverts : UE/EEE, Royaume-Uni et Suisse. Les pays explicites sont recherchés séparément. Une liste regions vide recherche tous les marchés ensemble ; ["all"] recherche chaque pays séparément. Les pays non pris en charge sont ignorés. S’il n’en reste aucun, tous les marchés couverts sont recherchés.
regionUn pays en complément ou à la place de regions. Contrairement à Google Ads, ce champ se combine avec la liste, pas seulement lorsqu’elle est vide.
minDateFiltre côté serveur la dernière diffusion, pas la création. Utilisez YYYY-MM-DD ; sans dates, l’archive disponible est couverte, pas seulement les 30 jours du site.
maxDateLa dernière diffusion doit être à cette date ou avant. Avec minDate, définit une période de dernière diffusion ; une annonce lancée des mois avant peut correspondre.
adTypeChoisissez all, video, image ou text. Filtre le format créatif, pas la nature politique ou commerciale.
all video image textadStatusactive signifie en cours, inactive arrêté, all les deux. Statut et dernière diffusion répondent à des questions différentes ; définissez-les séparément.
all active inactivesortByTriez par dernière diffusion, publication ou portée unique, en ordre croissant ou décroissant. Avec maxAds, cela change la portion collectée en premier.
last_shown_date,desc last_shown_date,asc create_time,desc create_time,asc impression,desc impression,ascgenderFiltre le genre ciblé déclaré : ALL, FEMALE ou MALE. Il s’agit du ciblage, pas d’une répartition mesurée des spectateurs.
ALL FEMALE MALEagesTranches d’âge ciblées sous forme de liste de textes. Utilisez les valeurs à virgule, comme 18,24. Vide signifie tous les âges ; ce ne sont pas les spectateurs mesurés.
all 13,17 18,24 25,34 35,44 45,54 55,100adReachConservez certaines plages de portée publique : 0-10K, 10K-100K ou 100K+. Vide les inclut toutes. Ce ne sont pas des impressions ou conversions exactes.
all 0-10K 10K-100K 100K+proxyConfigurationLes proxys résidentiels sont nécessaires. Les sorties datacenter peuvent échouer à l’initialisation sans message clair. Gardez RESIDENTIAL avant de modifier les filtres pour diagnostiquer.
maxAdsPlafond d’annonces uniques pour tout le run, toutes cibles et tous marchés compris. Commencez à 50. Sans ce plafond, une recherche large peut produire beaucoup plus de données.
maxPagesLimite les pages par pays et recherche. Une page contient au maximum 12 annonces, même si d’anciennes descriptions évoquent davantage. Effacez pour poursuivre jusqu’au plafond de résultats.
pageSizeDe 1 à 12 annonces par requête. Au-delà, la valeur devient 12. maxPages augmente la profondeur ; pageSize au-delà de 12 ne change rien.
delayMsPause entre requêtes de pages, en millisecondes. Augmentez-la en cas de limitation ; la réduire ne supprime ni la latence ni les limites de la source.
rawRenvoie les données originales TikTok, sans conversion des dates ni décodage des liens médias. Gardez false pour un dataset utilisable dans un tableur.
proxyRotationsRéessaie les requêtes refusées avec une nouvelle session proxy. Davantage d’essais peut surmonter des blocages temporaires, mais ajoute du temps et du trafic. Gardez le réglage par défaut sauf indication du journal.
resumeSauvegarde la progression environ toutes les 30 secondes pour reprendre après un redémarrage ou une migration Apify. Laissez-le activé.
continueFromLastRunPoursuit 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.
Chaque exemple est une exécution distincte. Commencez petit, vérifiez les résultats, puis élargissez. Adaptez les cibles, pays et dates à votre recherche.
Collectez jusqu’à 50 annonces actives diffusées au Royaume-Uni. Vérifiez les noms juridiques avant de planifier et conservez le même pays et les mêmes filtres pour chaque relevé hebdomadaire.
{
"searchTerms": ["Nike"],
"regions": ["GB"],
"adStatus": "active",
"maxAds": 50,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Cherchez des vidéos skincare en France ciblant les 25 à 34 ans avec une portée de 100K+. L’échantillon peut être petit ou vide. Retirez les filtres de portée et d’âge un à un pour élargir la recherche.
{
"keywords": ["skincare"],
"regions": ["FR"],
"adType": "video",
"ages": ["25,34"],
"adReach": ["100K+"],
"sortBy": "last_shown_date,desc",
"maxAds": 50,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Recherchez en Allemagne et en France avec une période de dernière diffusion. La même annonce peut apparaître dans les deux recherches et n’est conservée qu’une fois. Ne sommez pas les comptes par pays comme des inventaires distincts.
{
"searchTerms": ["Nike"],
"regions": ["DE", "FR"],
"minDate": "2026-09-01",
"maxDate": "2026-09-30",
"maxAds": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Conservez identifiant, nom juridique, URL, médias et dates de première et dernière diffusion. La portée peut être une tranche, et dépenses ou impressions peuvent manquer. Ces lignes ne montrent ni conversions ni succès. Sauvegardez rapidement les références média, dont les URL peuvent expirer, et gardez le contexte du pays recherché.
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.
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.
curl --fail-with-body --request POST \
--url "https://api.apify.com/v2/actors/jmlp~tiktok-ad-library-scraper/runs" \
--header "Authorization: Bearer $APIFY_TOKEN" \
--header "Content-Type: application/json" \
--data-binary @input.jsonLa 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.
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
Modifiez un réglage à la fois, gardez une petite limite et consultez le résumé avant d’élargir.
Seuls les 32 marchés indiqués sont couverts : UE/EEE, Royaume-Uni et Suisse. Les pays explicites sont recherchés séparément. Une liste regions vide recherche tous les marchés ensemble ; ["all"] recherche chaque pays séparément. Les pays non pris en charge sont ignorés. S’il n’en reste aucun, tous les marchés couverts sont recherchés.
Les proxys résidentiels sont nécessaires. Les sorties datacenter peuvent échouer à l’initialisation sans message clair. Gardez RESIDENTIAL avant de modifier les filtres pour diagnostiquer.
Conservez identifiant, nom juridique, URL, médias et dates de première et dernière diffusion. La portée peut être une tranche, et dépenses ou impressions peuvent manquer. Ces lignes ne montrent ni conversions ni succès. Sauvegardez rapidement les références média, dont les URL peuvent expirer, et gardez le contexte du pays recherché.
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.
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.
Ajoutez ad_id, advertiser_name, scraped_region, first_shown, last_shown et media_url. Regardez les vidéos avant d’annoter accroches, formats et angles produit.
Lire le guideDemandez à Claude d’organiser les métadonnées et citer les sources. Pour la vidéo, fournissez médias ou transcriptions via une méthode compatible. Les métadonnées seules ne montrent pas l’accroche.
Lire le guideComparez l’activité par annonceur et région. Gardez la portée en plage ; n’additionnez pas les observations régionales répétées comme personnes uniques.
Lire le guideGardez les observations brutes et une table créative par ad_id. Séparez les observations régionales et conservez les plages de portée d’origine.
Lire le guide
Vérifie jmlp/tiktok-ad-library-scraper et collecte jusqu’à 50 résultats Nike en FR. Sépare annonceurs et créateurs, résume dates et plages de portée, cite ad_library_url. Signale dépenses et impressions absentes. Ne décris pas les vidéos non examinées.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.
Ce scraper couvre 32 marchés de l’UE/EEE, du Royaume-Uni et de Suisse. Dépenses et impressions peuvent manquer ; estimated_audience contient les tranches de portée disponibles. Ces tranches et dates n’indiquent ni conversions ni ROAS. Les liens média peuvent expirer.
Cet Actor couvre les marchés de la bibliothèque commerciale dans l’UE/EEE, au Royaume-Uni et en Suisse. Il ne fournit pas de couverture des États-Unis ou mondiale.
L’extracteur fournit liens et métadonnées. L’analyse vidéo nécessite le média ou une transcription et une méthode compatible.
Source et informations actuelles : Actor TikTok Ad Library de JMLP sur Apify.
Facebook & Instagram01Regardez ce que vos concurrents annoncent.
Rassemblez les publicités concurrentes. Comparez textes, offres et dates avant de préparer votre prochaine campagne.
Recherche, YouTube et Display02Retrouvez les publicités d’une marque sur Google.
Collectez les créations diffusées sur la recherche, YouTube et Display. Comparez formats et marchés pour préparer votre campagne.
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