LinkedIn API: Search ads

Returns the first page of public ads matching the supplied advertiser, payer, keyword, country, date, or impression filters. No single filter is required; use the returned pagination_token for the next page.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

account_owner?string

Advertiser (account owner) name filter.

company_name?string

Alternative advertiser-name filter.

payer?string

'Paid for by' entity name filter.

keyword?string

Free-text creative keyword.

countries?string

ISO 3166-1 alpha-2 country code the ad was served in, comma-separated for multiple.

date_option?string

Date range preset. custom-date-range requires startdate/enddate.

Value in

"last-30-days"
"current-month"
"current-year"
"last-year"
"custom-date-range"

startdate?string

Custom range start (YYYY-MM-DD). Requires date_option=custom-date-range.

Match^\d{4}-\d{2}-\d{2}$

enddate?string

Custom range end (YYYY-MM-DD). Requires date_option=custom-date-range.

Match^\d{4}-\d{2}-\d{2}$

impressions_min_value?|

Minimum impressions, paired with impressions_min_unit.

Range0 <= value

impressions_min_unit?string

Unit for impressions_min_value.

Value in

"none"
"thousand"
"million"

impressions_max_value?|

Maximum impressions, paired with impressions_max_unit.

Range0 <= value

impressions_max_unit?string

Unit for impressions_max_value.

Value in

"none"
"thousand"
"million"

curl -X GET "https://example.com/v1/linkedin/ads/search" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "ads": [      {        "ad_id": "string",        "url": "string",        "creative_type": "string",        "thumbnail": "string",        "aria_label": "string",        "is_video": true      }    ],    "count": 0,    "match_count": 0,    "is_last_page": true,    "pagination_token": "string"  }}