LinkedIn Ad Library 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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query?stringFull LinkedIn Ad Library search URL, or a keyword when account_owner is empty.
Example 1 (URL):
https://www.linkedin.com/ad-library/search?accountOwner=airbusExample 2 (keyword):
aerospaceaccount_owner?stringAdvertiser / company name filter (accountOwner).
Example:
airbuskeyword?stringKeyword filter on ad copy.
countries?stringComma-separated ISO country codes, or ALL.
Example:
US,FRdate_option?stringDate window: last-30-days, current-month, current-year, last-year, custom-date-range.
start_date?stringStart date YYYY-MM-DD when date_option=custom-date-range.
end_date?stringEnd date YYYY-MM-DD when date_option=custom-date-range.
cursor?stringOpaque cursor from pagination.cursor / pagination.next.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.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 }}