Object

Ad object

One ad from a public ad library: advertiser, copy, creative, landing page and when it ran. The same fields on every platform. A field a platform does not show is null, and meta.unavailable names it with the reason.

Field	Type	Description
`id`	string	Ad ID in the library.
`url`	string	Link to the ad in the library.
`advertiser`	AdvertiserRef	Who runs the ad.
`title`	string \| null	Headline, where the ad has one.
`text`	string	Ad copy as plain text; empty when the ad has none.
`format`	string \| null	Creative format; dynamic means the platform assembles it per viewer (catalog ads).
`images`	string[] \| null	Image URLs of the creative.
`videos`	string[] \| null	Video URLs of the creative.
`landing_url`	string \| null	Where the ad leads.
`cta`	string \| null	Call-to-action button text.
`platforms`	string[] \| null	Where it is delivered, e.g. facebook, instagram.
`active`	boolean \| null	Whether the ad is still running.
`first_shown_at`	string \| null	First time or day shown, ISO 8601 in UTC.
`last_shown_at`	string \| null	Last time or day shown, ISO 8601 in UTC.
`reach`	string \| null	People reached, as the library publishes it: a bracket such as 1K-10K, or a count (the EU reach of a Meta ad); null where none is published.
`ext`	object	Platform-specific extras. Only returned with view=full. · only with view=full

AdvertiserRef

Field	Type	Description
`id`	string \| null	The advertiser's ID in the library.
`name`	string \| null	The advertiser's name.
`url`	string \| null	The advertiser's page.

Example · meta

{
  "id": "1856995242318099",
  "url": "https://www.facebook.com/ads/library/?id=1856995242318099",
  "advertiser": {
    "id": "30147264485",
    "name": "Stanley 1913",
    "url": "https://www.facebook.com/Stanley1913/"
  },
  "title": "The Holiday Collection",
  "text": "Great gifts. Under $50. No compromise.",
  "format": "carousel",
  "images": [
    "https://cdn.example.com/ad/1.jpg"
  ],
  "videos": null,
  "landing_url": "https://www.stanley1913.com/collections/gifts-under-50",
  "cta": "Shop now",
  "platforms": [
    "facebook",
    "instagram"
  ],
  "active": true,
  "first_shown_at": "2026-11-10T08:00:00Z",
  "last_shown_at": "2026-11-11T08:00:00Z",
  "reach": null
}

AdvertiserRef

Endpoints that return a Ad