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,10 $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.",+17 champs de plus}
Tarifs et fournisseurs
Tarifs de l’API Facebook Recherche d’annonces : une API, 4 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
{
"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-10-07 · 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.
- foundboolean
true
- totalResultsnumberpeut exiger
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
À 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 4 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, 100,0% des appels Facebook Recherche d’annonces passés par AnyAPI ont réussi, avec un temps de réponse médian de 2,7 secondes, sur 8 938 appels mesurés.