📢 LinkedIn Ad Library Scraper

Extract comprehensive advertising data from LinkedIn's Ad Library with automatic pagination, advanced filtering, URL-based search, and optional ad detail enrichment.

This Apify actor extracts detailed ad information from LinkedIn's public Ad Library, delivering structured data about ad campaigns including creatives, headlines, advertiser details, impressions, targeting parameters, and more.

🎬 Video Tutorial

https://www.youtube.com/watch?v=q5PGi7bmdXw

Key Features

Comprehensive Ad Data Extraction

• Ad Creatives — Images, videos (all quality variants), and carousel content
• Ad Copy — Headlines, body text, descriptions, and full untruncated ad text
• Advertiser Information — Company names, logos, bio/subtitle text, profile URLs
• Call-to-Action — CTA button text and destination links
• External Links — URLs mentioned in ad text
• Ad Detail Enrichment — Optional deep-fetch of impressions, targeting, dates, payer info, and video URLs per ad
• Metadata — Ad IDs, creative types, run dates, status (active/inactive), and timestamps

Performance & Reliability

• Smart Pagination — Automatically handles multi-page results across every search
• Automatic Retries — Transient errors and rate limits are retried for you
• Concurrent Detail Fetching — Enriches multiple ads in parallel
• Rate Limit Handling — Automatic detection and back-off on HTTP 429 responses

Two Search Modes

• URL Mode — Paste LinkedIn Ad Library URLs directly (with all filters pre-applied)
• Search Mode — Build one or more searches, each with its own company, payer, keyword, country, date range, impressions, targeting, and sort order

🔍 How Searching Works

The actor mirrors exactly how search works on linkedin.com/ad-library: you fill in the Company or advertiser, Payer, and/or Keyword fields, pick your Country, Date, and More filters, and run the search.

This actor lets you queue many of those searches at once. There are two ways to provide them, and you can use either or both in a single run:

1. URLs — paste any number of LinkedIn Ad Library URLs. Every filter already baked into the URL is respected.
2. Searches — build searches from scratch in the input form. Each search is fully independent and carries its own filters.

This is the key difference from a single global search: you can run "apify, newest first, US" and "marketing, last 30 days, Germany, min 10k impressions" in the same run, each with completely different settings.

Each search needs at least one identifier

LinkedIn can't run a search with no search terms, so every search must have at least one of: Company, Payer, or Keyword. You can fill in just one, any two, or all three. A search with none of these is skipped automatically (the rest of your searches still run). All the other fields — country, date, impressions, targeting, sort — are optional refinements.

📊 Results & Cost

maxResults sets the cap per URL and per search — not for the whole run.

Worst-case total = (number of URLs + number of searches) × maxResults

Example: 2 URLs + 3 searches, with maxResults = 11:

(2 + 3) × 11 = 55 ads maximum

Set maxResults to 0 for unlimited results per URL/search.

🌐 Proxy & Reliability

This Actor uses a tiered proxy strategy to deliver the best possible success rate.

Paying users get our premium dedicated proxy infrastructure optimized specifically for LinkedIn Ad Library, with higher success rates, faster response times, and significantly fewer rate-limit interruptions on large scrapes.

Free users run on the standard Apify Proxy network. It works well for small jobs and quick tests, but on larger or sustained scrapes you may see slower runs and occasional retries.

If you're hitting limits on the free tier or running production workloads, upgrading to a paid plan automatically activates the premium proxy — no configuration required.

Automatic failover: If the premium proxy is ever unreachable, the Actor seamlessly falls back to Apify Proxy mid-run — your scrape never stops.

🚀 Quick Start

Basic Keyword Search

{
  "searches": [
    { "keyword": "apify" }
  ],
  "maxResults": 50
}

Search by URL

{
  "urls": [
    { "url": "https://www.linkedin.com/ad-library/search?keyword=sony&countries=DZ" }
  ],
  "maxResults": 20
}

Search by Company and Payer

{
  "searches": [
    { "accountOwner": "Apify", "payer": "Apify Technologies s.r.o." }
  ],
  "maxResults": 30
}

🎯 Independent Searches in One Run

Each entry in searches runs as its own search, with its own filters. Mix regions, dates, sort orders, and impression ranges freely:

{
  "searches": [
    {
      "keyword": "web scraping",
      "countries": ["US"],
      "sortOrder": "DESCENDING"
    },
    {
      "accountOwner": "HubSpot",
      "countries": ["DE"],
      "dateOption": "last-30-days",
      "impressionsMinValue": 10,
      "impressionsMinUnit": "thousand"
    },
    {
      "keyword": "black friday",
      "dateOption": "custom-date-range",
      "startDate": "2025-11-01",
      "endDate": "2025-11-30"
    }
  ],
  "fetchAdDetail": true,
  "maxResults": 50
}

This runs 3 independent searches:

1. web scraping in the US, newest first
2. HubSpot ads in Germany from the last 30 days with at least 10k impressions
3. black friday ads during November 2025

Total: 3 searches × 50 = 150 max results.

URLs + Searches Combined

{
  "urls": [
    { "url": "https://www.linkedin.com/ad-library/search?keyword=sony&countries=DZ" }
  ],
  "searches": [
    { "keyword": "apify", "payer": "Apify Technologies s.r.o." }
  ],
  "maxResults": 10
}

The URL runs as one job and the search runs as another, each independently paginated and capped at maxResults.

Total: (1 URL + 1 search) × 10 = 20 max results.

📋 Input Configuration

Top-Level Parameters

Per-Search Fields (inside each searches entry)

⚠️ *At least one of accountOwner, payer, or keyword is required per search. You may fill one, two, or all three.

Impressions Units

Targeting Facet Categories

Available values for includedTargetingFacetCategories and excludedTargetingFacetCategories:

LANGUAGE, LOCATION, AUDIENCE, DEMOGRAPHIC, COMPANY, EDUCATION, JOB, INTERESTS_AND_TRAITS

A category can appear in both included and excluded arrays simultaneously — this corresponds to LinkedIn's "Both" filter option.

Date Filter Options

If startDate and endDate are both provided, they take priority over dateOption.

📤 Output Structure

Standard Output (fetchAdDetail: false)

{
  "adId": "894398854",
  "advertiserName": "Apify",
  "advertiserBio": "Promoted",
  "isPromoted": true,
  "creativeType": "SPONSORED_STATUS_UPDATE",
  "headline": "$1M in prizes for tools AI needs.",
  "adText": "Companies deploying AI hit walls. Tools don't exist yet...",
  "detailPageUrl": "https://www.linkedin.com/ad-library/detail/894398854",
  "imageUrl": "https://media.licdn.com/dms/image/...",
  "logoUrl": "https://media.licdn.com/dms/image/...",
  "ctaText": "View details",
  "externalLinksInText": [],
  "scrapedAt": "2026-03-21T00:55:56.066Z"
}

Enriched Output (fetchAdDetail: true)

When fetchAdDetail is enabled, each ad includes a detail object with deep data from the ad's detail page:

{
  "adId": "1230248844",
  "advertiserName": "Nivide",
  "advertiserBio": "Promoted",
  "isPromoted": true,
  "creativeType": "SPONSORED_STATUS_UPDATE",
  "headline": "Professionellt stöd kring digital annonsering och SEO",
  "adText": "Är det dags för ett omtag kring företagets digitala annonsering eller SEO?...",
  "detailPageUrl": "https://www.linkedin.com/ad-library/detail/1230248844",
  "imageUrl": "https://media.licdn.com/dms/image/...",
  "logoUrl": "https://media.licdn.com/dms/image/...",
  "ctaText": "View details",
  "externalLinksInText": [],
  "scrapedAt": "2026-03-21T20:21:24.677Z",
  "detail": {
    "adType": "Single Image Ad",
    "advertiserName": "Nivide",
    "advertiserProfileUrl": "https://www.linkedin.com/company/5275721",
    "paidForBy": "Nivide AB",
    "adRunDatesRaw": "Ran from Mar 15, 2026 to Mar 21, 2026",
    "adStartDate": "Mar 15, 2026",
    "adEndDate": "Mar 21, 2026",
    "adStatus": "INACTIVE",
    "totalImpressions": "< 1k",
    "impressionsByCountry": [
      {
        "country": "Sweden",
        "impressionPercent": "100%",
        "progressValue": 100
      }
    ],
    "targetingLanguage": "Targeting includes svenska",
    "targetingLocation": "Targeting includes Sverige",
    "targetingParameters": [
      { "category": "Audience", "hasInclusion": false, "hasExclusion": false, "targetingType": "NONE" },
      { "category": "Demographic", "hasInclusion": false, "hasExclusion": false, "targetingType": "NONE" },
      { "category": "Company", "hasInclusion": true, "hasExclusion": true, "targetingType": "BOTH" },
      { "category": "Education", "hasInclusion": false, "hasExclusion": false, "targetingType": "NONE" },
      { "category": "Job", "hasInclusion": true, "hasExclusion": true, "targetingType": "BOTH" },
      { "category": "Member Interests and Traits", "hasInclusion": false, "hasExclusion": false, "targetingType": "NONE" }
    ],
    "creativeType": "SPONSORED_STATUS_UPDATE",
    "fullAdText": "Är det dags för ett omtag kring företagets digitala annonsering eller SEO?...",
    "headlineText": "Professionellt stöd kring digital annonsering och SEO",
    "destinationUrl": "https://nivide.se?trk=ad_library_ad_preview_headline_content",
    "ctaButtonText": "Läs mer",
    "advertiserLogoUrl": "https://media.licdn.com/dms/image/...",
    "imageUrl": "https://media.licdn.com/dms/image/...",
    "videoUrls": [],
    "videoPosterUrl": null
  }
}

Output Fields Reference

Standard Fields (always present)

Detail Fields (when fetchAdDetail: true)

📊 Pre-Configured Data Views

1. 📢 Overview

Quick summary of all ads with essential information.

Fields: Ad image, ID, advertiser, bio, creative type, headline, ad text, CTA, LinkedIn URL

2. 📋 Detailed View

Complete ad information including external links, timestamps, and enriched detail data.

Fields: All standard fields + detail fields (impressions, targeting, dates, video URLs)

3. 🏢 Advertisers

Ads grouped by advertiser/company.

Fields: Logo, company name, bio, ad ID, headline, creative type, URL

4. 🎨 Creative Analysis

Focus on ad creatives and content.

Fields: Creative image, ID, advertiser, bio, type, headline, body text, CTA

⚙️ More Examples

Full Filters with Impressions and Targeting

{
  "searches": [
    {
      "keyword": "sony",
      "countries": ["DZ"],
      "impressionsMinValue": 5,
      "impressionsMinUnit": "none",
      "impressionsMaxValue": 123456789,
      "impressionsMaxUnit": "none",
      "includedTargetingFacetCategories": ["LANGUAGE", "AUDIENCE", "JOB"],
      "excludedTargetingFacetCategories": ["LOCATION", "COMPANY"],
      "sortOrder": "ASCENDING"
    }
  ],
  "maxResults": 50
}

Multiple URLs with Detail Enrichment

{
  "urls": [
    { "url": "https://www.linkedin.com/ad-library/search?keyword=apify&countries=US%2CGB" },
    { "url": "https://www.linkedin.com/ad-library/search?accountOwner=nivide&payer=nivide" }
  ],
  "fetchAdDetail": true,
  "maxResults": 20
}

Competitor Research Across Regions

{
  "searches": [
    { "keyword": "web scraping", "accountOwner": "ParseHub", "countries": ["US"] },
    { "keyword": "data extraction", "accountOwner": "Octoparse", "countries": ["GB"] },
    { "keyword": "automation", "accountOwner": "Apify", "payer": "Apify Technologies s.r.o.", "countries": ["CA"] }
  ],
  "dateOption": "last-30-days",
  "fetchAdDetail": true,
  "maxResults": 50
}

Three independent searches, each scoped to its own company and region. Total: 3 × 50 = 150 max results.

Seasonal Campaign Analysis (Unlimited)

{
  "searches": [
    {
      "keyword": "black friday",
      "dateOption": "custom-date-range",
      "startDate": "2025-11-01",
      "endDate": "2025-11-30"
    }
  ],
  "maxResults": 0
}

📈 Performance

Without fetchAdDetail

• Page (10 ads) — a few seconds
• 100 Ads — well under a minute
• 1000 Ads — a few minutes

With fetchAdDetail Enabled

Enabling detail enrichment fires one extra request per ad, so expect runs to take longer — typically a few minutes per 100 ads depending on retry rate.

Resource Usage

• Memory — 256MB minimum, 512MB recommended
• Network — Moderate bandwidth (higher with fetchAdDetail)

⚠️ Important Notes

Legal Considerations

This actor extracts publicly available data from LinkedIn's Ad Library. Users must:

• Comply with LinkedIn's Terms of Service
• Respect robots.txt directives
• Follow applicable data protection laws (GDPR, CCPA, etc.)
• Use data responsibly and ethically

The actor creator is not responsible for how users utilize the extracted data.

Data Accuracy

• Data is extracted as-is from LinkedIn Ad Library
• Ad availability may change between scraping sessions
• Some fields may be null if not present in the ad
• The detail object depends on the detail page layout — if LinkedIn changes it, some fields may return null
• Video URLs include all quality variants with bitrate info

Searches & Validation

• Only linkedin.com/ad-library URLs are accepted — other URLs are rejected before the run starts
• Each search must include at least one of Company, Payer, or Keyword; searches missing all three are skipped automatically, and the rest of the run continues

💬 Support & Contact

Get Help

• 🌐 Website: flowextractapi.com
• 📧 Email: [email protected]
• 🙋 Apify Profile: FlowExtract API
• 💬 GitHub Issues: FlowExtractAPI

Social Media

• 💼 LinkedIn: flowextract-api
• 🐦 Twitter: @FlowExtractAPI
• 📱 Facebook: flowextractapi

🌟 Related Actors by FlowExtract API

🎬 Video & Media Tools

YouTube Transcript & Metadata Extractor Extract complete video transcripts with timestamps and comprehensive metadata.

YouTube Full Channel, Playlists, Shorts, Live Extract complete playlist information with all video details from any YouTube playlist.

Zoom Scraper | 🎥 Downloader & 📄 Transcript Extract Zoom meeting recordings, transcripts, and metadata.

Loom Scraper | 🎥 Downloader & 📄 Transcript Download Loom videos and extract transcripts.

🏠 Real Estate Data

PropertyFinder Scraper Extract real estate property listings from PropertyFinder across UAE, Saudi Arabia, Bahrain, Egypt, and Qatar.

Idealista Scraper API Advanced Idealista property data extraction with API access.

Idealista Scraper Extract Spanish real estate listings from Idealista.

🛠️ Developer & Security Tools

Screenshot Fast, reliable webpage screenshots with customizable options.

Ultimate Screenshot Advanced screenshot tool with full-page capture, custom viewports, and quality controls.

Network Security Scanner Scan websites for security vulnerabilities and get comprehensive security reports.

📱 Social Media Tools

Facebook Ads Scraper Pro Extract Facebook ads data for competitor analysis and market research.

AI Contact Intelligence Extractor Extract emails, phones, contacts & custom data using AI.

Ready to extract LinkedIn ad data? Start using LinkedIn Ad Library Scraper now!