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.
Trailhead Outdoors
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.
trailheadoutdoors.com
Free returns within 60 days.
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.
trailheadoutdoors.com
Ships in 2 to 3 business days.
{"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}
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.
Essayer
Obtenez Facebook Annonces de l’entreprise en une requê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.
Réponse
JSON, une valeur d’exemple par champ.
- 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.
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/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.
- 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.
- 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 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.