Public Ads API
Get API key
Last updated 21 October 2026View as Markdown

Company or keywordEU impressionsPaid for bySandbox

LinkedIn Ad Library API

Search the LinkedIn Ad Library from your own software. Send a company name, a LinkedIn company id or a keyword and get about 24 ads a page as JSON.

Read the quickstart
  • Sandbox key straight away
  • 100 credits a month free
  • No card

GET /v1/linkedin/ads?company=Contoso

authorization: Bearer $PADS_API_KEY

Sandbox sample image, no media
LinkedInImage

Contoso Analytics

Dashboards your finance team will actually open

See how 300 finance teams close the month two days sooner.

Request demo
Shown
1 Jul 2026 to 15 Oct 2026
Impressions
50K to 100K
Where
Linkedin
Regions
GB, NL
linkedin_500000001In the library
A sandbox ad from a made-up advertiser
Up to 24 ads a page2 credits a page with adsEmpty pages freeSandbox instantLive status →

What you can search

Search the LinkedIn Ad Library

GET /v1/linkedin/ads takes one of three subjects and the filters this library has. A filter it doesn’t have is refused by name, so nothing is silently ignored.

A company

company takes a name; company_id takes LinkedIn’s id.

A keyword

q finds ads with those words.

  • company
    Values
    A company name, as LinkedIn shows it.
    Default
    One subject is required
  • q
    Values
    Words in the ad.
    Default
    One subject is required
  • company_id
    Values
    LinkedIn’s company id, from a search result’s advertiser.id.
    Default
    One subject is required
  • countries
    Values
    Comma separated ISO 3166 alpha-2
    Default
    All
  • date_from
    Values
    YYYY-MM-DD
    Default
    Any
  • date_to
    Values
    YYYY-MM-DD
    Default
    Any
  • cursor
    Values
    next_cursor from the last page, with the same parameters
    Default
    First page

One ad

What one ad’s detail adds

GET /v1/ads/{id} returns the ad with everything the LinkedIn Ad Library shows about it, in one call, for 2 credits.

  • The full text, format and dates the ad ran.
  • Who paid for it, as LinkedIn’s “Paid for by” shows.
  • For ads shown in the EU: total impressions, impressions by country, and the top targeting.

GET https://api.publicadsapi.com/v1/ads/linkedin_500000001

Where the library is thin

LinkedIn’s library covers ads shown anywhere, but impressions and targeting only for ads shown in the EU. A US only ad gives its advertiser, text, dates and who paid. Dates must fall within the last year.

ScrapeCreators, Adyntel and SearchAPI also search the LinkedIn Ad Library.

Sandbox

Every answer, before your first live search

Your sandbox key comes the moment you sign up. Any search returns sample ads from made-up advertisers in the live shape, and these searches return what a live one can. None of them uses a credit.

Read the quickstart

  • 200, no ads

    company=empty

    A search that finds nothing. An empty page uses no credits.

  • 503 UPSTREAM_BLOCKED

    company=blocked

    The platform refused every address we tried. Retry-After says when to try again.

  • 504 TIMEOUT

    company=timeout

    The platform didn’t answer in time. Retry, or narrow the search.

  • 502 UPSTREAM_CHANGED

    company=changed

    The platform’s page changed and we couldn’t read it. We are alerted.

2 credits

a page of ads, or one ad

Up to 24 ads a page. 100 credits a month free, no card.

$0.163

per 1,000 ads on Growth

With full pages: $49 a month for 25,000 credits.

$0

when there is nothing

Empty pages, blocks, timeouts and errors use no credits.

See pricing

Ask your AI about this API

It reads this page, then tells you if it fits, what it costs and what building it takes.

Ask ChatGPT about this(opens in a new tab)Ask Claude about this(opens in a new tab)

Questions

Before you build

Is there an official LinkedIn Ad Library API?

LinkedIn’s own API for its Ad Library is gated: you apply for access. Public Ads API reads the public library pages, so you can start with a key today.

Why does a LinkedIn search use 2 credits?

LinkedIn blocks about half of lookups, so we retry them on new addresses, which costs us more. A page with ads uses 2 credits; a blocked search that fails on every address uses none.

What does a LinkedIn search cost?

A page of up to 24 ads uses 2 credits, and so does one ad with all its detail. On Growth ($49 for 25,000 credits) that is about $0.163 per 1,000 ads with full pages. An empty page, a block, an error and every sandbox call use nothing. The free plan has 100 credits a month and needs no card.

Can I see who paid for an ad?

Yes. One ad’s detail carries payer, LinkedIn’s “Paid for by”, for ads shown anywhere.

Your first LinkedIn Ad Library search, in the next ten minutes

Sandbox key straight away. 100 credits a month free.

Read the quickstart