Meta Ad Library

Meta Ad Library Ad Detail API

Look up one Facebook or Instagram ad in full by its archive id: the advertiser Page, ad copy and headline, CTA and landing page, the image or video creative with direct HD and SD URLs, the platforms it ran on, its run dates, and the political disclosure when it carries one. The fastest re-read of a single ad you already have an id for. Costs 1 credit per request.

POST/api/v1/meta-ads/ad

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

ad_archive_idstringrequired

Meta's ad archive id - 3 to 25 DIGITS, sent as a string. It is the number in a facebook.com/ads/library/?id= URL, and it is the "ad_archive_id" field on every row /api/v1/meta-ads/search and /api/v1/meta-ads/advertiser return. Anything non-numeric is a 400; a numeric id Meta has no ad for is a 404.

Example: 1046730950862281

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

ad = client.meta_ads.ad("1046730950862281")["data"]

print(ad["page_name"], ad["cta_text"], ad["link_url"])

# Creative comes back as direct, downloadable fbcdn URLs.
for video in ad["videos"]:
    print(video["hd_url"], video["preview_image"])
for image in ad["images"]:
    print(image)

Response

"ad_archive_id": "1046730950862281",

"ad_id": null,

"collation_id": null,

"collation_count": null,

"is_active": false,

"page_id": "146705838515566",

"page_name": "Sukeban World",

"page_profile_url": "https://business.facebook.com/61551864263186",

"page_profile_picture": "https://scontent.fmex16-1.fna.fbcdn.net/v/t39.35426-6/517640014_2104272360362331_…",

"page_like_count": 427,

"page_is_deleted": false,

"start_date": "2025-07-09T07:00:00.000Z",

"end_date": "2025-11-21T08:00:00.000Z",

"total_active_time": null,

"currency": null,

"spend": null,

"reach_estimate": null,

"body": "SUKEBAN at @animeexpo 07/05/25 Los Angeles MC @kunichi_nomura Sneakers @nike #thisissukeban #sukebanxanimeexpo",

"title": null,

"caption": "instagram.com",

"link_url": "http://instagram.com/sukeban_world",

"link_description": null,

"cta_text": "Visit Instagram profile",

"cta_type": "VIEW_INSTAGRAM_PROFILE",

"display_format": "VIDEO",

"images": [],

"card_count": 0,

"byline": null,

"disclaimer_label": null,

"gated_type": "ELIGIBLE",

"targeted_or_reached_countries": [],

"contains_sensitive_content": false,

"disclosure": null

"response_time": 1733,

"credits_used": 1,

"credits_remaining": 4820

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") ad = client.meta_ads.ad("1046730950862281")["data"] print(ad["page_name"], ad["cta_text"], ad["link_url"]) # Creative comes back as direct, downloadable fbcdn URLs. for video in ad["videos"]: print(video["hd_url"], video["preview_image"]) for image in ad["images"]: print(image)