API Facebook

Facebook Annonces de l’entreprise API

Listez les annonces de la Meta Ad Library qu’une entreprise diffuse par ID de page ou nom d’entreprise (texte créatif, format, plateformes et dates de diffusion) avec pagination par curseur.

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

fMeta Ad Library
facebook.com/ads/library/?view_all_page_id=1185617869915074
Meta
United StatesiAll adsTrailhead Outdoors

Trailhead Outdoors

AdsAbout

Trailhead Outdoors

Active · Sponsored

Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.

photo

trailheadoutdoors.com

Free returns within 60 days.

Shop Now
Library ID: 1185617869915074FBIG

Trailhead Outdoors

Active · Sponsored

Our down quilt drops to 15F and packs down to the size of a grapefruit. Made for thru hikers who count every ounce.

photo

trailheadoutdoors.com

Ships in 2 to 3 business days.

Shop Now
Library ID: 1092837465210983FBIGMSG
Ce que l’API a renvoyéads[0]
{
"id": "1185617869915074",
"pageId": "281940573310482",
"pageName": "Trailhead Outdoors",
"active": true,
"startDate": 1755302400,
"endDate": 1758758400,
"currency": "USD",
"text": "Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.",
... 18 champs de plus
}
Disponibilité
99,94%
30d · 542 716 appels
Requêtes
544 096
30 j · par semaine, 12 dernières sem.
Réponse
1,5s
médiane · 30d

Tarifs et fournisseurs

Tarifs de l’API Facebook Annonces de l’entreprise : une API, 2 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
11,00 $US
1,10 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 90 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez Facebook Annonces de l’entreprise en une requête

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 34 champs sur 46. Voir tous les champs

{
  "found": true,
  "data": {
    "nextCursor": "AbTr8k2m9x1v7c3q",
    "totalResults": 18,
    "ads": [
      {
        "id": "1185617869915074",
        "pageId": "281940573310482",
        "pageName": "Trailhead Outdoors",
        "active": true,
        "startDate": 1755302400,
        "endDate": 1758758400,
        "currency": "USD",
        "text": "Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.",
        "displayFormat": "DCO",
        "platforms": [
          "facebook",
          "instagram"
        ],
        "adCount": 2,
        "pageProfilePicture": "https://scontent.fbcdn.net/trailhead-profile.jpg",
        "media": [
          {
            "type": "photo",
            "url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/wren-tent-creative-1.jpg",
            "width": 1080,
            "height": 1080
          }
        ],
        "caption": "trailheadoutdoors.com",
        "linkDescription": "Free returns within 60 days.",
        "pageUrl": "https://www.facebook.com/trailheadoutdoors",
        "pageCategories": [
          "Product/service",
          "Outdoor recreation"
        ],
        "pageLikes": 22400,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ],
        "title": "The 3 season tent that packs to a water bottle",
        "ctaText": "Shop Now",
        "ctaType": "SHOP_NOW",
        "linkUrl": "https://trailheadoutdoors.com/products/wren-2-tent"
      },
      {
        "id": "1092837465210983",
        "pageId": "281940573310482",
        "pageName": "Trailhead Outdoors",
        "active": true,
        "startDate": 1753488000,
        "endDate": 1759104000,
        "currency": "USD",
        "text": "Our down quilt drops to 15F and packs down to the size of a grapefruit. Made for thru hikers who count every ounce.",
        "displayFormat": "IMAGE",
        "platforms": [
          "facebook",
          "instagram",
          "messenger"
        ],
        "adCount": 1,
        "pageProfilePicture": "https://scontent.fbcdn.net/trailhead-profile.jpg",
        "media": [
          {
            "type": "photo",
            "url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/trailhead-quilt-creative.jpg",
            "width": 1080,
            "height": 1350
          }
        ],
        "caption": "trailheadoutdoors.com",
        "linkDescription": "Ships in 2 to 3 business days.",
        "pageUrl": "https://www.facebook.com/trailheadoutdoors",
        "pageCategories": [
          "Product/service",
          "Outdoor recreation"
        ],
        "pageLikes": 22400,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ],
        "title": "15F down quilt, packs to a grapefruit",
        "ctaText": "Shop Now",
        "ctaType": "SHOP_NOW",
        "linkUrl": "https://trailheadoutdoors.com/products/down-quilt-15f"
      }
    ]
  }
}

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.

  • companyNamestring

    Trailhead Outdoors

    Nom de l’entreprise à chercher (p. ex. « nike »). Correspondance exacte et sensible à la casse sur l’index de la Meta Ad Library ; un annonceur sans page indexée renvoie found:false.

  • countrystring

    Code pays à deux lettres pour cadrer les résultats. Tous les pays par défaut.

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

  • languagestring

    Code de langue à deux lettres pour filtrer les annonces (p. ex. « EN », « ES », « FR »).

  • mediaTypeenum

    Filtre de type de média créatif.

  • pageIdstring

    ID de la page de l’entreprise dans l’Ad Library. Fournissez soit pageId, soit companyName.

  • sortByenum

    recent

    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. ACTIVE par défaut.

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

    2

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

  • captionstring

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

    Call-to-action button label on the ad.

  • ctaTypestring

    SHOP_NOW

    Call-to-action button type on the ad, e.g. "SHOP_NOW".

  • currencystring

    USD

  • displayFormatstring

    DCO

    Populated whenever the provider has data for the entity.

  • endDateinteger

    1758758400

    Epoch seconds.

  • idstring

    1185617869915074

    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

    Free returns within 60 days.

    Description text shown under the ad's link.

  • linkUrlstring

    https://trailheadoutdoors.com/products/wren-2-tent

    Destination URL the ad links to.

  • pageCategoriesstring[]

    Categories Facebook lists the advertising page under.

  • pageDeletedboolean

    false

    Whether the advertising page has been deleted.

  • pageIdstring

    281940573310482

    Populated whenever the provider has data for the entity.

  • pageLikesinteger

    22400

    Like count of the advertising page.

  • pageNamestring

    Trailhead Outdoors

    Populated whenever the provider has data for the entity.

  • pageProfilePicturestring

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

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

  • pageUrlstring

    https://www.facebook.com/trailheadoutdoors

    Canonical Facebook URL of the advertising page.

  • platformsstring[]

    Populated whenever the provider has data for the entity.

  • startDateinteger

    1755302400

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

  • textstring

    Built from 20D ripstop nylon, the Wren 2 tent weighs 2.1 lbs and sets up in under 90 seconds. Backed by our lifetime warranty.

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

  • titlestring

    The 3 season tent that packs to a water bottle

    Headline of the ad creative.

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/wren-tent-creative-1.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

    AbTr8k2m9x1v7c3q

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

  • totalResultsinteger

    18

    Total number of ads Facebook reports for the page.

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 Annonces de l’entreprise

L’API Facebook Annonces de l’entreprise d’AnyAPI renvoie des données Facebook en JSON normalisé à partir d’un appel POST à /v1/run/facebook.company_ads. Listez les annonces de la Meta Ad Library qu’une entreprise diffuse par ID de page ou nom d’entreprise (texte créatif, format, plateformes et dates de diffusion) avec pagination par curseur. AnyAPI route chaque requête sur 2 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 1,10 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 99,9% des appels Facebook Annonces de l’entreprise passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,5 secondes, sur 542 716 appels mesurés.

Elle coûte à partir de 1,10 $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é.

Listez les annonces de la Meta Ad Library qu’une entreprise diffuse par ID de page ou nom d’entreprise (texte créatif, format, 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 Annonces de l’entreprise passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,5 secondes, sur 542 716 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 90 appels Facebook Annonces de l’entreprise à 0,0011 $US chacun.

AnyAPI interroge la suivante de ses 2 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.company_ads 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.