Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

LinkedIn

You first need to create an account, you can sign up here to receive 50 credits to test it out.

The LinkedIn endpoint allows you find all LinkedIn ads for a given company.

It takes a company domain as input.

Company domain has to be passed in the 'company.com' format, meaning all prefixes like 'https://' or 'www.' need to be removed.

API endpoint

POST api.adyntel.com/linkedin

See which LinkedIn ads a company is running by providing their website as input.

Headers

Name
Value
Required

Content-Type

application/json

Body

Name
Type
Description
Required

api_key

string

Adyntel API key

email

string

Adyntel account email

company_domain

string

Company website Either this or linkedin_page_id is required.

linkedin_page_id

number

LinkedIn Page ID Either this or company_domain is required.

all_ads

boolean

This will automatically use the continuation_token and scrape all the pages, returning all available ads. Works only with a webhook_url as it needs a place to send each page, one by one. Warning: use this cautiously because there is no way of stopping it. If you use this on a domain that runs 10000 ads, it will try to scrape all the ads and it will use the credits (one page = one credit)

date_filter

string or object

Filters returned ads by the date they ran in LinkedIn's Ad Library. Accepts a preset string — last30d, month, year, lastyear — or a custom range {"startdate": "YYYY-MM-DD", "enddate": "YYYY-MM-DD"}. Do not use today's date as the enddate as Linkedin would return 0 ads, always use yesterday's date. Also the difference between startdate and enddate can't be more than 364 days as Linkedin would return 0 ads again.

webhook_url

string

Webhook URL where the data will be returned. With a webhook the call answers immediately with a job id and the ads are POSTed to your URL when the scrape finishes. Without one the ads come back in the response to your call.

continuation_token

string

Token used to grab the next set of ads. You receive it in the response to your first call, and you send it back on the next call to get the following page. The last page comes back with a null token.

impression_data

boolean

Adds an eu_transparency block to every ad: the dates it ran, its total impressions, the split of those impressions by country, and the targeting the advertiser used. Cannot be combined with date_filter; the two together are rejected with a 422. Costs 2 credits instead of 1. Only ads served in the EU carry this data. For any other ad the block still comes back, empty.

EU transparency data

Set impression_data to true and every ad in the response gains an eu_transparency object:

LinkedIn only publishes this for ads served in the EU. An ad without it comes back with the same object, empty:

impression_data costs 2 credits per call instead of 1.

Example request

Example request

Request using company domain

Request using linkedin_page_id

You can read more here about how to find the LinkedIn page id via Clay.

Request using a webhook

When you use a webhook the call answers straight away and the ads are sent to your URL:

Example response

PreviousMeta ad search
NextLinkedIn keyword search

Last updated