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.
~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.",... 18 champs de plus}
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.
Essayer
Obtenez Facebook Recherche d’annonces en une requê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.
Réponse
JSON, une valeur d’exemple par champ.
- 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.
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.
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.
- 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.
- 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 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.