Get one ad in full
Read a single ad completely: full copy, call to action, destination link, display format, every other creative version running under the same ad group, the advertiser profile, and EU transparency data — total reach plus age, gender and location audience breakdowns.
/ad-detail Ads https://api.fetchlayer.dev/facebook-ad-library/ad-detail Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
ad string required Ad archive id, or an Ad Library URL containing one.
country string optional Two-letter country code, or ALL.
includeVariations boolean optional Also fetch every other creative version in the same ad group. (default: true)
Response Fields
ad-detail
Get one ad in full
adArchiveId string The resolved ad archive id.
ad object The full ad record, including its creative.
advertiserProfile object Profile of the page running the ad.
euTransparency object Total reach and age, gender and location audience breakdowns, where Meta publishes them.
variations object[] Every other creative version running under the same ad group.
variationCount number How many creative versions the ad group carries.
violationTypes string[] Policy violations Meta has recorded against the ad.
Request
curl -X POST "https://api.fetchlayer.dev/facebook-ad-library/ad-detail" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"ad":"1234567890123456","includeVariations":true}'Response
{
"adArchiveId": "1234567890123456",
"variationCount": 4,
"ad": {
"creative": {
"title": "Ship faster with Acme",
"body": "Try Acme free for 14 days.",
"ctaText": "Sign Up"
}
}
}