Get one ad in full
Read everything the TikTok Ad Library publishes for a single ad: the creative and ad copy, the call to action, the landing page, the advertising objective, the advertiser’s identity and registered location, who paid for it, and the targeting and reach breakdown by region, age bracket and gender. Reach and targeting disclosures are published for European countries; ads elsewhere come back with targeting null.
/ad-detail Ads https://api.fetchlayer.dev/tiktok-ad-library/ad-detail Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
ad string required Ad id, or an ad library URL containing one.
Response Fields
ad-detail
Get one ad in full
adId string The resolved ad id.
ad object The full ad record, including its creative. Null when the ad is no longer published.
advertiserProfile object Identity of the advertiser running the ad, read from this ad.
targeting object The targeting the advertiser chose and the reach it produced. Null on ads that carry no disclosure.
targeting.totalImpressions string Total reach across all regions, as published — a band or a rounded figure, never an exact count.
targeting.reachByRegion object[] Per-region reach, each with breakdowns by age bracket and gender.
targeting.ageTargetingByRegion object[] Age brackets the advertiser targeted, per region. genderTargetingByRegion mirrors it.
targeting.targetAudienceSize string Size of the audience the targeting could reach, as published, for example "35.9M-43.9M".
targeting.countries string[] Also cities, provinces, languages, deviceModels and operatingSystems, where disclosed.
targeting.usesAudienceTargeting string Whether a custom audience list was used. audienceExcluded, highSpendingPower, interests, videoInteractions and creatorInteractions sit alongside it.
notes string[] Caveats about this result, such as a disclosure the library withheld.
Request
curl -X POST "https://api.fetchlayer.dev/tiktok-ad-library/ad-detail" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"ad":"1794523310028321"}'Response
{
"adId": "1794523310028321",
"ad": {
"creative": {
"title": "Three steps. Two minutes.",
"callToAction": "Shop now",
"landingPageUrl": "https://example.com",
"advertisingObjective": "Sales",
"mediaType": "video"
}
},
"targeting": {
"totalRegions": 3,
"totalImpressions": "100K-1M",
"targetAudienceSize": "35.9M-43.9M",
"countries": [
"DE",
"AT",
"CH"
]
}
}