API di Facebook

Facebook Ricerca annunci API

Cerca nella Meta Ad Library per parola chiave e ottieni gli annunci corrispondenti (inserzionista, testo creativo, CTA, piattaforme e date di esecuzione) con paginazione a cursore.

1,05 USD/1k richieste, paghi a richiesta, nessun abbonamento.

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
Cosa ha restituito l'APIads[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 campi in più
}
Disponibilità
99,92%
30d · 335.380 chiamate
Richieste
335.455
30 g · settimanale, ultime 12 sett.
Risposta
1,7s
mediana · 30d

Prezzi e provider

Prezzi dell'API Facebook Ricerca annunci: una sola API, 5 provider intercambiabili

Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.

Paghi
10,50 USD
1,05 USD/1k richieste, solo per ciò che usi. Nessun piano mensile.
Le tue prime 95 richieste sono gratuite con il saldo iniziale di 0,10 USD.

Provalo

Ottieni Facebook Ricerca annunci in una sola richiesta

requireFieldsarray
Facoltativo; se lo ometti l'instradamento resta invariato, e serve la fonte più economica. Indica i campi di output che questa richiesta deve poter restituire, per esempio `totalResults`, e verrà servita solo da una fonte che li restituisce tutti. I campi che non indichi vengono comunque restituiti ogni volta che la fonte che serve li ha. Può far salire il prezzo: quando la fonte più economica non può restituire un campo indicato, serve una fonte più cara, e ti viene quotato e addebitato il suo prezzo. Un campo indicato può comunque mancare su un annuncio che davvero non lo ha. Indicare una combinazione che nessuna singola fonte restituisce insieme viene rifiutato come input non valido, senza addebito.
Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.

Questo esempio mostra 35 campi su 46. Vedi tutti i campi

{
  "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"
        ]
      }
    ]
  }
}

Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.

Riferimento

Una richiesta, una sola forma di risposta.

Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.

Ultima verifica 2026-11-21 · disponibilità e latenza misurate su 30d

Corpo della richiesta

JSON, inviato a questo endpoint.

  • querystring

    protein powder

    Parola chiave con cui cercare nella Meta Ad Library (es. "protein powder").

  • adTypeenum

    Limita a tutti gli annunci (predefinito) oppure solo agli annunci politici e su temi sociali.

  • countrystring

    US

    Codice paese di due lettere per delimitare i risultati. Omettilo per tutti i paesi.

  • cursorstring

    Cursore di paginazione opaco dal nextCursor di una risposta precedente.

  • endDatestring

    Filtra gli annunci con impression fino a questa data inclusa, in formato YYYY-MM-DD.

  • mediaTypeenum

    Filtro per tipo di media creativo.

  • requireFieldsarray

    Facoltativo; se lo ometti l'instradamento resta invariato, e serve la fonte più economica. Indica i campi di output che questa richiesta deve poter restituire, per esempio `totalResults`, e verrà servita solo da una fonte che li restituisce tutti. I campi che non indichi vengono comunque restituiti ogni volta che la fonte che serve li ha. Può far salire il prezzo: quando la fonte più economica non può restituire un campo indicato, serve una fonte più cara, e ti viene quotato e addebitato il suo prezzo. Un campo indicato può comunque mancare su un annuncio che davvero non lo ha. Indicare una combinazione che nessuna singola fonte restituisce insieme viene rifiutato come input non valido, senza addebito.

  • searchTypeenum

    keyword_exact_phrase

    Modalità di corrispondenza della query: corrispondenza libera per parole chiave (keyword_unordered, il valore predefinito) o frase esatta (keyword_exact_phrase).

  • sortByenum

    Ordinamento: impressions (prima le più alte, il valore predefinito) o recent (più recenti).

  • startDatestring

    Filtra gli annunci con impression a partire da questa data inclusa, in formato YYYY-MM-DD.

  • statusenum

    Filtro per stato dell'annuncio.

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per campo.

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.

  • totalResultsintegerpuò richiedere

    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.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

Vendi questa API? Consulta lo schema completo che il tuo endpoint deve restituire.

FAQ

Sull'API Facebook Ricerca annunci

L'API Facebook Ricerca annunci di AnyAPI restituisce dati Facebook come JSON normalizzato da una sola chiamata POST a /v1/run/facebook.ads_search. Cerca nella Meta Ad Library per parola chiave e ottieni gli annunci corrispondenti (inserzionista, testo creativo, CTA, piattaforme e date di esecuzione) con paginazione a cursore. AnyAPI instrada ogni richiesta su 5 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 1,05 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 99,9% delle chiamate Facebook Ricerca annunci tramite AnyAPI è riuscito, con un tempo di risposta mediano di 1,7 secondi su 335.380 chiamate misurate.

Costa da 1,05 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

Cerca nella Meta Ad Library per parola chiave e ottieni gli annunci corrispondenti (inserzionista, testo creativo, CTA, piattaforme e date di esecuzione) con paginazione a cursore. La risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

Negli ultimi 30 giorni, il 99,9% delle chiamate Facebook Ricerca annunci tramite AnyAPI è riuscito, con un tempo di risposta mediano di 1,7 secondi su 335.380 chiamate misurate. Sono misurazioni di AnyAPI sul traffico che passa dal gateway, ricalcolate di continuo, non un obiettivo di livello di servizio pubblicato.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta, che copre 95 chiamate Facebook Ricerca annunci a 0,00105 USD ciascuna.

AnyAPI interroga la successiva delle sue 5 fonti nella stessa richiesta, partendo dalla più economica, quindi una fonte che cade non fa fallire la tua chiamata.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/facebook.ads_search con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.