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é | SocQ | Meta Ad Library API |
|---|---|---|
| Usage principal | Rechercher des publicités publiques et collecter des détails d’annonceurs ou de publicités | Interroger l’archive officielle de transparence publicitaire de Meta |
| Authentification | Clé API SocQ ; pas d’OAuth Facebook côté client | Application Meta, jeton d’accès et accès à l’Ad Library |
| Entrée de départ | Mot-clé, nom d’entreprise, ID de Page ou URL publique de l’Ad Library | Paramètres de requête de l’archive officielle et identifiants Meta |
| Créer ou gérer des publicités | Non pris en charge | Non pris en charge ; utilisez la Meta Marketing API |
| Format de réponse | Enregistrements SocQ normalisés | Objets 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. 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. 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. Lire les résultats normalisés
Traitez data.results.items et suivez next_cursor tant que has_more vaut true.
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 trueCas 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.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
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.



