Facebook & InstagramCollectez les publicités Facebook et Instagram de vos concurrents. Repérez offres et messages récurrents, puis préparez vos propres tests créatifs.
Essayez ces exemples pour le marketing, la croissance et l’analyse concurrentielle.
Pour une marque par abonnement, suivez cinq concurrents chaque lundi. Classez les annonces par problème, promesse, preuve et offre. Choisissez trois angles pour vos prochains tests.
Vous aurez un tableau avec liens créatifs, catégories d’accroches, notes et test proposé.
Collectez les annonces quotidiennement autour d’une vente saisonnière. Comparez nouveaux identifiants et textes pour suivre remises, lots et promesses de livraison.
Gardez une chronologie de lancement et une bibliothèque d’offres annotées.
Recherchez une catégorie comme running shoes pour découvrir d’autres annonceurs. Vérifiez les résultats avant de les ajouter à votre suivi régulier.
Élargissez la liste concurrentielle et choisissez qui étudier en premier.
DU PREMIER ESSAI AU FLUX RÉCURRENT
{
"pageIDs": ["ZARA"],
"country": "GB",
"activeStatus": "active",
"maxAds": 50,
"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 ApifyChoisissez une page si vous connaissez l’annonceur, ou un mot-clé pour découvrir des annonces sur un sujet. Ce sont des recherches distinctes : un mot-clé ne filtre pas automatiquement toutes les pages saisies.
| 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 changeIndiquez des identifiants, noms, pseudonymes ou liens Facebook. Les correspondances vérifiées sont prioritaires ; plusieurs correspondances exactes non vérifiées peuvent donner plusieurs pages. |
| Recherche par mots-clés | Quand l’utiliserVous cherchez des résultats pertinents avant de choisir des cibles précises. | Ce qui changePlusieurs recherches thématiques avec les mêmes pays, dates et type de correspondance. Elles partagent maxAds ; les résultats répétés sont dédupliqués. |
| 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 pages, recherches ou annonces individuelles. Les filtres d’un lien de recherche priment ; un lien d’annonce récupère celle-ci sans ces filtres. |
Début d’une période de diffusion au format YYYY-MM-DD. Des annonces commencées auparavant peuvent correspondre. Deux dates identiques élargissent la période d’un jour.
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.
adLibraryUrlsCollez des liens de pages, recherches ou annonces individuelles. Les filtres d’un lien de recherche priment ; un lien d’annonce récupère celle-ci sans ces filtres.
adLibraryUrlVersion à un seul lien de adLibraryUrls. Utilisez un seul de ces champs pour éviter les ambiguïtés. Les liens Facebook ordinaires utilisent les filtres globaux.
pageIDsIndiquez des identifiants, noms, pseudonymes ou liens Facebook. Les correspondances vérifiées sont prioritaires ; plusieurs correspondances exactes non vérifiées peuvent donner plusieurs pages.
pageIDUne page, dans les mêmes formats que pageIDs. Effacez la page préremplie pour une recherche par mot-clé uniquement, sinon les deux cibles sont collectées.
keywordTrouve les annonces sur un thème parmi les annonceurs. Cette recherche est distincte des pages et s’ajoute aux cibles déjà renseignées.
keywordsPlusieurs recherches thématiques avec les mêmes pays, dates et type de correspondance. Elles partagent maxAds ; les résultats répétés sont dédupliqués.
searchTypekeyword_unordered accepte les mots dans tout ordre ; keyword_exact_phrase exige la phrase exacte. Uniquement pour les mots-clés ; search_type du lien prime.
keyword_unordered keyword_exact_phraseminDateDébut d’une période de diffusion au format YYYY-MM-DD. Des annonces commencées auparavant peuvent correspondre. Deux dates identiques élargissent la période d’un jour.
maxDateFin incluse de la période de diffusion. Avec minDate, sélectionne les annonces diffusées pendant cette période, pas seulement celles créées alors.
activeStatusactive collecte les annonces en cours ; inactive les annonces arrêtées ; all inclut l’historique. Le formulaire préremplit active, mais un champ omis utilise all.
all active inactivecountryUn code ou nom de pays, ou ALL pour tous. Un pays inconnu devient ALL avec un avertissement ; consultez le journal si le filtre semble trop large.
proxyConfigurationUtilisez un proxy résidentiel Apify. Les sorties datacenter sont souvent bloquées. Gardez useApifyProxy à true et apifyProxyGroups à RESIDENTIAL.
maxConcurrencyDe 1 à 6 sessions parallèles. Plusieurs cibles et grandes périodes peuvent être traitées ensemble. Utilisez 1 pour l’ordre strict ou en cas de captcha ; la valeur par défaut est 4.
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 de chaque sous-période, pas de tout le run. Utile pour tester ; effacez pour élargir. Zéro ou vide signifie illimité.
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.
pageSizeTaille de lot demandée, pas un nombre garanti. Meta renvoie environ 10 annonces par page ; augmenter cette valeur ne supprime pas cette limite.
rawRenvoie la structure source plutôt que la présentation normalisée. Gardez false pour des colonnes cohérentes ; utilisez true pour déboguer ou effectuer vos propres transformations.
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.
shardSplitThresholdDivise les grandes périodes au-delà de ce nombre d’annonces. Seulement avec maxConcurrency supérieur à 1. Gardez 1500 sauf optimisation d’archives ; les valeurs sous 100 deviennent 100.
docIdRemplace un identifiant interne de requête. Laissez vide : l’Actor actualise les identifiants obsolètes. Ce n’est pas un identifiant d’annonceur ou d’annonce.
proxySessionIdFixe une session proxy pour le débogage. Laissez vide en usage normal. Les tâches parallèles nécessitent leurs propres sessions et peuvent ignorer cette session fixe.
impersonateIdentité du navigateur utilisée pour les requêtes. Gardez la valeur par défaut sauf pour diagnostiquer un blocage immédiat. Elle modifie l’empreinte des requêtes, pas les données demandées.
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 les annonces actives de deux marques au Royaume-Uni, avec 100 annonces uniques au total. Planifiez une nouvelle collecte chaque semaine, ajoutez une date dans Sheets et comparez les identifiants avec la semaine précédente.
{
"pageIDs": ["ZARA", "H&M"],
"country": "GB",
"activeStatus": "active",
"maxAds": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Recherchez les annonces américaines utilisant l’expression « free shipping ». La recherche porte sur plusieurs annonceurs. Remplacez l’expression par votre offre et effacez toute page préremplie avant de lancer.
{
"keywords": ["free shipping"],
"searchType": "keyword_exact_phrase",
"country": "US",
"activeStatus": "active",
"maxAds": 50,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Cet exemple de septembre 2026 recherche les annonces diffusées pendant une période. Modifiez les deux dates. Les filtres portent sur le chevauchement de diffusion : une annonce peut avoir été créée avant la première date.
{
"pageIDs": ["ZARA"],
"country": "GB",
"activeStatus": "all",
"minDate": "2026-09-01",
"maxDate": "2026-09-30",
"maxAds": 100,
"maxConcurrency": 4,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Utilisez les identifiants de page et de création pour les jointures, et conservez liens, texte, médias et dates. Pour les annonces commerciales, l’absence de dépenses ou de portée est normale ; la bibliothèque ne fournit pas de conversions. Gardez les relevés hebdomadaires dans BigQuery, aplatissez les médias avec dbt et affichez les nouvelles créations dans Looker Studio.
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~meta-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.
Indiquez des identifiants, noms, pseudonymes ou liens Facebook. Les correspondances vérifiées sont prioritaires ; plusieurs correspondances exactes non vérifiées peuvent donner plusieurs pages.
Utilisez un proxy résidentiel Apify. Les sorties datacenter sont souvent bloquées. Gardez useApifyProxy à true et apifyProxyGroups à RESIDENTIAL.
Remplace un identifiant interne de requête. Laissez vide : l’Actor actualise les identifiants obsolètes. Ce n’est pas un identifiant d’annonceur ou d’annonce.
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.
Utilisez Make ou n8n pour ajouter les résultats après chaque succès. Dédupliquez avec ad_archive_id et ajoutez collected_at. Prévoyez des colonnes pour accroches, notes d’offres et prochains tests.
Lire le guideDemandez à Claude un nombre limité d’annonces d’une page, groupées par thème avec ad_archive_id. Vérifiez les créations d’origine avant d’utiliser la synthèse.
Lire le guidePlacez les champs utiles dans un tableau ou BigQuery. Tracez les annonces par annonceur, début et plateforme. Présentez les comptes comme observations de la bibliothèque.
Lire le guideGardez le JSON brut de chaque exécution avec sa date. Utilisez dbt pour décomposer snapshot et une table créative séparée par ad_archive_id.
Lire le guide
Utilise jmlp/meta-ad-library-scraper pour collecter jusqu’à 50 annonces actives ZARA en GB. Vérifie d’abord le schéma de l’Actor. Regroupe messages par accroche et offre, cite les identifiants d’origine et propose trois hypothèses de campagne testables. Ne déduis ni dépenses ni conversions.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.
Les annonces commerciales ne publient généralement ni dépenses ni portée. Meta le fait surtout pour les annonces politiques et sociales. Une annonce durable mérite une étude, mais son âge ne révèle ni conversion, rentabilité ni ROAS.
Oui. Il lit la bibliothèque publique, sans compte Facebook. Un compte Apify reste nécessaire.
Vous pouvez étudier les messages récurrents et créations durables. La bibliothèque ne donne pas les conversions nécessaires pour déclarer une publicité gagnante.
Source et informations actuelles : Actor Meta Ad Library de JMLP sur Apify.
Recherche, YouTube et Display01Retrouvez 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.
Bibliothèque de contenus commerciaux02Trouvez des idées de vidéos à tester.
Collectez les annonces TikTok de 32 marchés dans l’UE/EEE, au Royaume-Uni et en Suisse. Conservez vidéos et dates de diffusion, puis examinez les créations qui vous intéressent.
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