Aller au contenu

API de la Bibliothèque publicitaire de Meta : les publicités Facebook et Instagram en JSON

Recherchez dans la Bibliothèque publicitaire de Meta par mot-clé ou par annonceur et recevez en JSON, via une API asynchrone, les publicités diffusées sur Facebook, Instagram, Messenger, WhatsApp et Threads, chacune avec son texte, ses images et sa vidéo, sa page de destination, son appel à l'action, sa date de début et ses plateformes.

Recherches dans la Bibliothèque publicitaire de Meta lancées le 20 novembre 2026, dessinées avec les annonces renvoyées.

Toutes les publicités d'un annonceur sur Meta

Envoyez taskType ADS avec payload.platform meta_ad_library et l'ID de la page Facebook d'un annonceur dans pageId, ou un mot-clé dans query. Chaque publicité revient avec son ID dans la bibliothèque, sa date de début, les plateformes où elle est diffusée, le nombre de publicités qui partagent son contenu, son texte, ses images ou sa vidéo, sa page de destination et son appel à l'action, avec le nombre de publicités correspondantes compté par la bibliothèque. Les résultats arrivent par webhook ou par interrogation.

Active
Library ID: 2033461067351971
Started running on Nov 14, 2026
Platforms
This ad has multiple versions
5 ads use this creative and text
See summary details
soundcoreSponsored
🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.
libraryId2033461067351971
L'ID de l'annonce dans la Bibliothèque publicitaire de Meta ; libraryUrl l'y ouvre.
startDateisActive2026-11-14 · true
Le jour où l'annonce a commencé, et si elle est toujours diffusée.
platformsFACEBOOK, INSTAGRAM
Les applications Meta qui affichent l'annonce.
versionsformat5 · DCO
Le nombre d'annonces qui partagent ce visuel et ce texte ; DCO désigne une annonce que Meta compose à partir de cartes.
pageNamepageLikeCountsoundcore · 147919
La page de l'annonceur et ses mentions J'aime, avec pageId pour chercher ses autres annonces.
body🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.
Le texte de l'annonce au-dessus de l'image.
cards2
Chaque carte avec son image ou sa vidéo, son texte et son lien ; la bibliothèque montre la première.
titlectaTextlinkUrlAeroClip 2 Open-Ear · Shop now
La barre de lien sous l'image : titre, description, bouton et linkUrl.
La première annonce renvoyée par une recherche ADS sur la page de soundcore aux États-Unis le 20 novembre 2026, dessinée comme la fiche de la bibliothèque.
Étape 1

Recherche par mot-clé ou par annonceur

query trouve les mots du texte d'une publicité dans n'importe quel ordre, ou comme expression exacte avec searchType keyword_exact_phrase. pageId réunit les publicités d'un annonceur. country fixe le pays de diffusion, ALL cherche dans tous les pays et limit renvoie jusqu'à 500 publicités en une requête. Envoyez le nextCursor d'une réponse comme cursor pour recevoir les publicités suivantes.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "limit": 500
  }
}
  1. limit: 500Annonces 1 à 50038,1s
  2. cursor: "eyJ2IjoxLCJoIj…"Annonces 501 à 85528,7s

855 annonces en deux réponses, chacune une foistotalCount: 855

Deux recherches ADS sur la page de soundcore aux États-Unis le 20 novembre 2026 ; la seconde a envoyé comme cursor le nextCursor de la première.
Étape 2

Trouver l'ID de page d'un annonceur par son nom

action advertisers renvoie les pages Facebook dont le nom correspond à query, dans l'ordre où la barre de recherche de la bibliothèque les suggère, chacune avec son pageId, sa catégorie, ses mentions J'aime, son badge de vérification et son compte Instagram. Envoyez le pageId choisi pour recevoir les publicités de cet annonceur.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "action": "advertisers",
    "query": "soundcore",
    "country": "US"
  }
}
USsoundcore
"soundcore"Search this exact phrase
Advertisers
soundcore@soundcoreaudio · 148K follow this · Electronics@soundcoreaudio · 154K followers266556540473351
AnkerSoundcoreuk@ankersoundcoreUK · 1.8K follow this · Information Technology Company328639343660125
Anker soundcore Polska@AnkersoundcorePL · 1.4K follow this · Electronics@anker_soundcore_polska · 2.9K followers613865685153030
soundcore Deutschland1.2K follow this · Music & Audio@soundcore_de · 17.8K followers265641373306592
L'action advertisers pour « soundcore » aux États-Unis le 20 novembre 2026 : les 4 premières des 15 pages renvoyées, dans l'ordre où le champ de recherche de la bibliothèque les propose, chacune avec son pageId.
Étape 3

Filtrer par statut, format, plateforme et date

activeStatus choisit les publicités actives, inactives ou toutes, mediaType garde les publicités image, vidéo ou mème, et publisherPlatforms celles de Facebook, Instagram, Audience Network, Messenger, WhatsApp ou Threads. contentLanguages, startDate et endDate restreignent les publicités à leurs langues et à leurs jours de diffusion, et sortBy les trie par impressions ou de la plus récente à la plus ancienne.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "mediaType": "video",
    "publisherPlatforms": [
      "instagram"
    ],
    "startDate": "2026-11-01"
  }
}
activeStatus
  • all903
  • active856
  • inactive47
mediaType
  • meme761
  • video98
  • image0
publisherPlatforms
  • facebook856
  • instagram856
  • threads340
  • audience_network202
  • whatsapp176
  • messenger0

Cette requête98

Le décompte de la bibliothèque pour chaque filtre sur la page de soundcore aux États-Unis, le 20 novembre 2026. mediaType et publisherPlatforms comptent les annonces actives.

Ce que l'IA recommande, et qui en fait la publicité

Envoyez une question d'achat à un moteur de réponse, puis recherchez par son nom chaque produit recommandé dans la Bibliothèque publicitaire de Meta pour voir quelles marques font la publicité des produits choisis par l'IA et quels autres annonceurs diffusent des publicités sur ces noms.

Recommandés par ChatGPT · “What are the best wireless earbuds under $200?”Annonces Meta actives qui le citent, États-Unis
  1. Soundcore Liberty 5 Pro211 annonces2 annonceurssoundcore210
  2. Apple AirPods Pro 3464 annonces90 annonceursCosmopolitan63James Martin Jewelers55BILL27
  3. Technics EAH-AZ800 annonce
  4. Nothing Ear (3)1 annonce1 annonceur
  5. Sony WF-1000XM51 annonce1 annonceur
ChatGPT a recommandé ces produits le 19 novembre 2026. Le 20 novembre 2026, ADS a cherché le nom exact de chacun parmi les annonces actives aux États-Unis ; les barres comptent les annonces renvoyées par chaque recherche, et les marques parmi les annonceurs sont nommées.

0.5 crédits pour 30 publicités

Une recherche coûte 0.5 crédits par tranche de 30 publicités renvoyées, et au moins 0.5 crédits : la requête par défaut de 30 publicités coûte 0.5 crédits, et une recherche de 500 publicités jusqu'à 8.5. Une recherche d'annonceurs coûte 0.5 crédits. Seules les requêtes terminées sont facturées.

Voir les tarifs →
Coût des requêtes par forfait
Forfait1 000 requêtes
Basic≈ $1.25
Max≈ $0.50

Tarifs effectifs en supposant que tous les crédits mensuels inclus sont utilisés.

Fonctionnalités associées

Commencez avec 500 crédits offerts

Lancez votre première tâche dans le Playground, ou appelez l'API avec votre clé.