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

LinkedIn Ad Library Search API

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

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

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Search the LinkedIn Ad Library. Pass an advertiser name (airbus), a keyword, or a full Ad Library search URL. 2 credits per call.

Each card includes the ad id, advertiser, format, headline, description, and preview image. Pagination is { results, pagination }. Open results[].url with the ad endpoint for the full creative.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/linkedinadlibrary/search?account_owner=airbus
GET https://api.piloterr.com/v2/linkedinadlibrary/search?query=https://www.linkedin.com/ad-library/search?accountOwner=airbus
GET https://api.piloterr.com/v2/linkedinadlibrary/search?keyword=aerospace&countries=US

ParametersLink to Parameters

Parameter Type Required Description
query string no* Full search URL, or a keyword when account_owner is empty
account_owner string no* Advertiser / company name (accountOwner)
keyword string no Keyword filter on ad copy
countries string no Comma-separated ISO codes, or ALL
date_option string no last-30-days, current-month, current-year, last-year, custom-date-range
start_date / end_date string no YYYY-MM-DD for a custom range
cursor string no Opaque cursor from pagination.cursor

*Provide a search target via query and/or account_owner (and optionally keyword).

Response fieldsLink to Response fields

Field Type Description
results[] array Ad cards
results[].ad_id string Numeric LinkedIn ad id
results[].advertiser_name string | null Advertiser shown on the card
results[].url string Detail URL. Pass it to the ad endpoint
results[].format string image, video, carousel, event, document, or text
results[].headline / description / image_url string | null Creative preview
pagination.per_page integer Page size (24)
pagination.total_results / total_pages integer | null Count when LinkedIn reports it
pagination.next / cursor string | null Next page URL and opaque cursor

NotesLink to Notes

  • A detail URL passed to search returns 400. Use the ad endpoint.
  • An empty result returns 404, not an empty 200.
  • format is lowercase in the response.

Error codesLink to Error codes

Code Meaning
400 Missing target, detail URL, or unknown date option
403 LinkedIn auth wall
404 No ads for these filters
500 The Ad Library request failed

Related endpointsLink to Related endpoints

Main use casesLink to Main use cases

  • List creatives an advertiser has run on LinkedIn
  • Page through results with pagination.cursor
  • Open each card with the ad endpoint for CTA, payer, and targeting

Related APIs

Expand your data capabilities with these complementary tools.

View All
LinkedIn Ad Library Ad/v2/linkedinadlibrary/ad

Get one LinkedIn Ad Library creative by URL or id: copy, CTA, payer, impressions, and targeting (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