Piloterr

LinkedIn Ad Library Ad

GET
/v2/linkedinadlibrary/ad

Get one LinkedIn Ad Library creative by URL or id: copy, CTA, payer, impressions, and targeting (2 credits).

Credit cost: 2 credits per call

Autorización

ApiKeyAuth
headerx-api-key<token>

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

Parámetros de consulta

query*string

Ad id or detail URL from search.

Example:

https://www.linkedin.com/ad-library/detail/1585536544
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Cuerpo de la respuesta

Successful response

application/json
  1. response
url?string
ad_id?string
format?string
status?string
paid_by?string
carousel?unknown
cta_text?string
end_date?unknown
headline?string
image_url?string
targeting?unknown
video_url?unknown
start_date?unknown
target_url?unknown
description?string
impressions?unknown
format_label?string
advertiser_url?string
follower_count?unknown
advertiser_name?string
advertiser_image_url?string
Example Request
curl -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"}