LinkedIn Ad Library API — Parse an Ad Library URL
Documentation menu
FetchLayer FetchLayer API

Parse an Ad Library URL

Turn any LinkedIn Ad Library URL into the structured filters it encodes — whether it points at one ad or a search, plus the keyword, advertiser, payer, countries, dates, impressions range and targeting filters it carries. Parsing a URL does not consume a credit.

POST /resolve-url Utility
https://api.fetchlayer.dev/linkedin-ad-library/resolve-url
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

url string required

Any Ad Library URL, to be parsed into structured filters.

Response Fields

resolve-url

Parse an Ad Library URL

kind string

What the URL points at: ad, search, or unknown.

adId string

Present when kind is ad.

query string

Keyword. Present when kind is search.

advertiser string

Advertiser name. Present when kind is search.

payer string

Payer name. Present when kind is search.

countries string[]

Country filters carried in the URL.

dateRange string

Date window carried in the URL, with startDate and endDate when it is a custom range.

includedTargeting string[]

Targeting categories the URL filters on.

excludedTargeting string[]

Targeting categories the URL excludes.

Request

curl -X POST "https://api.fetchlayer.dev/linkedin-ad-library/resolve-url" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/search?companyName=Acme%20Software&countries=%5B%22US%22%5D&dateOption=last-30-days"}'

Response

{
  "kind": "search",
  "query": null,
  "advertiser": "Acme Software",
  "countries": [
    "US"
  ],
  "dateRange": "last-30-days",
  "includedTargeting": [],
  "excludedTargeting": []
}