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.

POST /ad-detail Ads

https://api.fetchlayer.dev/linkedin-ad-library/ad-detail

OpenAPI JSON

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.images object[]

The pictures of an image or carousel ad, in order, each with its url and altText — the headline for those formats, which leave creative.headline null.

ad.creative.attachments object[]

Article previews, document covers, event headers and job postings attached to the creative. Image and carousel ads use images[] instead.

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":"1624146516"}'

Response

{
  "adId": "1624146516",
  "notes": [],
  "ad": {
    "format": "SPONSORED_STATUS_UPDATE",
    "creative": {
      "headline": null,
      "body": "200+ sessions, AI skills, certifications, and industry connections. Download the letter to make your case for MAX. Nov 10–12, Miami Beach.",
      "bodyTruncated": false,
      "ctaTexts": [
        "Learn more"
      ]
    },
    "impressions": {
      "totalLabel": "10k-50k",
      "byCountry": [
        {
          "country": "US",
          "sharePercent": 62,
          "shareLabel": "62%"
        }
      ],
      "byCountryPending": false
    },
    "targeting": {
      "segments": [
        {
          "facet": "JOB",
          "label": "Job titles",
          "values": [
            "Marketing Manager"
          ]
        }
      ],
      "facets": [
        {
          "facet": "COMPANY",
          "label": "Company size",
          "targeted": true,
          "excluded": false
        }
      ]
    }
  }
}

{
  "error": "Invalid API key"
}