LinkedIn Ad Library Ad
GET
Get one LinkedIn Ad Library creative by URL or id: copy, CTA, payer, impressions, and targeting (2 credits).
Credit cost: 2 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringAd id or detail URL from search.
Example:
https://www.linkedin.com/ad-library/detail/1585536544fields?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}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
url?stringad_id?stringformat?stringstatus?stringpaid_by?stringcarousel?unknowncta_text?stringend_date?unknownheadline?stringimage_url?stringtargeting?unknownvideo_url?unknownstart_date?unknowntarget_url?unknowndescription?stringimpressions?unknownformat_label?stringadvertiser_url?stringfollower_count?unknownadvertiser_name?stringadvertiser_image_url?stringcurl -X GET 'https://api.piloterr.com/v2/linkedinadlibrary/ad?query=string'Example Response
{ "url": "https://www.linkedin.com/ad-library/detail/1585536544", "ad_id": "1585536544", "format": "image", "status": "active", "paid_by": "Focused Image", "carousel": null, "cta_text": "Apply", "end_date": null, "headline": "Airbus is Hiring", "image_url": "https://media.licdn.com/dms/image/v2/D4E10AQFZ54-UGWaraQ/image_627_1200/B56Z6EWmiMG0AU-/0/1780336978225/Airbus2026Q2Kinston1200x627jpg", "targeting": null, "video_url": null, "start_date": null, "target_url": null, "description": "Airbus is hiring in Kinston, NC where we are building advanced composite structures for the A350.", "impressions": null, "format_label": "Single Image Ad", "advertiser_url": "https://www.linkedin.com/company/2734", "follower_count": null, "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"}