Facebook API

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.

POST/v1/run/facebook.ad_details_full
Uptime
100.00%
30d · 11 calls
Requests
11
30d · weekly, last 12 wks
Response
9.2s
median · 30d

Pricing

One price, in dollars

Providers
Octopus11 served100.00% uptime9040ms p50$4.62/1k reqflat

Try it

Make your first request

Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
  "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
}
Response interface
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-09-16 · uptime and latency measured over 30d
POST /v1/run/facebook.ad_details_full
curl -X POST https://api.getanyapi.com/v1/run/facebook.ad_details_full \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"962050096457659"}'
FieldTypeExample value
Request body
idstring"962050096457659"Meta Ad Library ad ID - the numeric id in an Ad Library URL (e.g. "962050096457659" from https://www.facebook.com/ads/library/?id=962050096457659).
Response
dataobject
data.activebooleanWhether the ad is currently running.
data.adArchiveIdstringAd Library archive ID (stable identity). Populated whenever the provider has data for the entity.
data.bodystringAd body text. Populated whenever the provider has data for the entity.
data.captionstringDisplay caption, usually the destination domain.
data.creativesobject[]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[].bodystringVariant body text.
data.creatives[].captionstringVariant display caption.
data.creatives[].ctaTextstringVariant call-to-action label.
data.creatives[].ctaTypestringVariant call-to-action type.
data.creatives[].imagestringOriginal creative image URL.
data.creatives[].imageResizedstringResized creative image URL.
data.creatives[].linkDescriptionstringVariant secondary description.
data.creatives[].linkUrlstringVariant destination URL.
data.creatives[].titlestringVariant headline.
data.creatives[].videoPreviewImagestringPoster frame for the creative video.
data.creatives[].videoUrlstringCreative video URL (HD when supplied, otherwise SD).
data.ctaTextstringCall-to-action label (e.g. "Shop now").
data.ctaTypestringCall-to-action type (e.g. "SHOP_NOW").
data.displayFormatstringAd creative format (e.g. "DPA", "VIDEO", "IMAGE"). Populated whenever the provider has data for the entity.
data.endedUtcnumberRun 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.imagesobject[]Standalone creative images for a single-image ad. Meta CDN media URLs are signed and expire.
data.images[].imagestringOriginal creative image URL.
data.images[].imageResizedstringResized creative image URL.
data.linkDescriptionstringSecondary link description line.
data.linkUrlstringCreative destination URL.
data.pageIdstringAdvertiser page ID (stable identity). Populated whenever the provider has data for the entity.
data.pageImagestringAdvertiser page profile picture URL. Meta CDN URLs are signed and expire.
data.pageNamestringAdvertiser page name. Populated whenever the provider has data for the entity.
data.pageUrlstringAdvertiser page URL.
data.platformsstring[]Publisher platforms the ad runs on.
data.sourceUrlstringInspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.
data.startedUtcnumberRun start. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.titlestringCreative headline. Dynamic-product ads return a template such as "{{product.name}}".
data.videosobject[]Standalone creative videos for a single-video ad. Meta CDN media URLs are signed and expire.
data.videos[].videoPreviewImagestringPoster frame for the creative video.
data.videos[].videoUrlstringCreative video URL (HD when supplied, otherwise SD).
foundboolean
Price
Price per requestUSD$0.00462
Price /1k reqUSD$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.2 seconds across 11 measured calls.

It costs from $4.62 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.

Pull one Meta Ad Library ad with its creative: every carousel variant, image and video URL, headline, body, and call to action. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 100.0% of Facebook ad details full calls through AnyAPI succeeded, with a median response time of 9.2 seconds across 11 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.
More to call

Other Facebook endpoints

Profilefrom $1.20 /1k reqProfile postsfrom $1.20 /1k reqPostfrom $1.20 /1k reqPost commentsfrom $1.20 /1k reqProfile reelsfrom $1.20 /1k reqAd detailsfrom $1.20 /1k reqAd transcriptfrom $1.20 /1k reqAds searchfrom $1.20 /1k reqComment repliesfrom $1.20 /1k reqCompany adsfrom $1.20 /1k reqEvent detailsfrom $1.20 /1k reqEventsfrom $1.20 /1k reqEvents searchfrom $1.20 /1k reqFollowersfrom $6.60 /1k resultsGroup postsfrom $1.20 /1k reqMarketplacefrom $1.20 /1k reqMarketplace itemfrom $1.20 /1k reqMarketplace location searchfrom $1.20 /1k reqPage contactfrom $1.20 /1k reqPhotosfrom $1.20 /1k reqPost transcriptfrom $1.20 /1k reqProfile eventsfrom $1.20 /1k reqSearch companiesfrom $1.20 /1k reqSearch pagesfrom $11.18 /1k resultsSearch postsfrom $3.15 /1k results