Retour aux API
Données indépendantes de la Facebook Ad Library

Facebook Ad Library API

Recherchez des publicités Facebook publiques par mot-clé, trouvez des Pages d’annonceurs, collectez les publicités d’un ID de Page ou récupérez une publicité connue, avec des champs normalisés de création, de médias, de diffusion, de CTA et de destination.

API Facebook Ad Library disponibles

Utilisez Search pour découvrir des publicités par mot-clé, Company Search pour trouver un ID de Page, Company Ads pour collecter les publicités de cette Page, ou Ad Details pour récupérer une publicité publique connue.

Quelles données de la Facebook Ad Library pouvez-vous récupérer ?

SocQ renvoie des enregistrements publics normalisés de publicités et d’annonceurs, pour l’étude des créations, la veille concurrentielle, l’analyse de campagnes et les jeux de données publicitaires.

Résultats de recherche de publicités

Recherchez des publicités publiques par mot-clé ou expression exacte, avec filtres facultatifs de pays, statut, média, type de publicité, date, tri et limite de résultats.

Enregistrements de Pages d’annonceurs

Trouvez les ID de Page, noms, URL, catégories, pays, images, valeurs de vérification, mentions « J’aime » visibles de la Page et contexte Instagram lié.

Collections de publicités par Page

Collectez un ensemble borné de publicités publiques uniques pour un ID de Page d’annonceur numérique, avec des filtres facultatifs de diffusion et de média.

Textes et médias de création

Récupérez les titres, textes principaux, descriptions de liens, formats d’affichage et références d’images ou de vidéos publiques dédupliquées de chaque publicité, lorsqu’ils sont disponibles.

Contexte de diffusion et de marché

Conservez les dates de début et de fin, le statut actif, les plateformes de diffusion, les pays, la portée, la devise, les dépenses et les signaux de mentions « J’aime » de la Page, lorsqu’ils sont disponibles.

Appels à l’action et destinations

Récupérez le texte et le type de CTA visibles, les URL de destination publiques, les URL de l’Ad Library, l’identité de l’annonceur et les horodatages de collecte lorsqu’ils sont exposés.

SocQ vs Meta Ad Library API

SocQ propose des workflows prêts à l’emploi de collecte de publicités publiques. L’API Ad Library de Meta est le choix officiel pour accéder directement à l’archive de transparence publicitaire de Meta.

FonctionnalitéSocQMeta Ad Library API
Usage principalRechercher des publicités publiques et collecter des détails d’annonceurs ou de publicitésInterroger l’archive officielle de transparence publicitaire de Meta
AuthentificationClé API SocQ ; pas d’OAuth Facebook côté clientApplication Meta, jeton d’accès et accès à l’Ad Library
Entrée de départMot-clé, nom d’entreprise, ID de Page ou URL publique de l’Ad LibraryParamètres de requête de l’archive officielle et identifiants Meta
Créer ou gérer des publicitésNon pris en chargeNon pris en charge ; utilisez la Meta Marketing API
Format de réponseEnregistrements SocQ normalisésObjets natifs de la Meta Graph API

Fonctionnement de l’API Facebook Ad Library

Les quatre API suivent le même workflow : tâche asynchrone, puis résultats paginés.

  1. 1. Choisir l’API et l’entrée

    Partez d’un mot-clé, d’un nom d’entreprise, d’un ID de Page numérique ou d’une URL publique /ads/library, selon l’enregistrement voulu.

  2. 2. Envoyer et suivre la tâche

    Envoyez la requête POST correspondante, conservez le task_id renvoyé et interrogez /v1/tasks/{task_id} jusqu’à la fin du traitement.

  3. 3. Lire les résultats normalisés

    Traitez data.results.items et suivez next_cursor tant que has_more vaut true.

Rechercher des publicités publiques par mot-clé

Authentifiez-vous avec votre clé API SocQ et envoyez un mot-clé à l’endpoint Search. Les autres API Ad Library suivent le même flux de tâche.

curl -X POST "https://api.socq.ai/v1/facebook-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"status":"ACTIVE"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage courants de l’API Facebook Ad Library

Veille des publicités concurrentes

Suivez les publicités publiques de Pages d’annonceurs choisies et comparez dans le temps créations, médias, statut de diffusion, marchés, CTA et destinations.

Étude des créations et des messages

Recherchez des termes de produit, de catégorie ou de marque pour examiner les textes publicitaires, formats, médias, appels à l’action et pages de destination publics.

Découverte d’annonceurs

Transformez des noms d’entreprises ou de marques en ID de Page publics et en champs d’identité avant de collecter un ensemble ciblé de publicités d’une Page.

Jeux de données publicitaires

Stockez les ID de publicités, enregistrements d’annonceurs, champs de création, contexte de diffusion, URL sources et horodatages collected_at normalisés pour l’analyse.

Limites et politique sur les données publiques

Les résultats de la Facebook Ad Library sont des enregistrements publics pris à un instant donné. Ces API ne gèrent pas les comptes publicitaires et ne fournissent aucune donnée privée de performance de campagne.

  • Search exige une seule requête non vide ; results_limit vaut 100 par défaut et accepte des entiers de 20 à 2 000.
  • Company Search accepte une seule requête de nom d’entreprise ou de Page, n’accepte pas results_limit et peut renvoyer plusieurs Pages candidates aux noms proches.
  • Company Ads exige un seul ID de Page numérique ; results_limit accepte de 20 à 2 000 et les filtres peuvent réduire le nombre d’enregistrements renvoyés.
  • Ad Details accepte une seule URL publique facebook.com/ads/library avec un id numérique et renvoie au plus un enregistrement de publicité normalisé.
  • Une tâche terminée peut ne renvoyer aucun enregistrement lorsqu’une publicité, une Page ou un jeu de résultats filtré n’est pas disponible dans la source publique.
  • Les champs de portée, de dépenses, de devise, de médias, de dates, de CTA, de destination et d’annonceur peuvent être absents et ne doivent pas être interprétés comme des zéros.

Questions fréquentes sur l’API Facebook Ad Library

Qu’est-ce que l’API Facebook Ad Library ?

L’API Facebook Ad Library est un ensemble d’endpoints SocQ pour rechercher des publicités publiques, trouver des Pages d’annonceurs, collecter les publicités d’une Page et récupérer les détails de publicités publiques connues.

Quelle API Facebook Ad Library dois-je utiliser ?

Utilisez Search pour la découverte par mot-clé, Company Search pour trouver un ID de Page, Company Ads pour collecter les publicités de cet ID, et Ad Details pour une URL publique connue de l’Ad Library.

Que puis-je rechercher et filtrer ?

Search accepte un mot-clé ou une expression exacte, plus des filtres facultatifs de pays, statut, média, type de publicité, date, tri et limite de résultats. Company Ads prend en charge des filtres de diffusion et de média propres à une Page.

Quelles données publicitaires publiques sont renvoyées ?

Les résultats peuvent inclure l’identité de la publicité et de l’annonceur, le texte de création, des images ou vidéos, les dates de diffusion, le statut actif, les plateformes de diffusion, les pays, le CTA, la destination et les signaux publics visibles.

Pourquoi une requête terminée peut-elle ne renvoyer aucun résultat ?

La source publique peut ne contenir aucune correspondance pour l’entrée envoyée, les filtres peuvent exclure tous les enregistrements, ou la publicité ou la Page demandée peut ne plus être publiquement disponible.

Est-ce la même chose que l’API de données sociales Facebook ou de Marketplace ?

Non. Les endpoints Facebook Ad Library sont distincts des API SocQ pour les Pages, publications et commentaires Facebook, ainsi que de ses API d’annonces du Facebook Marketplace.

Comment les résultats de la Facebook Ad Library sont-ils tarifés ?

Les publicités de Search, les candidats de Company Search et les enregistrements de Company Ads coûtent 0,5 crédit par résultat renvoyé. Ad Details coûte 0,6 crédit par résultat renvoyé, et un résultat vide n’entraîne aucun frais de résultat.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

X API

Collectez des profils publics, les relations d’abonnés et d’abonnements, des posts, des réponses, des citations, les comptes qui ont reposté, des résultats de recherche et les tendances actuelles. Des résultats homogènes pour vos recherches et votre veille.

LinkedIn API

Récupérez des données LinkedIn publiques de profils, d’entreprises, de publications et d’offres d’emploi à partir d’URL connues, avec des champs normalisés d’identité, de carrière, d’entreprise, de contenu, d’engagement et d’offre.

Reddit API

Récupérez les publications et commentaires Reddit publics à partir d’URL connues, parcourez les publications récentes, les mieux notées ou tendance d’un subreddit, ou recherchez des discussions par mot-clé et par période de publication.

Pinterest API

Récupérez les données de profils Pinterest publics, résolvez des Pins connus, collectez les Pins de profils sélectionnés ou lancez une recherche par mot-clé pour étudier les créateurs, les contenus et les tendances visuelles.

Threads API

Récupérez des profils Threads publics, résolvez des publications connues ou collectez les publications de profils sélectionnés, avec des champs normalisés d’identité, de contenu, de médias, d’engagement et d’horodatage.

Bluesky API

Récupérez des profils Bluesky publics, résolvez des URL de publications connues ou collectez une page de publications d’un compte, avec identité, contenu, médias, horodatages et champs d’engagement visibles normalisés.