facebook-ad-library/
ad

Collectez une publicité publique de la Facebook Ad Library à partir de son URL et obtenez texte de la création, contexte de l’annonceur, médias, calendrier de diffusion et signaux visibles sous forme d’enregistrement normalisé.

Facebook Ad Library Ad API

URL de l’Ad Library
Création et contexte de l’annonceur
Signaux publics de diffusion
0,6 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlObligatoireURL 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.

  1. 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.
  2. Envoyez url à /v1/facebook-ad-library/ad et récupérez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. 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 item

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données Facebook Ad Library avec les données publiques d’autres plateformes sociales prises en charge.

Facebook Ad Library Ad API — FAQ

Facebook Ad Library Ad API récupère une publicité publique à partir d’une URL de l’Ad Library. Elle renvoie le texte normalisé de la création, le contexte de l’annonceur, les médias, le calendrier de diffusion, les appels à l’action et les signaux publics disponibles.

Envoyez une URL publique sous la forme canonique https://www.facebook.com/ads/library/?id={numeric_id}. Le chemin doit être /ads/library et le paramètre de requête id doit être numérique.

Un enregistrement peut contenir l’ID d’archive et l’URL de la publicité, le titre et le texte de la création, les champs de la Page de l’annonceur, les médias, les dates et le statut de diffusion, les plateformes de diffusion, les pays, les détails du CTA, l’URL de destination, les mentions J’aime de la Page, la portée, la devise, les dépenses et le contexte de collecte.

Une URL syntaxiquement valide peut pointer vers une publicité publique indisponible ou introuvable. Dans ce cas, la tâche peut réussir sans créer de résultat fictif.

Le nom et le texte normalisés retiennent les valeurs disponibles de l’instantané ou de la première carte, tandis que les médias contiennent les éléments uniques trouvés dans l’instantané et les cartes. L’enregistrement n’est pas un tableau complet de toutes les variantes de création.

Chaque enregistrement de publicité renvoyé avec succès coûte 0,6 crédit SocQ. Une tâche qui ne renvoie aucun résultat n’entraîne aucun frais de résultat.