Skip to main content
POST
/linkedin/ad_library/ads/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
keyword
string | null
Minimum string length: 1
company_ids
integer[] | null
payer
string | null
Minimum string length: 1
countries
string[] | null
date_option
enum<string> | null
Available options:
last-30-days,
current-month,
current-year,
last-year
impressions_min
integer | null
Required range: x >= 0
impressions_max
integer | null
Required range: x >= 0
impressions_unit
enum<string>
default:Thousand
Available options:
Thousand,
Million
targeting_included
enum<string>[] | null
Available options:
LANGUAGE,
LOCATION,
AUDIENCE,
DEMOGRAPHIC,
COMPANY,
EDUCATION,
JOB,
INTERESTS_AND_TRAITS
targeting_excluded
enum<string>[] | null
Available options:
LANGUAGE,
LOCATION,
AUDIENCE,
DEMOGRAPHIC,
COMPANY,
EDUCATION,
JOB,
INTERESTS_AND_TRAITS
sort
enum<string>
default:newest
Available options:
newest,
oldest

Response

Successful Response

id
string
required
url
string
required
@type
string
default:LinkedinAd
advertiser
object | null
is_promoted
boolean
default:false
ad_format
string | null
creative_type
string | null
text
string | null
headline
string | null
cta_text
string | null
image
string | null
video
string | null
video_preview
string | null
payer
string | null
ran_from
string | null
ran_to
string | null
impressions
string | null
impressions_by_country
object[]
targeting
object | null
creatives
object[]