Facebook Ad details full API
Pull one Meta Ad Library ad with its creative: every carousel variant, image and video URL, headline, body, and call to action.
- Category SocialRequests / mo 4Routing 1 lane · no failover
Pricing
One price, in dollars
pay per request · no subscription · fallbacks added as the catalog growsTry it
Make your first request
run it free, no key · same shape for every API{
"data": {
"active": true,
"adArchiveId": "a1b2c3d4",
"body": "A short example description of this item.",
"caption": "A short example description of this item.",
"creatives": [
{
"body": "A short example description of this item.",
"caption": "A short example description of this item.",
"ctaText": "A short example description of this item.",
"ctaType": "general",
"image": "https://example.com/image.jpg",
"imageResized": "https://example.com/image.jpg",
"linkDescription": "https://example.com/page",
"linkUrl": "https://example.com/page",
"title": "Example title",
"videoPreviewImage": "https://example.com/image.jpg",
"videoUrl": "https://example.com/page"
}
],
"ctaText": "A short example description of this item.",
"ctaType": "general",
"displayFormat": "example",
"endedUtc": 12.5,
"images": [
{
"image": "https://example.com/image.jpg",
"imageResized": "https://example.com/image.jpg"
}
],
"linkDescription": "https://example.com/page",
"linkUrl": "https://example.com/page",
"pageId": "a1b2c3d4",
"pageImage": "https://example.com/image.jpg",
"pageName": "Example title",
"pageUrl": "https://example.com/page",
"platforms": [
"example"
],
"sourceUrl": "https://example.com/page",
"startedUtc": 12.5,
"title": "Example title",
"videos": [
{
"videoPreviewImage": "https://example.com/image.jpg",
"videoUrl": "https://example.com/page"
}
]
},
"found": true
}interface FacebookAdDetailsFullResponse {
data: {
active?: boolean;
adArchiveId: string;
body?: string;
caption?: string;
creatives?: {
body?: string;
caption?: string;
ctaText?: string;
ctaType?: string;
image?: string;
imageResized?: string;
linkDescription?: string;
linkUrl?: string;
title?: string;
videoPreviewImage?: string;
videoUrl?: string;
}[];
ctaText?: string;
ctaType?: string;
displayFormat?: string;
endedUtc?: number;
images?: {
image?: string;
imageResized?: string;
}[];
linkDescription?: string;
linkUrl?: string;
pageId: string;
pageImage?: string;
pageName?: string;
pageUrl?: string;
platforms?: string[];
sourceUrl: string;
startedUtc?: number;
title?: string;
videos?: {
videoPreviewImage?: string;
videoUrl?: string;
}[];
} | null;
found: boolean;
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
Request, response, and price
Last verified 2026-08-23 · uptime and latency measured over 30dcurl -X POST https://api.getanyapi.com/v1/run/facebook.ad_details_full \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"id":"1519158199783790"}'| Field | Type | Example value |
|---|---|---|
| Request body | ||
| id | string | "1519158199783790"Meta Ad Library ad ID - the numeric id in an Ad Library URL (e.g. "1519158199783790" from https://www.facebook.com/ads/library/?id=1519158199783790). |
| Response | ||
| data | object | |
| data.active | boolean | Whether the ad is currently running. |
| data.adArchiveId | string | Ad Library archive ID (stable identity). Populated whenever the provider has data for the entity. |
| data.body | string | Ad body text. Populated whenever the provider has data for the entity. |
| data.caption | string | Display caption, usually the destination domain. |
| data.creatives | object[] | One entry per creative variant of a carousel or dynamic ad, in the order Meta returns them. Single-creative ads return an empty array and carry their media in images/videos. Meta CDN media URLs are signed and expire, so fetch what you need at read time. |
| data.creatives[].body | string | Variant body text. |
| data.creatives[].caption | string | Variant display caption. |
| data.creatives[].ctaText | string | Variant call-to-action label. |
| data.creatives[].ctaType | string | Variant call-to-action type. |
| data.creatives[].image | string | Original creative image URL. |
| data.creatives[].imageResized | string | Resized creative image URL. |
| data.creatives[].linkDescription | string | Variant secondary description. |
| data.creatives[].linkUrl | string | Variant destination URL. |
| data.creatives[].title | string | Variant headline. |
| data.creatives[].videoPreviewImage | string | Poster frame for the creative video. |
| data.creatives[].videoUrl | string | Creative video URL (HD when supplied, otherwise SD). |
| data.ctaText | string | Call-to-action label (e.g. "Shop now"). |
| data.ctaType | string | Call-to-action type (e.g. "SHOP_NOW"). |
| data.displayFormat | string | Ad creative format (e.g. "DPA", "VIDEO", "IMAGE"). Populated whenever the provider has data for the entity. |
| data.endedUtc | number | Run end, or last-seen date while the ad is still running. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.images | object[] | Standalone creative images for a single-image ad. Meta CDN media URLs are signed and expire. |
| data.images[].image | string | Original creative image URL. |
| data.images[].imageResized | string | Resized creative image URL. |
| data.linkDescription | string | Secondary link description line. |
| data.linkUrl | string | Creative destination URL. |
| data.pageId | string | Advertiser page ID (stable identity). Populated whenever the provider has data for the entity. |
| data.pageImage | string | Advertiser page profile picture URL. Meta CDN URLs are signed and expire. |
| data.pageName | string | Advertiser page name. Populated whenever the provider has data for the entity. |
| data.pageUrl | string | Advertiser page URL. |
| data.platforms | string[] | Publisher platforms the ad runs on. |
| data.sourceUrl | string | Inspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity. |
| data.startedUtc | number | Run start. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.title | string | Creative headline. Dynamic-product ads return a template such as "{{product.name}}". |
| data.videos | object[] | Standalone creative videos for a single-video ad. Meta CDN media URLs are signed and expire. |
| data.videos[].videoPreviewImage | string | Poster frame for the creative video. |
| data.videos[].videoUrl | string | Creative video URL (HD when supplied, otherwise SD). |
| found | boolean | |
| Price | ||
| Price per request | USD | $0.00462 |
| Price /1k req | USD | $4.62 |
FAQ
About the Facebook Ad details full API
The AnyAPI Facebook Ad details full API returns Facebook ad details full data as normalized JSON from one POST call to /v1/run/facebook.ad_details_full. Pull one Meta Ad Library ad with its creative: every carousel variant, image and video URL, headline, body, and call to action. AnyAPI returns one normalized schema whichever source serves it. It costs from $4.62 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Facebook ad details full calls through AnyAPI succeeded, with a median response time of 9.4 seconds across 4 measured calls.
More to call
Other Facebook endpoints
Get started
Two ways to start on AnyAPI
Humans fund a USD wallet and pay per request. Agents point a coding agent at one URL and onboard themselves.