Get one ad in full
Read a single LinkedIn ad completely: full copy (search results carry a shortened body, this does not), headline, CTA labels, destination link, format, advertiser, payer and media. For an ad whose targeting includes the EU it also returns run dates, the impressions band, impressions by country, and the targeting the advertiser chose; those fields are null for every other ad. LinkedIn publishes no ad spend.
/ad-detail Ads https://api.fetchlayer.dev/linkedin-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, or null when the ad is no longer published.
ad.creative.body string The ad’s complete copy — not the shortened body a search result carries.
ad.creative.attachments object[] Carousel cards, article previews, document covers, event headers and job postings attached to the creative.
ad.advertiser.profileUrl string The advertiser’s LinkedIn page. Available from this endpoint.
ad.impressions.totalLabel string The band LinkedIn publishes, e.g. "1k-5k". Null for any ad whose targeting does not include the EU.
ad.impressions.byCountry object[] Share of impressions per country. byCountryPending is true for roughly the first 48 hours of an ad’s life.
ad.targeting.segments object[] Each targeting category the advertiser used, with the values they named.
ad.targeting.facets object[] Whether each targeting category was applied as an inclusion or an exclusion.
notes string[] Caveats about this particular result.
Request
curl -X POST "https://api.fetchlayer.dev/linkedin-ad-library/ad-detail" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"ad":"512345678"}'Response
{
"adId": "512345678",
"notes": [],
"ad": {
"format": "SPONSORED_STATUS_UPDATE",
"creative": {
"headline": "Cut your reporting time in half",
"body": "See how revenue teams at 400+ companies close the quarter in two days.",
"bodyTruncated": false,
"ctaTexts": [
"Learn more"
]
},
"impressions": {
"totalLabel": "10k-50k",
"byCountry": [
{
"country": "DE",
"sharePercent": 62,
"shareLabel": "62%"
}
],
"byCountryPending": false
},
"targeting": {
"segments": [
{
"facet": "JOB",
"label": "Job titles",
"values": [
"Revenue Operations Manager"
]
}
],
"facets": [
{
"facet": "COMPANY",
"label": "Company size",
"targeted": true,
"excluded": false
}
]
}
}
}