LinkedIn Ad Library Search

Search ads running across LinkedIn by keyword and/or advertiser - each ad's advertiser, ad copy, format, the promoted label, thumbnail and a detail link. Filter by one or more countries and a recent time window. Provide a keyword or a company_id. Costs 6 credits per call.

POST/api/v1/linkedin/ads/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

keywordstring

Keyword to search ads by. Provide keyword or company_id.

Example: ahrefs

company_idstring

The advertiser's numeric LinkedIn company id. Provide keyword or company_id.

Example: 1035

countriesstring | string[]

One or more 2-letter country codes to restrict results to.

Example: US

date_optionstring

Restrict to ads seen within a given recent time window, as a LinkedIn filter token.

Example: last-30-days

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.linkedin.ads_search(keyword="ahrefs", countries="US")
print(results)

Response

"total_seen": 24

"response_time": 3690,

"credits_used": 6,

"credits_remaining": 4564

}