LinkedIn Ads API

Preview paused

Public advertising
records

Collect public LinkedIn Ad Library records with advertiser, creative and impression context. Interactive preview is paused during source maintenance.

Ad Library search URLs or company inputs
Ad copy, format and destination fields
Public impression ranges when published

View the Actor Try the sample

Historical recordings · 1 recorded item in the saved sample

POST/acts/meka.im~linkedin-ads-library-scraper/run-sync-get-dataset-items

Notion · LinkedIn ad record

LinkedIn · recorded sample

1 recorded item

Advertising library

1619931196

The exact decks, investor lists, and AI agents top startups used to close their first checks. Free guide, free Notion tr…

Advertiser

Empty string

Format

DOCUMENT

The saved advertiserName is an empty string and body may be truncated in list mode. Values are shown as recorded.

Recorded Sep 24, 2026Historical sample

LinkedIn Ads Library

Overview

What this API returns

Collect public LinkedIn Ad Library records with advertiser, creative and impression context. Interactive preview is paused during source maintenance.

startUrls accepts public LinkedIn Ad Library search URLs or company URLs and preserves search parameters such as payer, keyword, countries, dates, impressions and sort. resultsLimit caps delivered ads per input; skipDetails enables a faster list-only mode.

The published product metadata marks an interactive preview pause during source maintenance. This page does not infer current source health beyond that note. Public fields such as availability, impressions and targeting appear only when LinkedIn exposes them.

Input

Ad Library search or company URLs

Output

Ad records

Send Ad Library inputs

Provide public Ad Library search URLs or LinkedIn company URLs to the Actor endpoint.

Read public ad cards

The Actor follows the preserved search parameters and reads public ad records for each input.

Inspect creative detail

Full detail mode returns public copy, CTA, media and impression context when those fields are available.

Use cases

Where these records fit

The record is designed to sit inside research and review workflows. The examples below are starting points, not packaged scores.

Competitor ad review

Collect public ads for a company or search and review copy, format and destination fields.

advertiserName
body
format

Creative library

Keep public creative references and media URLs from selected Ad Library results.

imageUrl
videoUrl
documentUrl

Category monitoring

Compare public impression ranges and first/last-shown dates across saved ad records.

impressions
availability
targeting

Try it

Inspect a recorded LinkedIn ad

Read a saved public ad row, then inspect the original Dataset item as JSON. The maintenance notice remains visible.

Preview pausedChecking live preview

Enter a public LinkedIn Ad Library search URL or company URL.

POSThttps://api.apify.com/v2/acts/meka.im~linkedin-ads-library-scraper/run-sync-get-dataset-items

Recorded sampleSep 24, 2026

Rendered

Recorded

1 record

LinkedIn advertising

LinkedIn ad 1619931196

DOCUMENT

The exact decks, investor lists, and AI agents top startups used to close their first checks. Free guide, free Notion tr…

Open Ad Library

Format

DOCUMENT

Preview notes (1)

The advertiser name is empty in this record; no advertiser name is inferred.

Advertiser and creative

Advertiser name: Empty string
Format: DOCUMENT

Media

Returned document or image pages.

Listing image 1

Targeting and identifiers

Ad ID: 1619931196

Response details (5 fields)

Advertiser

The advertiser name is displayed exactly as stored. An empty string stays empty and is not replaced with the sample label inside the record view.

Advertiser name: Empty string

Creative

Ad copy is shown as text; the report does not execute or interpret markup. List-mode text may be truncated by the source.

Ad copy: The exact decks, investor lists, and AI agents top startups used to close their first checks. Free guide, free Notion tr…
Format: DOCUMENT

Not returned

Identifiers and source

Ad ID: 1619931196
Ad Library URL: https://www.linkedin.com/ad-library/detail/1619931196
Format: DOCUMENT

Only returned fields are shown.

All returned fields

adId: 1619931196
adLibraryUrl: https://www.linkedin.com/ad-library/detail/1619931196
advertiserName: Empty string
body: The exact decks, investor lists, and AI agents top startups used to close their first checks. Free guide, free Notion tr…
format: DOCUMENT

Recorded Sep 24, 2026 · Historical snapshot · Source: LinkedIn

JSON

Recordedapplication/json

1[2  {3    "adId": "1619931196",4    "adLibraryUrl": "https://www.linkedin.com/ad-library/detail/1619931196",5    "advertiserName": "",6    "body": "The exact decks, investor lists, and AI agents top startups used to close their first checks. Free guide, free Notion tr…",7    "format": "DOCUMENT"8  }9]

Reference

Request and response contract

POST to the Apify Actor endpoint with a bearer token. Request examples use $APIFY_TOKEN and the current product defaults; response examples come from a saved historical record.

Parameters

Request fields accepted by the Actor. Preview input is sent only when you run a live request.

startUrlsArray<string | { url: string }>Required

LinkedIn Ad Library search URLs or LinkedIn company URLs. Search parameters such as accountOwner, payer, keyword, countries, dates, impressions, targeting, and sort are preserved.

Example: [{"url":"https://www.linkedin.com/ad-library/search?accountOwner=apify&countries=US&dateOption=last-30-days"}]

resultsLimitinteger | null

Maximum successfully delivered ads per input URL. Leave empty to continue until LinkedIn reports the true end or your run budget is reached. Minimum: 1. Maximum: 100000.

Example: 100

skipDetailsboolean

Fast list mode. Returns the public search-card fields, which may contain truncated text and fewer details. Full details are recommended. Default: false.

disableTelemetryboolean

Turn off the anonymous reliability telemetry described in the README. When this is on, nothing about your run — including the keywords in your Ad Library URLs — leaves the run. Default: false.

Response

Published response fields. Example properties are taken from one historical record; they describe that record, not a guaranteed schema for every response.

adIdstringRequired

LinkedIn Ad Library ad identifier.

Example: 1619931196

adLibraryUrlstringRequired

Canonical public Ad Library detail URL.

Example: https://www.linkedin.com/ad-library/detail/1619931196

advertiserLogostring | null

Public advertiser logo or profile image URL.

advertiserNamestringRequired

Advertiser name displayed by LinkedIn.

Example:

advertiserUrlstring | null

Public LinkedIn company or member URL.

availabilityobject | null

First and last shown dates when LinkedIn exposes them.

bodystring | null

Full public ad copy in detail mode; possibly truncated in list mode.

Example: The exact decks, investor lists, and AI agents top startups used to close their first checks. Free guide, free Notion tr…

clickUrlstring | null

Public creative or CTA destination URL.

ctasstring[]

Public call-to-action labels.

formatstringRequired

Observed LinkedIn creative format.

Example: DOCUMENT

headlinestring | null

Creative headline when publicly present.

imageUrlstring | null

Primary image creative URL.

videoUrlstring | null

Highest-bitrate public MP4 URL.

documentUrlstring | null

Public document PDF URL.

imageUrlsstring[]

All public document page images.

senderImageUrlstring | null

Message Ad sender image.

paidBystring | null

Entity LinkedIn identifies as paying for the ad.

impressionsstring | null

Public impression range.

impressionsPerCountryobject[]

Country impression percentages when published.

targetingobject | null

Top public targeting parameters.

thoughtLeaderMemberNamestring | null

Thought Leader ad member name.

thoughtLeaderMemberUrlstring | null

Thought Leader public member URL.

thoughtLeaderMemberImageUrlstring | null

Thought Leader member image.

thoughtLeaderJobTitlestring | null

Thought Leader public headline.

startUrlstringRequired

Original input source URL that discovered the ad.

curl -X POST 'https://api.apify.com/v2/acts/meka.im~linkedin-ads-library-scraper/run-sync-get-dataset-items' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "startUrls": [
    {
      "url": "https://www.linkedin.com/ad-library/search?accountOwner=apify&countries=US&dateOption=last-30-days"
    }
  ],
  "resultsLimit": 100,
  "skipDetails": false
}'

Recorded sample

1 recorded item · historical sample

[
  {
    "adId": "1619931196",
    "adLibraryUrl": "https://www.linkedin.com/ad-library/detail/1619931196",
    "advertiserName": "",
    "body": "The exact decks, investor lists, and AI agents top startups used to close their first checks. Free guide, free Notion tr…",
    "format": "DOCUMENT"
  }
]

Recorded Sep 24, 2026 · historical snapshot

Pricing & access

Usage is billed through the Actor

Published FREE-plan event rates from public Apify metadata. Plan-specific rates and usage terms remain on the Actor's pricing page.

Pricing

Pay per delivered event

Apify FREE-plan rate

$1.00per 1,000 ads

Per unique LinkedIn ad delivered.

Checked 19 Oct 2026Apify pricing

Access

One POST endpoint

Authenticate with an Apify Bearer token.
Send a JSON body to the posted Actor endpoint.
Read the Dataset items array returned by the run.

https://api.apify.com/v2/acts/meka.im~linkedin-ads-library-scraper/run-sync-get-dataset-items

FAQ

Questions about the contract

Authentication, response shape, recorded data and availability.

What does the maintenance notice mean?

The product metadata marks an interactive preview pause during source maintenance. This page does not infer whether the underlying source is currently online beyond that published note.

What does skipDetails change?

skipDetails enables fast list mode with public search-card fields, which may contain truncated text and fewer details. Full detail mode is recommended when you need the complete public card.

Are impressions exact?

No. impressions is a public range when LinkedIn publishes one. It is not converted into an exact count.

How do I authenticate requests?

Send an Apify token as a Bearer token in the Authorization header, as shown in the request examples.

Are the results on this page live?

Not by default. Saved samples are historical recordings from the source; each keeps the fields and values from that record and does not verify current availability. Live data is requested directly from the published Apify Actor endpoint with your own token.

Where can I find current pricing?

Current pricing and usage terms are published on the Apify Actor page.

Public advertisingrecords

What this API returns

Send Ad Library inputs

Read public ad cards

Inspect creative detail

Where these records fit

Competitor ad review

Creative library

Category monitoring

Inspect a recorded LinkedIn ad

Advertiser and creative

Media

Targeting and identifiers

Advertiser

Creative

Identifiers and source

Request and response contract

Parameters

Response

Usage is billed through the Actor

Pay per delivered event

One POST endpoint

Questions about the contract

Continue with adjacent datasets

Google Ads Transparency

LinkedIn Company

LinkedIn Public Posts

Collect public advertising records

Public advertising
records