Facebook Ad Library Ad
Les publicités de la Facebook Ad Library sont des enregistrements publicitaires publics, avec le texte de la création, l’identité de l’annonceur, les médias, les appels à l’action, le calendrier de diffusion, le statut actif et les signaux de portée ou de dépenses disponibles. Ces champs servent à enrichir une publicité choisie, à examiner des créations, à surveiller la diffusion publique et à comparer des états à un instant donné.
Fonctionnalités de la Facebook Ad Library Ad API
- Résolution directe d’une URL de l’Ad LibraryTransformez une URL publique /ads/library avec un paramètre de requête id numérique en un enregistrement de publicité normalisé au plus.
- Création et contexte de l’annonceurRenvoie l’ID d’archive de la publicité, le titre et le texte de la création, l’identité de la Page de l’annonceur, l’URL publique de la Page, l’appel à l’action et le lien de destination, lorsqu’ils sont exposés.
- Diffusion et signaux visiblesConserve les dates de début et de fin, le statut actif, les plateformes de diffusion, le contexte par pays, les mentions J’aime de la Page, la portée, la devise et les dépenses lorsque l’enregistrement public les fournit.
- Médias multi-cartes normalisésSélectionne le texte de l’instantané ou de la première carte pour les champs standard et dédoublonne les images et vidéos trouvées dans l’instantané et les cartes, sans présenter un tableau complet des variantes.
Paramètres de la Facebook Ad Library Ad API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL obligatoire d’une publicité publique de la Facebook Ad Library. Utilisez la forme canonique https://www.facebook.com/ads/library/?id={numeric_id} ; une requête accepte une seule URL. |
Comment utiliser la Facebook Ad Library Ad API
Envoyez une URL publique de l’Ad Library, suivez la tâche asynchrone, puis lisez l’enregistrement de publicité normalisé dans l’enveloppe de résultat standard.
- Préparez une URL publique de la Facebook Ad Library dont le chemin est /ads/library et dont la requête contient un id numérique.
- Envoyez url à /v1/facebook-ad-library/ad et récupérez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez data.results.items ; cet endpoint renvoie au plus un enregistrement, si bien que next_cursor reste normalement null et has_more reste false.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/ad" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.facebook.com/ads/library/?id=702369045530963"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this operation returns at most one itemCas d’usage de la Facebook Ad Library Ad API
- Enrichir une publicité choisie : Servez-vous de l’ID d’archive, de l’identité de l’annonceur, du titre de la création, du texte principal, des médias, du CTA, de l’URL de destination et de l’URL d’entrée pour compléter un enregistrement de publicité existant.
- Examiner les visuels et les destinations : Inspectez les références d’images ou de vidéos dédoublonnées avec le format d’affichage, le texte et le type de CTA et le lien de destination public d’une publicité connue.
- Étudier le contexte public de diffusion : Exploitez le statut actif, les dates de début et de fin, les plateformes de diffusion, les pays et les champs de portée ou de dépenses disponibles pour examiner le contexte public de diffusion.
- Conserver des instantanés de publicités à un instant donné : Stockez les champs de création, d’annonceur, de diffusion, de signaux visibles, l’URL d’entrée et collected_at pour comparer plus tard une même publicité connue.
Conseils d’expert pour la Facebook Ad Library Ad API
- Envoyez une URL de l’Ad Library avec le chemin exact /ads/library et un paramètre de requête id numérique ; les URL de Page, les ID de Page, les URL de post et les ID de publicité bruts ne sont pas des entrées acceptées.
- Considérez une tâche réussie sans enregistrement comme un résultat valide de publicité indisponible ou introuvable, lorsque l’URL envoyée est syntaxiquement valide.
- Traitez la portée, les dépenses, les mentions J’aime de la Page, les médias, end_at, l’URL de profil de l’annonceur, le CTA et les valeurs de pays comme des champs publics facultatifs, au lieu de convertir les valeurs manquantes en zéro.
- Pour les publicités à plusieurs cartes ou créations, utilisez le nom et le texte normalisés comme champs représentatifs et examinez la liste de médias dédoublonnée sans supposer qu’elle forme un tableau complet par variante.
API associées
En complément de la Facebook Ad Library Ad API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook Ad Library.
- Facebook Ad Library Search API — Recherchez des publicités publiques par mot-clé avec contrôle de la correspondance, de la publicité, du pays, du statut, des médias, du tri, de la date et du nombre de résultats.
- Facebook Ad Library Company Search API — Trouvez des Pages d’annonceurs par nom d’entreprise ou de Page avec ID de Page, classifications, images, audience visible et signaux Instagram associés.
- Facebook Ad Library Company Ads API — Collectez les publicités publiques d’une Page d’annonceur à partir de son ID avec création publicitaire, diffusion, marché, médias, CTA et signaux visibles.