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,10 USD/1k richieste, paghi a richiesta, nessun abbonamento.
~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.
vantagenutrition.com
Subscribe and save 20%. Cancel anytime.
PureForm Labs
Active · Sponsored
Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.
pureformlabs.com
Free shipping on orders over $40.
{"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.",+17 campi in più}
Prezzi e provider
Prezzi dell'API Facebook Ricerca annunci: una sola API, 4 provider intercambiabili
Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.
Provalo
Ottieni Facebook Ricerca annunci in una sola richiesta
{
"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-10-07 · 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.
Risposta
JSON, un valore di esempio per campo.
- foundboolean
true
- totalResultsnumberpuò richiedere
214
- nextCursorstring
AQHRZ9d3f2k7m1x8c
- idstring
705513298640217
- sourceUrlstring
https://www.facebook.com/ads/library/?id=705513298640217
- pageIdstring
398201744920331
- pageNamestring
Vantage Nutrition
- activeboolean
true
- startDatenumber
1756512000
- endDatenumber
1758758400
- textstring
20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.
- titlestring
Protein that doesn't taste like chalk
- ctaTextstring
Shop Now
- ctaTypestring
SHOP_NOW
- linkUrlstring
https://vantagenutrition.com/protein
- displayFormatstring
IMAGE
- platforms[]string
facebook
- adCountnumber
3
- pageProfilePicturestring
https://scontent.fbcdn.net/vantage-profile.jpg
- captionstring
vantagenutrition.com
- linkDescriptionstring
Subscribe and save 20%. Cancel anytime.
- pageUrlstring
https://www.facebook.com/vantagenutrition
- pageCategories[]string
Product/service
- pageLikesnumber
61300
- isResharedboolean
false
- pageDeletedboolean
false
- categories[]string
Uncategorized
- typestring
photo
- urlstring
https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg
- widthnumber
1080
- heightnumber
1080
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 4 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 1,10 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 100,0% delle chiamate Facebook Ricerca annunci tramite AnyAPI è riuscito, con un tempo di risposta mediano di 2,7 secondi su 8938 chiamate misurate.