Social Fetch
LinkedIn

Get LinkedIn Ad Library ad

Get a LinkedIn Ad Library ad by ad id or Ad Library URL.

GET/v1/linkedin/ad-library/ads
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
adIdstringquery

LinkedIn Ad Library id for the ad.

min 1 chars · max 4096 chars

urlstringquery

Public LinkedIn Ad Library URL for the ad.

min 1 chars · max 4096 chars

Response fields
39

Endpoint-specific response payload.

datalookupStatus
string

Whether the ad was found in the Ad Library.

one of: found, not_found

Ad details when found; otherwise null.

dataadid
string

Stable identifier for the ad.

min 1 chars

dataadurl
stringnullable

Public LinkedIn Ad Library URL for this ad when available.

dataaddescription
stringnullable

Primary ad body text when available.

dataadheadline
stringnullable

Ad headline when available.

dataadadType
stringnullable

Ad format type when available.

dataadposter
stringnullable

Poster name shown on the ad when available.

dataadposterTitle
stringnullable

Poster title shown on the ad when available.

dataadpromotedBy
stringnullable

Promoted-by attribution when available.

Advertiser summary for this ad.

dataadadvertisername
stringnullable

Advertiser display name when available.

dataadadvertiserpageUrl
stringnullable

Public LinkedIn company page URL when available.

Targeting summary for this ad.

dataadtargetinglanguage
stringnullable

Language targeting summary when available.

dataadtargetinglocation
stringnullable

Location targeting summary when available.

dataadtargetingcompany
stringnullable

Company targeting summary when available.

dataadtargetingaudience
stringnullable

Audience targeting summary when available.

Creative content for this ad.

dataadcreativeimageUrl
stringnullable

Primary image URL when available.

dataadcreativevideoUrl
stringnullable

Primary video URL when available.

Carousel image URLs when available.

dataadcreativecarouselImageUrls[]
stringoptional

min 1 chars

dataadcreativecta
stringnullable

Call-to-action label when available.

dataadcreativedestinationUrl
stringnullable

Destination URL when available.

Duration metadata for this ad.

dataaddurationlabel
stringnullable

Human-readable ad duration label when available.

dataaddurationstartedAt
stringnullable

ISO-8601 timestamp for when the ad started, when available.

dataaddurationendedAt
stringnullable

ISO-8601 timestamp for when the ad ended, when available.

Impressions metadata for this ad.

dataadimpressionstotal
stringnullable

Total impressions label when available.

Impressions share broken down by country when available.

dataadimpressionsbyCountry[]country
string

Country name or code.

min 1 chars

dataadimpressionsbyCountry[]share
string

Share of impressions attributed to this country.

min 1 chars

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/linkedin/ad-library/ads?adId=664291126" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Ad Library ad detail.