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
Autorización
ApiKeyAuth Your API key. Include it in the x-api-key header for every request.
In: header
Parámetros de consulta
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=airbusExample 2 (keyword):
aerospaceAdvertiser / company name filter (accountOwner).
Example:
airbusKeyword filter on ad copy.
Comma-separated ISO country codes, or ALL.
Example:
US,FRDate window: last-30-days, current-month, current-year, last-year, custom-date-range.
Start date YYYY-MM-DD when date_option=custom-date-range.
End date YYYY-MM-DD when date_option=custom-date-range.
Opaque cursor from pagination.cursor / pagination.next.
Cuerpo de la respuesta
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"}