# LinkedIn Ad Library Scraper (`datapeak/linkedin-ad-library`) Actor
Scrape LinkedIn's public Ad Library: competitor ads by company or keyword — ad copy, headline, format, creative image/video URLs, run dates, impressions and country targeting. Supports bulk company lists for B2B competitor ad monitoring. No login required.
- **URL**: https://apify.com/datapeak/linkedin-ad-library.md
- **Developed by:** [Gal Gilboa](https://apify.com/datapeak) (community)
- **Categories:** Lead generation, Automation, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $3.00 / 1,000 ad scrapeds
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## LinkedIn Ad Library Scraper — Competitor Ads, Creatives & Targeting
Extract structured data from the public **LinkedIn Ad Library** (linkedin.com/ad-library): every ad a company is running on LinkedIn — ad copy, headline, format, **creative image/video URLs**, run dates, impressions, country breakdown and targeting. No LinkedIn login, no cookies, public pages only.
Built for **B2B marketers, demand-gen teams, and agencies** doing competitor ad research: see your competitors' LinkedIn ads, which creatives they run, how long each ad has been live, and which countries they target.
### Why this Actor?
- **Bulk company lists** — monitor 1 or 100 competitors in a single run (one query per company). Most LinkedIn ads scrapers only handle one company at a time.
- **Creative URLs extracted** — direct links to the ad's image/video files, ready for a swipe file or creative analysis.
- **Date info** — first/last impression dates per ad, so you can spot long-running (i.e. winning) ads and set up change monitoring on a schedule.
- **Keyword mode** — search all LinkedIn ads by topic (e.g. `crm`) to map a whole category.
### What data does it return?
One dataset item per ad:
- Advertiser name, LinkedIn company URL, logo URL, "Paid by" entity
- Ad copy and headline
- Ad format (`single_image`, `video`, `carousel`, `document`, `text`)
- Creative URLs — image URLs and/or video URL
- Landing page URL and CTA text
- First/last impression dates ("Ran from ... to ...") when LinkedIn shows them
- Total impressions range and **impressions per country**
- Targeting facets shown by LinkedIn (language, locations, company size, ...)
- Ad Library detail URL + which query found the ad
### Sample output
```json
{
"type": "ad",
"adId": "9001111",
"adDetailUrl": "https://www.linkedin.com/ad-library/detail/9001111",
"advertiserName": "HubSpot",
"advertiserUrl": "https://www.linkedin.com/company/hubspot",
"paidBy": "HubSpot, Inc.",
"headline": "The CRM your whole team will actually use",
"adCopy": "Stop juggling spreadsheets. HubSpot's free CRM gives your team one place to track every deal, contact, and conversation.",
"ctaText": "Learn more",
"adFormat": "single_image",
"imageUrls": ["https://media.licdn.com/dms/image/v2/sponsored-creative-111.jpg"],
"videoUrl": null,
"landingPageUrl": "https://www.hubspot.com/crm?utm_source=linkedin",
"firstImpressionAt": "Jan 5, 2026",
"lastImpressionAt": "Jun 30, 2026",
"totalImpressions": "50k-100k",
"impressionsByCountry": [
{ "country": "United States", "percentage": "45%" },
{ "country": "United Kingdom", "percentage": "20%" }
],
"targeting": [
{ "facet": "Language", "value": "English" },
{ "facet": "Location", "value": "United States, United Kingdom, Israel" }
],
"targetedCountries": ["United States", "United Kingdom", "Israel"],
"query": "company \"hubspot\"",
"scrapedAt": "2026-07-11T12:00:00.000Z"
}
````
Fields the Ad Library doesn't show for a given ad come back as `null` / `[]` — the Actor never fails a run over a missing field.
### How to use it
| Input | What it does |
|---|---|
| `companies` | **Bulk list** of advertisers — company names, LinkedIn company URLs, or numeric LinkedIn company IDs (most reliable; visible as `companyIds` in the Ad Library URL) |
| `keyword` | Free-text Ad Library search across all advertisers |
| `maxAdsPerQuery` | Cap per company/keyword query (default 100) |
| `fetchAdDetails` | Open each ad's detail page for dates, impressions, targeting and full creatives (default on) |
| `proxyConfiguration` | **Use Apify RESIDENTIAL proxy** — LinkedIn blocks most datacenter traffic |
### Use cases
- **Competitor ad monitoring** — schedule a weekly run over your competitor list and diff new/retired ads; long-running ads are the ones that work.
- **Creative swipe file** — pull creative URLs + copy for every ad in your category before briefing your next campaign.
- **B2B messaging research** — compare headlines and hooks across a keyword (e.g. every "crm" ad on LinkedIn).
- **Geo strategy** — see which countries competitors put impressions into and what they target.
- **Agency reporting** — attach a client-vs-competitor LinkedIn ads snapshot to monthly reports via the API.
### Pricing (pay per event)
| Event | Price | Meaning |
|---|---|---|
| `ad-scraped` | $0.003 | One ad record in the dataset |
Example: monitoring 20 competitors × 50 ads each = 1,000 ads = **$3.00** per run.
The Actor respects your maximum cost per run and stops cleanly when the limit is reached.
### Fair use & limitations
- Only public, logged-out Ad Library pages are visited — the same transparency data LinkedIn shows any visitor. No login, no member data, low concurrency.
- LinkedIn shows impressions/targeting only for some ads (mainly EU-served ones); other ads return the creative + copy without those panels.
- LinkedIn actively rate-limits automated traffic. Residential proxy is strongly recommended; blocked responses are retried automatically on fresh sessions.
### Integrations
Standard Apify platform features apply: export to JSON/CSV/Excel, API access, webhooks, and scheduled runs for continuous competitor monitoring.
### Development
```bash
npm install
npm test # parses the saved fixtures, 40 assertions
apify run # local run (uses ./storage)
```
# Actor input Schema
## `companies` (type: `array`):
Advertisers to pull ads for — one search per entry. Each entry can be a company name (HubSpot), a LinkedIn company URL (https://www.linkedin.com/company/hubspot), or a numeric LinkedIn company ID (1035 — the most reliable form; you can read it from the companyIds parameter after searching on linkedin.com/ad-library). Leave empty if you use a keyword instead.
## `keyword` (type: `string`):
Free-text Ad Library search, e.g. crm — finds ads from any advertiser whose ad content matches the keyword.
## `maxAdsPerQuery` (type: `integer`):
Maximum number of ads collected per company / keyword query.
## `fetchAdDetails` (type: `boolean`):
If enabled (recommended), the Actor opens each ad's detail page to extract run dates, impressions, country breakdown, targeting and full creative URLs. If disabled, only the lighter search-card data is returned (faster, same price per ad).
## `proxyConfiguration` (type: `object`):
Proxy to use for the requests. Apify RESIDENTIAL proxy is strongly recommended — LinkedIn blocks most datacenter traffic.
## Actor input object example
```json
{
"companies": [
"https://www.linkedin.com/company/hubspot"
],
"maxAdsPerQuery": 100,
"fetchAdDetails": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"companies": [
"https://www.linkedin.com/company/hubspot"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("datapeak/linkedin-ad-library").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"companies": ["https://www.linkedin.com/company/hubspot"],
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("datapeak/linkedin-ad-library").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"companies": [
"https://www.linkedin.com/company/hubspot"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call datapeak/linkedin-ad-library --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=datapeak/linkedin-ad-library",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "LinkedIn Ad Library Scraper",
"description": "Scrape LinkedIn's public Ad Library: competitor ads by company or keyword — ad copy, headline, format, creative image/video URLs, run dates, impressions and country targeting. Supports bulk company lists for B2B competitor ad monitoring. No login required.",
"version": "0.1",
"x-build-id": "XhYhPYMeebz3pDOq7"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/datapeak~linkedin-ad-library/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-datapeak-linkedin-ad-library",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/datapeak~linkedin-ad-library/runs": {
"post": {
"operationId": "runs-sync-datapeak-linkedin-ad-library",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/datapeak~linkedin-ad-library/run-sync": {
"post": {
"operationId": "run-sync-datapeak-linkedin-ad-library",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"companies": {
"title": "Companies (bulk list)",
"type": "array",
"description": "Advertisers to pull ads for — one search per entry. Each entry can be a company name (HubSpot), a LinkedIn company URL (https://www.linkedin.com/company/hubspot), or a numeric LinkedIn company ID (1035 — the most reliable form; you can read it from the companyIds parameter after searching on linkedin.com/ad-library). Leave empty if you use a keyword instead.",
"items": {
"type": "string"
}
},
"keyword": {
"title": "Keyword",
"type": "string",
"description": "Free-text Ad Library search, e.g. crm — finds ads from any advertiser whose ad content matches the keyword."
},
"maxAdsPerQuery": {
"title": "Max ads per query",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum number of ads collected per company / keyword query.",
"default": 100
},
"fetchAdDetails": {
"title": "Fetch ad detail pages",
"type": "boolean",
"description": "If enabled (recommended), the Actor opens each ad's detail page to extract run dates, impressions, country breakdown, targeting and full creative URLs. If disabled, only the lighter search-card data is returned (faster, same price per ad).",
"default": true
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy to use for the requests. Apify RESIDENTIAL proxy is strongly recommended — LinkedIn blocks most datacenter traffic."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```