Facebook Ad details API

Look up a single Meta Ad Library ad by ID or URL and get the advertiser, creative text, call-to-action, platforms, and run dates as clean JSON.

POST/v1/run/facebook.ad_details

Uptime

100.00%

30d · 2 calls

Requests

2

30d · weekly, last 12 wks

Response

1.8s

median · 30d

Pricing

One price, in dollars

Providers

Giraffe2 served100.00% uptime1485ms p50100.00% (2 calls)1485ms (2 calls)2$1.20/1k reqflat

Try it

Make your first request

idstringMeta Ad Library ad ID (e.g. "702369045530963"). Provide either id or url.urlstringMeta Ad Library ad URL (e.g. "https://www.facebook.com/ads/library?id=1185617869915074"). Provide either id or url.

Open inPrompt copied

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",
    "ctaText": "A short example description of this item.",
    "currency": "USD",
    "displayFormat": "example",
    "endDate": 42,
    "linkUrl": "https://example.com/page",
    "media": [
      {
        "height": 42,
        "type": "general",
        "url": "https://example.com/page",
        "videoUrl": "https://example.com/page",
        "width": 1024
      }
    ],
    "pageId": "a1b2c3d4",
    "pageName": "Example title",
    "pageProfilePicture": "https://example.com/image.jpg",
    "platforms": [
      "example"
    ],
    "sourceUrl": "https://example.com/page",
    "startDate": 42,
    "text": "A short example description of this item.",
    "title": "Example title"
  },
  "found": true
}

Response interface

interface FacebookAdDetailsResponse {
  data: {
    active?: boolean | null;
    adArchiveId: string;
    ctaText?: string | null;
    currency?: string | null;
    displayFormat?: string | null;
    endDate?: number | null;
    linkUrl?: string | null;
    media?: {
      height?: number;
      type: string;
      url: string;
      videoUrl?: string;
      width?: number;
    }[];
    pageId: string;
    pageName?: string | null;
    pageProfilePicture?: string;
    platforms?: string[] | null;
    sourceUrl: string;
    startDate?: number | null;
    text?: string | null;
    title?: string | null;
  } | 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

curl -X POST https://api.getanyapi.com/v1/run/facebook.ad_details \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"962050096457659"}'

Field	Type	Example value
Request body
id	string	"962050096457659"Meta Ad Library ad ID (e.g. "702369045530963"). Provide either id or url.
url	string	Meta Ad Library ad URL (e.g. "https://www.facebook.com/ads/library?id=1185617869915074"). Provide either id or url.
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.ctaText	string	Call-to-action label. Populated whenever the provider has data for the entity.
data.currency	string	Spend currency, may be empty.
data.displayFormat	string	Ad creative format. Populated whenever the provider has data for the entity.
data.endDate	integer	Run end, epoch seconds.
data.linkUrl	string	Creative destination URL. Populated whenever the provider has data for the entity.
data.media	object[]	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.
data.media[].height	integer	Pixel height of the media item, when the lane reports it.
data.media[].type	string	One of photo, video, or gif.
data.media[].url	string	Image URL. For a video or GIF this is the poster/thumbnail frame.
data.media[].videoUrl	string	Playable video file URL. Present only for video and gif items.
data.media[].width	integer	Pixel width of the media item, when the lane reports it.
data.pageId	string	Advertiser page ID (stable identity). Populated whenever the provider has data for the entity.
data.pageName	string	Advertiser page name. Populated whenever the provider has data for the entity.
data.pageProfilePicture	string	Profile picture of the advertising page. This is the advertiser's identity image, not ad creative.
data.platforms	string[]	Publisher platforms the ad runs on. Populated whenever the provider has data for the entity.
data.sourceUrl	string	Inspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.
data.startDate	integer	Run start, epoch seconds. Populated whenever the provider has data for the entity.
data.text	string	Ad body text. Populated whenever the provider has data for the entity.
data.title	string	Creative title. Populated whenever the provider has data for the entity.
found	boolean
Price
Price per request	USD	$0.0012
Price /1k req	USD	$1.20

FAQ

About the Facebook Ad details API

The AnyAPI Facebook Ad details API returns Facebook ad details data as normalized JSON from one POST call to /v1/run/facebook.ad_details. Look up a single Meta Ad Library ad by ID or URL and get the advertiser, creative text, call-to-action, platforms, and run dates as clean JSON. AnyAPI returns one normalized schema whichever source serves it. It costs from $1.20 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 calls through AnyAPI succeeded, with a median response time of 1.8 seconds across 2 measured calls.

It costs from $1.20 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.

Look up a single Meta Ad Library ad by ID or URL and get the advertiser, creative text, call-to-action, platforms, and run dates as clean JSON. 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 calls through AnyAPI succeeded, with a median response time of 1.8 seconds across 2 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.

Facebook Ad details API

One price, in dollars

Make your first request

Request, response, and price

About the Facebook Ad details API

Other Facebook endpoints

One key, one wallet, and
your first Facebook call.

Facebook Ad details API

One price, in dollars

Make your first request

Request, response, and price

About the Facebook Ad details API

How much does the Facebook Ad details API cost?

What does the Facebook Ad details API return?

How reliable is the Facebook Ad details API?

Other Facebook endpoints

One key, one wallet, andyour first Facebook call.

One key, one wallet, and
your first Facebook call.