API Facebook

Facebook Recherche d’annonces API

Cherchez dans la Meta Ad Library par mot-clé et obtenez les annonces correspondantes (annonceur, texte de création, CTA, plateformes et dates de diffusion) avec pagination par curseur.

1,05 $US/1k req, paiement à la requête, sans abonnement.

fMeta Ad Library
facebook.com/ads/library/?q=protein%20powder
Meta
United StatesiAll adsprotein powder

~214 results

Vantage Nutrition

Active · Sponsored

20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.

photo

vantagenutrition.com

Subscribe and save 20%. Cancel anytime.

Shop Now
Library ID: 705513298640217FBIG

PureForm Labs

Active · Sponsored

Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.

video

pureformlabs.com

Free shipping on orders over $40.

Learn More
Library ID: 592047718834105FBIGMSG
Ce que l’API a renvoyéads[0]
{
"id": "705513298640217",
"sourceUrl": "https://www.facebook.com/ads/library/?id=705513298640217",
"pageId": "398201744920331",
"pageName": "Vantage Nutrition",
"active": true,
"startDate": 1756512000,
"endDate": 1758758400,
"text": "20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.",
... 18 champs de plus
}
Disponibilité
99,92%
30d · 335 380 appels
Requêtes
335 455
30 j · par semaine, 12 dernières sem.
Réponse
1,7s
médiane · 30d

Tarifs et fournisseurs

Tarifs de l’API Facebook Recherche d’annonces : une API, 5 fournisseurs interchangeables

Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.

Vous payez
10,50 $US
1,05 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 95 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez Facebook Recherche d’annonces en une requête

requireFieldsarray
Facultatif ; omettez-le et le routage est inchangé, la source la moins chère répondant. Nommez les champs de sortie que cette requête doit pouvoir renvoyer, par exemple `totalResults`, et elle n’est servie que par une source qui les renvoie tous. Les champs que vous ne nommez pas sont quand même renvoyés chaque fois que la source qui répond les possède. Cela peut augmenter votre prix : quand la source la moins chère ne peut pas renvoyer un champ nommé, une source plus chère répond, et vous êtes facturé à son prix. Un champ nommé peut quand même être absent sur une annonce qui en est réellement dépourvue. Nommer une combinaison qu’aucune source unique ne renvoie ensemble est refusé comme entrée invalide, sans frais.
Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complète.

Cet exemple affiche 35 champs sur 46. Voir tous les champs

{
  "found": true,
  "data": {
    "totalResults": 214,
    "nextCursor": "AQHRZ9d3f2k7m1x8c",
    "ads": [
      {
        "id": "705513298640217",
        "sourceUrl": "https://www.facebook.com/ads/library/?id=705513298640217",
        "pageId": "398201744920331",
        "pageName": "Vantage Nutrition",
        "active": true,
        "startDate": 1756512000,
        "endDate": 1758758400,
        "text": "20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.",
        "title": "Protein that doesn't taste like chalk",
        "ctaText": "Shop Now",
        "ctaType": "SHOP_NOW",
        "linkUrl": "https://vantagenutrition.com/protein",
        "displayFormat": "IMAGE",
        "platforms": [
          "facebook",
          "instagram"
        ],
        "adCount": 3,
        "pageProfilePicture": "https://scontent.fbcdn.net/vantage-profile.jpg",
        "media": [
          {
            "type": "photo",
            "url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg",
            "width": 1080,
            "height": 1080
          }
        ],
        "caption": "vantagenutrition.com",
        "linkDescription": "Subscribe and save 20%. Cancel anytime.",
        "pageUrl": "https://www.facebook.com/vantagenutrition",
        "pageCategories": [
          "Product/service",
          "Health/beauty"
        ],
        "pageLikes": 61300,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ]
      },
      {
        "id": "592047718834105",
        "sourceUrl": "https://www.facebook.com/ads/library/?id=592047718834105",
        "pageId": "711029384710556",
        "pageName": "PureForm Labs",
        "active": true,
        "startDate": 1757203200,
        "endDate": 1759363200,
        "text": "Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.",
        "title": "25g of plant protein, zero bloat",
        "ctaText": "Learn More",
        "ctaType": "LEARN_MORE",
        "linkUrl": "https://pureformlabs.com/plant-protein",
        "displayFormat": "VIDEO",
        "platforms": [
          "facebook",
          "instagram",
          "messenger"
        ],
        "adCount": 1,
        "pageProfilePicture": "https://scontent.fbcdn.net/pureform-profile.jpg",
        "media": [
          {
            "type": "video",
            "url": "https://scontent.xx.fbcdn.net/v/t42.1790-2/pureform-protein-poster.jpg",
            "videoUrl": "https://video.xx.fbcdn.net/v/t42.9040-2/pureform-protein-ad.mp4",
            "width": 1080,
            "height": 1350
          }
        ],
        "caption": "pureformlabs.com",
        "linkDescription": "Free shipping on orders over $40.",
        "pageUrl": "https://www.facebook.com/pureformlabs",
        "pageCategories": [
          "Product/service",
          "Health/beauty"
        ],
        "pageLikes": 18900,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ]
      }
    ]
  }
}

Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.

Référence

Une requête, une seule forme de réponse.

Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.

Dernière vérification : 2026-11-21 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet endpoint.

  • querystring

    protein powder

    Mot-clé pour chercher dans la Meta Ad Library (p. ex. « protein powder »).

  • adTypeenum

    Restreint à toutes les annonces (par défaut) ou uniquement aux annonces politiques et de société.

  • countrystring

    US

    Code pays à deux lettres pour cadrer les résultats. Omettez pour tous les pays.

  • cursorstring

    Curseur de pagination opaque issu du nextCursor d’une réponse précédente.

  • endDatestring

    Filtre sur les annonces ayant des impressions jusqu’à cette date incluse, au format AAAA-MM-JJ.

  • mediaTypeenum

    Filtre de type de média créatif.

  • requireFieldsarray

    Facultatif ; omettez-le et le routage est inchangé, la source la moins chère répondant. Nommez les champs de sortie que cette requête doit pouvoir renvoyer, par exemple `totalResults`, et elle n’est servie que par une source qui les renvoie tous. Les champs que vous ne nommez pas sont quand même renvoyés chaque fois que la source qui répond les possède. Cela peut augmenter votre prix : quand la source la moins chère ne peut pas renvoyer un champ nommé, une source plus chère répond, et vous êtes facturé à son prix. Un champ nommé peut quand même être absent sur une annonce qui en est réellement dépourvue. Nommer une combinaison qu’aucune source unique ne renvoie ensemble est refusé comme entrée invalide, sans frais.

  • searchTypeenum

    keyword_exact_phrase

    Mode de correspondance de la requête : correspondance lâche des mots-clés (keyword_unordered, par défaut) ou expression exacte (keyword_exact_phrase).

  • sortByenum

    Ordre de tri : impressions (les plus élevées d’abord, par défaut) ou recent (les plus récentes).

  • startDatestring

    Filtre sur les annonces ayant des impressions à partir de cette date, au format AAAA-MM-JJ.

  • statusenum

    Filtre de statut d’annonce.

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

each addata.ads[]
  • activeboolean

    true

  • adCountinteger

    3

    Number of ads in this campaign (collation count). Null when the source does not report it.

  • captionstring

    vantagenutrition.com

    Caption line of the ad creative, usually the advertiser's display domain.

  • categoriesstring[]

    Ad Library categories the ad is filed under.

  • ctaTextstring

    Shop Now

    Populated whenever the provider has data for the entity.

  • ctaTypestring

    SHOP_NOW

    Populated whenever the provider has data for the entity.

  • displayFormatstring

    IMAGE

    Populated whenever the provider has data for the entity.

  • endDateinteger

    1758758400

    Epoch seconds.

  • idstring

    705513298640217

    Ad Library archive ID. Populated whenever the provider has data for the entity.

  • isResharedboolean

    false

    Whether the ad creative is a reshare of another post.

  • linkDescriptionstring

    Subscribe and save 20%. Cancel anytime.

    Description text shown under the ad's link.

  • linkUrlstring

    https://vantagenutrition.com/protein

    Populated whenever the provider has data for the entity.

  • pageCategoriesstring[]

    Categories Facebook lists the advertising page under.

  • pageDeletedboolean

    false

    Whether the advertising page has been deleted.

  • pageIdstring

    398201744920331

    Populated whenever the provider has data for the entity.

  • pageLikesinteger

    61300

    Like count of the advertising page.

  • pageNamestring

    Vantage Nutrition

    Populated whenever the provider has data for the entity.

  • pageProfilePicturestring

    https://scontent.fbcdn.net/vantage-profile.jpg

    Profile picture of the advertising page. This is the advertiser's identity image, not ad creative.

  • pageUrlstring

    https://www.facebook.com/vantagenutrition

    Canonical Facebook URL of the advertising page.

  • platformsstring[]

    Populated whenever the provider has data for the entity.

  • sourceUrlstring

    https://www.facebook.com/ads/library/?id=705513298640217

    Inspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.

  • startDateinteger

    1756512000

    Epoch seconds. Populated whenever the provider has data for the entity.

  • textstring

    20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.

    Ad body text. Populated whenever the provider has data for the entity.

  • titlestring

    Protein that doesn't taste like chalk

    Populated whenever the provider has data for the entity.

each creativedata.ads[].creatives[]

One entry per card of a carousel, dynamic-product, or dynamic-creative ad, in the order Meta returns them, each with its own text and destination. Single-creative ads return an empty array. The same card images and videos also appear in media. Meta CDN media URLs are signed and expire.

  • bodystring

    Card body text.

  • captionstring

    Card display caption, usually the destination domain.

  • ctaTextstring

    Card call-to-action label (e.g. "Shop Now").

  • ctaTypestring

    Card call-to-action type (e.g. "SHOP_NOW").

  • imagestring

    Card image URL. For a video card this is the poster frame.

  • linkDescriptionstring

    Card secondary description line.

  • linkUrlstring

    Card destination URL.

  • titlestring

    Card headline.

  • videoUrlstring

    Card video file URL (HD when supplied, otherwise SD). Present only on video cards.

each mediadata.ads[].media[]

Creative attached to the ad: one element per image, video, or carousel card, in the order the ad presents them. Empty when the ad has none.

  • heightinteger

    1080

    Pixel height of the media item, when the lane reports it.

  • typestring

    photo

    One of photo, video, or gif.

  • urlstring

    https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg

    Image URL. For a video or GIF this is the poster/thumbnail frame.

  • videoUrlstring

    Playable video file URL. Present only for video and gif items.

  • widthinteger

    1080

    Pixel width of the media item, when the lane reports it.

datadata
  • nextCursorstring

    AQHRZ9d3f2k7m1x8c

    Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.

  • totalResultsintegerpeut exiger

    214

    Total number of ads matching the search. Null when the source cannot report an exact count.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

Vous vendez cette API ? Consultez le schéma complet que votre endpoint doit renvoyer.

FAQ

À propos de l’API Facebook Recherche d’annonces

L’API Facebook Recherche d’annonces d’AnyAPI renvoie des données Facebook en JSON normalisé à partir d’un appel POST à /v1/run/facebook.ads_search. Cherchez dans la Meta Ad Library par mot-clé et obtenez les annonces correspondantes (annonceur, texte de création, CTA, plateformes et dates de diffusion) avec pagination par curseur. AnyAPI route chaque requête sur 5 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 1,05 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 99,9% des appels Facebook Recherche d’annonces passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,7 secondes, sur 335 380 appels mesurés.

Elle coûte à partir de 1,05 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

Cherchez dans la Meta Ad Library par mot-clé et obtenez les annonces correspondantes (annonceur, texte de création, CTA, plateformes et dates de diffusion) avec pagination par curseur. La réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

Ces 30 derniers jours, 99,9% des appels Facebook Recherche d’annonces passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,7 secondes, sur 335 380 appels mesurés. Ce sont les propres mesures d’AnyAPI du trafic passant par la passerelle, recalculées en continu, et non un objectif de niveau de service publié.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte, ce qui couvre 95 appels Facebook Recherche d’annonces à 0,00105 $US chacun.

AnyAPI interroge la suivante de ses 5 sources dans la même requête, la moins chère d’abord, donc la panne d’une source ne fait pas échouer votre appel.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/facebook.ads_search avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.