LinkedIn Ads Library

Unified ad search

Search one page by company, payer, keyword, company ID, countries, date preset or date pair, impression range and targeting facets, sorted newest or oldest first. Each card is enriched from its detail page. Pass the returned token with the same filters for continuation. Individual source failures are explicit partial results. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/linkedin/ad-library/ads/search

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/linkedin/ad-library/ads/search
  • Auth: API key in header x-api-key

Query parameters

companystring

Company or advertiser name; combined with other filters.

keywordstring

Keyword in the public library.

companyIdstring

Exact company ID as a string.

countriesstring

Comma-separated uppercase country codes, for example US,DE.

payerstring
startDatestring

Real YYYY-MM-DD calendar date; requires endDate.

endDatestring

Real YYYY-MM-DD date on or after startDate. LinkedIn applies its retained-ad date window.

dateOption'last-30-days' | 'current-month' | 'current-year' | 'last-year'
sortOrder'DESCENDING' | 'ASCENDING'
minImpressionsstring
maxImpressionsstring
includedTargetingstring
excludedTargetingstring
paginationTokenstring

Source continuation token. Reuse the same filters.

cursorstring

Alias of paginationToken. Supply one, never both.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.