Skip to main content
POST
/
api
/
linkedin
/
ad_library
/
advertisers
/
ads
/linkedin/ad_library/advertisers/ads
curl --request POST \
  --url https://api.anysite.io/api/linkedin/ad_library/advertisers/ads \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "company_id": "<string>",
  "count": 2,
  "timeout": 300,
  "countries": [
    "US"
  ],
  "targeting_included": [
    "LANGUAGE"
  ],
  "targeting_excluded": [
    "COMPANY"
  ],
  "sort": "newest"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "@type": "@linkedin_ad",
    "advertiser": {
      "@type": "@linkedin_advertiser",
      "id": "<string>",
      "name": "<string>",
      "image": "<string>",
      "company_url": "<string>"
    },
    "is_promoted": false,
    "ad_format": "<string>",
    "creative_type": "<string>",
    "text": "<string>",
    "headline": "<string>",
    "cta_text": "<string>",
    "image": "<string>",
    "video": "<string>",
    "video_preview": "<string>",
    "payer": "<string>",
    "ran_from": "<string>",
    "ran_to": "<string>",
    "impressions": "<string>",
    "impressions_by_country": [],
    "targeting": {
      "@type": "@linkedin_ad_targeting",
      "segments": [],
      "parameters": []
    },
    "creatives": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
company_id
string
required

Numeric LinkedIn company id of the advertiser, or a /company/ URL

Minimum string length: 1
Examples:

"1441"

"https://www.linkedin.com/company/1441"

count
integer
required

Max result count

Required range: x >= 1
Example:

20

timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
countries
string[] | null

ISO-3166 alpha-2 country codes, uppercase

Example:
["US"]
date_option
enum<string> | null

Time window of when the ads ran

Available options:
last-30-days,
current-month,
current-year,
last-year
targeting_included
enum<string>[] | null

Only ads that targeted these audience parameter categories

Available options:
LANGUAGE,
LOCATION,
AUDIENCE,
DEMOGRAPHIC,
COMPANY,
EDUCATION,
JOB,
INTERESTS_AND_TRAITS
Example:
["LANGUAGE"]
targeting_excluded
enum<string>[] | null

Only ads that excluded these audience parameter categories

Available options:
LANGUAGE,
LOCATION,
AUDIENCE,
DEMOGRAPHIC,
COMPANY,
EDUCATION,
JOB,
INTERESTS_AND_TRAITS
Example:
["COMPANY"]
sort
enum<string>
default:newest

Result ordering by ad date

Available options:
newest,
oldest

Response

Successful Response

id
string
required
url
string
required
@type
string
default:@linkedin_ad
advertiser
LinkedinAdvertiser · object
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
LinkedinAdCountryImpressions · object[]
targeting
LinkedinAdTargeting · object
creatives
LinkedinAdCreative · object[]