Skip to main content
Network status
Log in
Piloterr
Back to library

LinkedIn Ad Library Ad API

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

Active2 credits = 1 requestGET/v2/linkedinadlibrary/ad
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Read one creative from the LinkedIn Ad Library. Pass the detail URL returned by search (/ad-library/detail/...) or the bare numeric ad id. 2 credits per call.

The response includes the advertiser, format, copy, CTA, payer, impressions when shown, and targeting when LinkedIn exposes it.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/linkedinadlibrary/ad?query=https://www.linkedin.com/ad-library/detail/1585536544
GET https://api.piloterr.com/v2/linkedinadlibrary/ad?query=1585536544

ParametersLink to Parameters

Parameter Type Required Description
query string yes Detail URL or numeric ad id

Response fieldsLink to Response fields

Field Type Description
ad_id string Numeric LinkedIn ad id
url string Detail URL
status string active or inactive
format string image, video, carousel, event, document, or text
format_label string | null LinkedIn label (Single Image Ad, …)
advertiser_name / advertiser_url / advertiser_image_url string | null Advertiser
paid_by string | null Payer shown in About the ad
headline / description / image_url / video_url string | null Creative
cta_text / target_url string | null Call to action
start_date / end_date / impressions string | null When LinkedIn exposes them
carousel / targeting array | null Extra creative / targeting blocks

NotesLink to Notes

  • A search URL passed here returns 400.
  • Some ads omit impressions, dates, or targeting.

Error codesLink to Error codes

Code Meaning
400 Missing query, or not an ad detail
403 LinkedIn auth wall
404 Ad not found
500 The Ad Library request failed

Related endpointsLink to Related endpoints

Main use casesLink to Main use cases

  • Open a search card and read the full creative
  • Track payer, CTA, and targeting for competitor ads

Related APIs

Expand your data capabilities with these complementary tools.

View All
LinkedIn Ad Library Search/v2/linkedinadlibrary/search

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

GET2 credits = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert