Piloterr

LinkedIn Ad Library Search

GET
/v2/linkedinadlibrary/search

Search the LinkedIn Ad Library by advertiser, keyword, country, and date. Returns ad cards and pagination (2 credits).

Credit cost: 2 credits per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query?string

Full LinkedIn Ad Library search URL, or a keyword when account_owner is empty.

Example 1 (URL):

https://www.linkedin.com/ad-library/search?accountOwner=airbus

Example 2 (keyword):

aerospace
account_owner?string

Advertiser / company name filter (accountOwner).

Example:

airbus
keyword?string

Keyword filter on ad copy.

countries?string

Comma-separated ISO country codes, or ALL.

Example:

US,FR
date_option?string

Date window: last-30-days, current-month, current-year, last-year, custom-date-range.

start_date?string

Start date YYYY-MM-DD when date_option=custom-date-range.

end_date?string

End date YYYY-MM-DD when date_option=custom-date-range.

cursor?string

Opaque cursor from pagination.cursor / pagination.next.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/linkedinadlibrary/search"
{  "results": [    {      "url": "https://www.linkedin.com/ad-library/detail/1585536544",      "ad_id": "1585536544",      "format": "image",      "headline": "Airbus is Hiring",      "image_url": "https://media.licdn.com/dms/image/v2/D4E10AQFZ54-UGWaraQ/image_627_1200/B56Z6EWmiMG0AU-/0/1780336978225/Airbus2026Q2Kinston1200x627jpg",      "description": "Airbus is hiring in Kinston, NC where we are building advanced composite structures for the A350.",      "advertiser_name": "Airbus",      "advertiser_image_url": "https://media.licdn.com/dms/image/v2/C4D0BAQF2j_LDG_TOzg/company-logo_100_100/company-logo_100_100/0/1631375371456/airbusgroup_logo"    }  ],  "pagination": {    "next": "https://www.linkedin.com/ad-library/search?accountOwner=airbus&paginationToken=1585433394-1790883234944",    "page": 1,    "cursor": "1585433394-1790883234944",    "per_page": 24,    "total_pages": 54,    "total_results": 1293  }}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}