API de la bibliothèque publicitaire de Facebook : comment l'utiliser, ce qu'elle montre et ses véritables limites

Cet article de blog explique le fonctionnement de l'API Facebook Ad Library, les données qu'elle fournit et pourquoi de nombreux marketeurs finissent par être limités par cet outil lorsqu'ils analysent les publicités de leurs concurrents.

Kinnari Ashar

Par

Kinnari Ashar

Temps de lecture : 20 min

API de la bibliothèque publicitaire de Facebook

L'API Facebook Ad Library est l'outil officiel de Meta pour explorer les publicités publiques de Facebook et d'Instagram via du code plutôt que par des clics. Si vous avez déjà essayé de rechercher des publicités manuellement, vous savez déjà à quel point cela devient vite frustrant. Chercher une page à la fois, changer de région et suivre les campagnes actives ne s'adapte pas bien à grande échelle.

C'est pourquoi les gens commencent à s'intéresser à l'API : ils recherchent la rapidité, la structure et un moyen d'étudier les concurrents, les produits ou les marchés sans passer des heures dans l'interface de la bibliothèque publicitaire. 

Que vous soyez un marketeur évaluant les options de recherche, un dropshipper hésitant entre les vérifications manuelles et les outils, ou une agence explorant l'automatisation de la veille publicitaire, ce guide est fait pour vous. Vous n'allez pas seulement apprendre ce qu'est l'API. Vous verrez comment elle fonctionne concrètement dans des scénarios de recherche réels et là où elle ne suffit pas.

Points clés à retenir

  • L'API Facebook Ad Library offre un accès automatisé aux publicités publiques de Facebook et d'Instagram. 

  • Son utilisation nécessite une configuration de développeur, l'approbation d'autorisations et une gestion régulière des jetons d'accès.

  • L'API renvoie des enregistrements publicitaires bruts, et non des analyses, ce qui signifie que les créations doivent être examinées manuellement.

  • Les données de performance telles que les ventes, les bénéfices et les dépenses exactes ne sont pas disponibles.

  • Pour la plupart des utilisateurs de l'e-commerce, l'API est utile pour l'apprentissage et l'observation, mais difficile à utiliser pour prendre des décisions rapides sur le long terme.

Qu'est-ce que l'API Facebook (Meta) Ad Library ?

Meta propose une bibliothèque publicitaire publique qui permet à quiconque de rechercher des publicités diffusées sur Facebook et Instagram. Elle affiche les publicités actuellement actives ou diffusées par le passé, et elle est accessible via une interface web conçue pour une utilisation manuelle. 

L'API Facebook Meta Ad Library sert d'équivalent automatisé à cette bibliothèque. Vous n'avez plus besoin de parcourir les publicités page par page, car elle permet de récupérer les données publicitaires publiques dans un format structuré, rendant possible une analyse à grande échelle sans recherches manuelles répétitives.  

L'accès à celle-ci est également géré par le biais de la Graph API de Meta Platforms, c'est pourquoi l'API Ad Library nécessite des autorisations de développeur plutôt qu'un simple processus de connexion.

Facebook ad library

Quelles données fournit l'API Facebook Ad Library ?

L'API Facebook Ad Library contient les mêmes informations publicitaires publiques que Meta met à disposition par souci de transparence. Elle s'attache à montrer à quoi ressemblent les publicités, qui en est à l'origine et où elles sont diffusées.

En ce qui concerne les créations publicitaires, l'API vous permet d'examiner le message exact et les visuels utilisés dans les campagnes. C'est la raison pour laquelle la plupart des gens l'utilisent pour la recherche créative. 

Elle comprend : 

  • Les images et les vidéos utilisées dans la publicité

  • Le texte publicitaire principal, les titres et les descriptions

  • Les boutons d'appel à l'action affichés aux utilisateurs

  • Des liens d'aperçu qui ouvrent la publicité dans son format original

En plus des créations, l'API révèle également qui a diffusé la publicité et comment elle a été distribuée. Cela permet de situer chaque publicité dans son contexte. Elle indique : 

  • La page Facebook diffusant la publicité

  • Les pays où la publicité est apparue

  • La date de début et la date de fin, si la diffusion a cessé

  • Si la publicité est actuellement active ou inactive

Les données de budget et de portée sont incluses, mais seulement à un niveau global.

  • Les dépenses indiquées sous forme de fourchettes estimées

  • Les fourchettes d'impressions indiquant la portée approximative

Meta Platforms affiche ces informations sous forme de fourchettes pour éviter d'exposer les budgets exacts ou de permettre d'analyser trop facilement les performances des campagnes par rétro-ingénierie. 

Ce que l'API Facebook Ad Library ne montre PAS

Tout ce qui se passe après qu'un utilisateur a cliqué sur une publicité n'est pas inclus, et les indicateurs de performance restent privés pour l'annonceur.

Plus précisément, l'API Facebook Ad Library ne fournit pas :

  • Les données de conversion

  • Les chiffres de ventes ou de revenus

  • Les métriques de ROAS ou de CPA

  • Les détails du ciblage de l'audience

  • Tout signal confirmant si une publicité est rentable

Ces omissions sont délibérées. Meta Platforms limite l'accès aux données de performance et de ciblage afin d'éviter que les stratégies ou les résultats des annonceurs ne soient exposés.

À qui s'adresse réellement l'API Facebook Ad Library ?

L'API Ad Library est conçue pour extraire des enregistrements publicitaires en masse. Rien de plus.

Pour cette raison, elle convient aux équipes qui opèrent déjà à grande échelle. Les grandes marques et les agences l'utilisent pour surveiller l'activité publicitaire sur différents marchés, catégories ou concurrents. L'API alimente des tableaux de bord internes où les tendances, les variations de volume ou l'activité créative sont suivies au fil du temps plutôt qu'évaluées publicité par publicité.

Elle est également utile pour les dropshippers d'envergure qui gèrent plusieurs boutiques, marchés ou gammes de produits et disposent de l'infrastructure technique nécessaire pour traiter des données brutes. Dans ces cas, l'API soutient la surveillance du marché et l'analyse créative, et non une validation rapide.

Mais elle n'est pas très utile pour la plupart des annonceurs. Par exemple, si vous gérez une petite boutique, testez des produits ou essayez de décider si une publicité vaut la peine d'être reproduite, l'API ne vous sera pas d'une grande aide. Elle ne montre pas le ciblage. Elle ne montre pas les conversions. Elle ne vous dit pas si une publicité a généré de l'argent. 

Comment obtenir l'accès à l'API Facebook Ad Library ?

Étape 1 : Créer un compte Meta for Developers

Commencez par vous connecter à Facebook en utilisant un profil personnel réel. Les comptes anonymes ou partagés ne peuvent pas être utilisés pour l'accès développeur, même pour des tests basiques.

Une fois connecté, inscrivez-vous en tant que développeur via le portail pour développeurs de Meta. Cela associe votre compte Facebook personnel aux privilèges de développeur et vous permet de demander l'accès à l'API ultérieurement.

Pour les publicités liées à des enjeux sociaux, des élections ou de la politique, une vérification supplémentaire est requise. Meta vous demande de confirmer votre identité via Facebook.com/ID. Ce processus implique la soumission d'informations personnelles et peut prendre plusieurs jours avant d'être validé.

Cette exigence est délibérée. Meta Platforms considère la vérification de l'identité comme un élément essentiel pour la transparence et la prévention des abus. 

Étape 2 : Créer une application de développeur

Après vous être inscrit en tant que développeur Meta, accédez au tableau de bord des développeurs et choisissez l'option permettant de créer une nouvelle application. 

Lorsque vous y êtes invité, sélectionnez un type d'application prenant en charge le marketing ou l'accès professionnel. Terminez la configuration de base en nommant l'application et en l'attribuant à votre compte développeur.

Une fois l'application créée, elle devient la source par laquelle toutes les requêtes de l'API Ad Library sont effectuées. Chaque demande d'autorisation, jeton d'accès et limite d'utilisation est lié à cette application.

Toutes les requêtes de l'API Ad Library passent par cette application. Elle n'est pas facultative : sans elle, il est impossible de demander des données publicitaires, même si vous disposez déjà d'un accès développeur.

Étape 3 : Demander l'autorisation de lire les publicités

L'application étant prête, vous demandez maintenant l'autorisation qui donne accès aux données de la bibliothèque publicitaire. Cette autorisation détermine si votre application peut lire les publicités.

Meta peut examiner votre demande ou exiger une vérification.

Étape 4 : Générer un jeton d'accès

Un jeton d'accès est nécessaire avant de pouvoir faire une quelconque requête à l'API Ad Library, car Meta l'utilise pour vérifier qui envoie la requête et si cette requête est autorisée.

Vous créez le jeton depuis l'Explorateur Graph API en sélectionnant votre application de développeur. Un jeton d'accès utilisateur de base suffit, à condition que le compte Facebook associé ait effectué la vérification d'identité pour l'accès à la bibliothèque publicitaire.

Chaque requête API dépend de ce jeton. Lorsque le jeton expire, les requêtes échouent jusqu'à ce que vous en ayez généré un nouveau. C'est ici que de nombreux utilisateurs novices se retrouvent bloqués, car ils ne savent pas si le jeton a expiré. 

Une fois muni d'un jeton valide, vous pouvez tester l'accès en exécutant une simple requête Ad Library dans l'Explorateur Graph API pour vérifier que les données sont bien renvoyées. 

Comment utiliser l'API Facebook Ad Library ?

Étape 1 : Définir votre objectif de recherche

Avant d'effectuer la moindre requête API, formulez clairement une question à laquelle vous souhaitez que les données répondent. L'API ne renverra que ce que vous lui demandez explicitement. 

Commencez par choisir un axe précis :

  • un mot-clé de produit sur lequel vous souhaitez faire des recherches

  • un annonceur ou une page Facebook spécifique

  • les publicités diffusées dans un seul pays

  • les publicités actives ou les publicités qui ont déjà cessé d'être diffusées

Ne combinez pas plusieurs objectifs à ce stade.

Si vous recherchez un produit, saisissez des mots-clés qui apparaissent dans le texte de la publicité. Si vous analysez un concurrent, limitez les résultats à la page de cet annonceur. Lorsque la zone géographique a de l'importance, limitez les résultats à un seul pays. Décidez dès le départ si vous souhaitez des publicités actives, des publicités historiques ou les deux.

Ne sautez pas cette étape, car si vous le faites, l'API vous renverra de grands ensembles de publicités sans rapport. Les données seront peut-être correctes, mais elles ne vous seront d'aucune utilité.

Étape 2 : Demander les données publicitaires

Après avoir décidé de ce que vous voulez rechercher, vous envoyez une requête à Facebook pour obtenir les publicités.

Cela se fait via la Graph API de Facebook. Vous incluez votre jeton d'accès et les filtres choisis précédemment, tels que les mots-clés, les pays, le statut de la publicité ou un annonceur spécifique. Pour tester, beaucoup de personnes utilisent l'Explorateur Graph API. Pour une utilisation régulière, cela se fait généralement par du code.

Facebook traite la requête et vérifie si votre jeton d'accès et vos autorisations sont valides. Si c'est le cas, il renvoie les résultats.

Ce que vous obtenez n'est pas une page que vous pouvez parcourir visuellement. La réponse se compose de données brutes. Elle liste les publicités et les détails associés, mais il n'y a aucun visuel, aucun résumé ni aucun classement. Tout ce que vous souhaitez trier, comparer ou examiner doit être fait après cette étape. 

Étape 3 : Examiner les données renvoyées

Chaque enregistrement de publicité comprend un petit ensemble de champs auxquels vous pouvez vous référer. Ceux-ci incluent généralement un lien d'aperçu de la création, la page Facebook diffusant la publicité, ainsi que des fourchettes de dépenses et d'impressions. Ces informations vous aident à cibler les publicités méritant votre attention, mais elles n'affichent pas la création elle-même. 

Pour voir la publicité réelle, vous devez ouvrir le lien d'aperçu manuellement. C'est le seul moyen de voir les images, les vidéos et le message dans leur format d'origine. 

Le travail ici est simple. Parcourez les publicités renvoyées, choisissez celles qui correspondent à votre objectif de recherche et n'ouvrez que les créations pertinentes. Meta Platforms fournit les données, mais l'examen et l'interprétation des publicités nécessitent toujours un jugement manuel. 

Étape 4 : Récupérer tous les résultats (pagination)

Lorsqu'un résultat de recherche présente un volume élevé, l'API le divise en plusieurs lots. C'est ce qu'on appelle la pagination, et cela permet de gérer la charge.

Après avoir reçu la première réponse, vérifiez si d'autres résultats sont disponibles ; si oui, vous devez faire une nouvelle requête pour obtenir l'ensemble de publicités suivant. Cette opération doit être répétée jusqu'à ce qu'il ne reste plus aucun résultat.

C'est une erreur fréquente. Veillez à continuer d'envoyer des requêtes jusqu'à ce que l'API cesse de renvoyer des lots supplémentaires. Si vous ne récupérez pas tous les résultats, vos conclusions risquent d'être inexactes, en particulier si le volume est important.

Étape 5 : Analyser les publicités manuellement

Après avoir rassemblé toutes les publicités, exportez-les ou listez-les dans un format facile à exploiter, comme un tableur ou un tableau. Cela rend la comparaison possible.

Tout d'abord, regroupez les publicités par annonceur ou par produit. Rassemblez les publicités d'une même page Facebook ou regroupez celles qui font la promotion du même type de produit. Cela réduit l'encombrement et aide à faire ressortir les tendances plus rapidement.

Ensuite, ouvrez le lien d'aperçu de chaque publicité et examinez les créations une par une. Tout en faisant cela, notez trois éléments :

  • les créations qui se répètent avec de légères modifications

  • les publicités diffusées depuis une période prolongée

  • les messages ou les angles d'approche qui apparaissent dans plusieurs publicités

À présent, comparez les publicités au sein d'un même groupe. Observez l'évolution du message, les formats réutilisés et la récurrence de certaines idées. Ces répétitions ont bien plus d'importance que n'importe quelle publicité prise isolément.

Cette étape est la plus chronophage car rien n'est automatisé. Chaque modèle doit être repéré en examinant les publicités manuellement. 

Cas d'usage de l'API Facebook Ad Library pour les marketeurs

Recherche sur les publicités concurrentes

L'API Facebook Ad Library est souvent utilisée pour suivre les publicités des concurrents sans avoir recours à des recherches manuelles. En extrayant les publicités associées à une page Facebook spécifique, vous pouvez examiner toutes les campagnes actives et passées au même endroit. 

Cela s'avère précieux pour comprendre comment les marques présentent leurs offres, quel type de créations elles utilisent ou quels angles de message apparaissent de manière récurrente. C'est plus simple ainsi, car vous pouvez afficher les publicités côte à côte, repérer les évolutions et constater à quelle fréquence les créations changent.

Ce que ces données ne montrent pas, ce sont les performances. L'API ne révèle ni les conversions, ni le chiffre d'affaires, ni la rentabilité. Pour cela, vous devez faire le travail manuellement. 

Étude de marché et de niche

Pour les études à l'échelle d'un marché, les marketeurs utilisent l'API Facebook Ad Library pour comprendre où se concentre l'activité publicitaire et quelle est son intensité. L'objectif n'est pas de dénicher des produits gagnants, mais de voir à quel point un secteur semble saturé ou actif.

Les utilisations courantes de l'API dans ce cadre incluent :

  • Vérifier quels secteurs comptent un nombre élevé de publicités actives

  • Repérer quand plusieurs annonceurs commencent à promouvoir des produits similaires

  • Comparer le volume de publicité diffusé dans un pays par rapport à un autre

Recherche politique et de transparence

En dehors de l'e-commerce et de la recherche de produits, l'API Facebook Ad Library est largement utilisée pour surveiller la publicité politique et les enjeux de société. Dans ce cas,  l'objectif est l'archivage et la comparaison, et non l'optimisation.

  • Suivre les campagnes politiques et voir quelles publicités sont diffusées par des partis ou des organisations spécifiques

  • Examiner comment le message évolue au fil du temps pendant des élections ou des événements majeurs

  • Comparer la manière dont les questions sociales ou politiques sont promues à travers différents pays

L'API permet d'étudier ce qui est communiqué et où, mais elle ne fournit aucun aperçu de l'efficacité de la portée ou de la réaction du public.

Limites de l'API Facebook Ad Library

Elle donne certes accès aux données publicitaires publiques, mais elle comporte ses propres limites : elle n'est pas conçue pour la rapidité, le passage à l'échelle ou la surveillance continue. Ces restrictions deviennent évidentes dès que vous commencez à exécuter des requêtes régulières ou volumineuses.

  • Limites de débit (Rate limits) - Le nombre de requêtes est plafonné. Lorsque vous interrogez l'API trop souvent ou que vous extrayez de grands ensembles de données, les réponses ralentissent ou échouent.

  • Surcharge de performance - Chaque requête passe par une étape d'authentification et de traitement. La répétition des requêtes ajoute un délai notable.

  • Récupération inefficace des données - Certaines requêtes renvoient plus de données que nécessaire, tandis que d'autres exigent plusieurs appels pour compléter une seule vue.

  • Pas de mises à jour en temps réel - Les publicités n'apparaissent pas instantanément. Vous devez continuer à chercher manuellement les nouvelles données au lieu de recevoir les mises à jour automatiquement, ce qui s'avère particulièrement long.

  • Maintenance continue - Les jetons expirent, les autorisations changent et les flux de travail s'interrompent sans avertissement.

WinningHunter : La meilleure alternative à l'API Facebook Ad Library

Pour beaucoup de marketeurs, l'API Facebook Ad Library résout le problème de l'accès mais introduit d'autres types de frictions. La configuration prend du temps, les autorisations nécessitent un suivi, et le résultat se résume à des données brutes qu'il faut encore interpréter. Pour les équipes dépourvues de processus techniques, cela ralentit souvent le travail au lieu de l'aider. 

C'est pourquoi de nombreux marketeurs préfèrent les outils à l'utilisation directe de l'API. Les outils suppriment la phase de configuration et présentent les données sous une forme directement exploitable, sans avoir à gérer des jetons, des requêtes ou de la pagination. 

WinningHunter s'intègre parfaitement dans ce flux de travail lorsque l'objectif est la prise de décision plutôt que la collecte de données. Il exploite les données publicitaires publiques sans nécessiter d'accès à l'API et les restitue via des filtres et des tableaux de bord prêts à l'emploi. Au lieu d'analyser les fiches publicitaires une par une, vous pouvez vous concentrer sur l'essentiel.

Il apporte également un contexte manquant dans l'API Ad Library, tel que la notation des publicités, les estimations de dépenses et les aperçus de l'activité des boutiques ou des produits. Cela ne remplace pas les phases de test, mais contribue à réduire le temps passé à examiner manuellement des publicités peu susceptibles d'être pertinentes.

FAQ

L'API Facebook Ad Library est-elle gratuite ?

Oui, Meta ne facture rien pour l'utilisation de l'API Facebook Ad Library. Vous pouvez accéder aux données publicitaires publiques sans payer de frais. En revanche, cela vous coûte du temps. Vous avez besoin d'un compte développeur, d'approbations et d'une gestion continue des jetons d'accès. Lorsque les jetons expirent ou que les autorisations font défaut, vous devez résoudre le problème vous-même. Pour de nombreux utilisateurs, cette charge de gestion permanente constitue le coût réel.

Est-elle difficile à utiliser pour les débutants ?

Pour la plupart des débutants, son apprentissage rapide semble difficile. L'API ne vous guide pas et n'explique pas les résultats. Vous travaillez avec des réponses brutes et des messages d'erreur. Les utilisateurs se perdent souvent avec les autorisations, les résultats incomplets ou les problèmes de jeton sans comprendre pourquoi. Si vous n'avez pas l'habitude des API ou du traitement de données structurées, la progression a tendance à être lente et frustrante plutôt que formatrice.

L'API Facebook Ad Library peut-elle montrer les publicités gagnantes ?

Non. Elle ne montre pas les résultats. Vous ne pouvez pas voir les ventes, les conversions, les bénéfices ou le retour sur investissement publicitaire. Une publicité visible depuis longtemps ne signifie pas qu'elle a fonctionné. Cela signifie seulement qu'elle a été diffusée. L'API est un outil de transparence, pas de performance, et elle ne vous aide pas à déterminer quelles publicités sont réellement couronnées de succès.

Quand devrais-je cesser d'utiliser l'API pour passer à un outil ?

Vous devriez changer d'approche lorsque l'utilisation de l'API commence à retarder vos décisions. Si la majeure partie de votre temps est consacrée à extraire les données, les nettoyer et examiner les publicités une par une, l'API ne vous aide plus. Cela arrive généralement lorsque vous avez besoin de rapidité, de priorisation ou de validation plutôt que d'un accès brut à des enregistrements. 

Aller à

Kinnari Ashar

Auteur

Auteur

Kinnari Ashar

Kinnari Ashar

Kinnari Ashar est une stratège de contenu forte de plus de dix ans d'expérience dans les secteurs de la beauté, du style de vie et de la tech. Elle se spécialise dans la création de contenus qui captivent les audiences et génèrent un véritable engagement. Kinnari apporte également une expérience pratique dans la gestion de projets de dropshipping, en mettant l'accent sur la stratégie publicitaire et la recherche créative afin d'identifier des campagnes gagnantes et de les faire évoluer de manière rentable.

Kinnari Ashar est une stratège de contenu forte de plus de dix ans d'expérience dans les secteurs de la beauté, du style de vie et de la tech. Elle se spécialise dans la création de contenus qui captivent les audiences et génèrent un véritable engagement. Kinnari apporte également une expérience pratique dans la gestion de projets de dropshipping, en mettant l'accent sur la stratégie publicitaire et la recherche créative afin d'identifier des campagnes gagnantes et de les faire évoluer de manière rentable.

Lire des articles similaires

Prêt à créer la prochaine boutique à 100 000 $ par jour ?

Écran d'accueil de WinningHunter avec barre de recherche de marque pour analyser les publicités, les boutiques et les produits de n'importe quelle marque

Prêt à créer la prochaine boutique à 100 000 $ par jour ?

Écran d'accueil de WinningHunter avec barre de recherche de marque pour analyser les publicités, les boutiques et les produits de n'importe quelle marque

Prêt à créer la prochaine boutique à 100 000 $ par jour ?

Écran d'accueil de WinningHunter avec barre de recherche de marque pour analyser les publicités, les boutiques et les produits de n'importe quelle marque