📢 LinkedIn Ad Library Scraper

Extract comprehensive advertising data from LinkedIn's Ad Library with automatic pagination and filtering.

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

---

🌟 Key Features

🎯 Comprehensive Ad Data Extraction

• Ad Creatives - Images, videos, and carousel content
• Ad Copy - Headlines, body text, and descriptions
• Advertiser Information - Company names, logos, and bio/subtitle text
• Call-to-Action - CTA button text and links
• External Links - URLs mentioned in ad text
• Metadata - Ad IDs, creative types, and timestamps

⚡ Performance & Reliability

• Smart Pagination - Automatically handles multi-page results
• Keyword Search - Search by keywords or account owners
• Date Filtering - Filter ads by time periods
• Country Filtering - Target specific geographic regions
• Rate Limiting - Built-in delays to prevent blocking
• Retry Logic - Exponential backoff with 3 retry attempts
• Proxy Support - Optional Apify Proxy integration

🎯 Flexible Configuration

• Multiple Keywords - Process multiple search terms in one run
• Account Owners - Filter by specific advertisers
• Result Limits - Control maximum results (or scrape all)
• Custom Date Ranges - Search specific time periods
• Multi-Country - Search ads from multiple countries

---

🚀 Quick Start

Basic Usage

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

Advanced Configuration

{
  "keyword": ["saas", "marketing automation"],
  "accountOwner": ["Apify", "HubSpot"],
  "countries": ["US", "GB", "CA"],
  "dateOption": "last-30-days",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

---

📋 Input Configuration

Input Parameters

Parameter	Type	Required	Default	Description
keyword	array	❌ No	-	Keywords to search in Ad Library
accountOwner	array	❌ No	-	Filter by advertiser account names
countries	array	❌ No	All	Country codes (e.g., US, GB, CA)
maxResults	integer	❌ No	50	Maximum ads to scrape (0 = unlimited)
dateOption	string	❌ No	-	Date filter (last-30-days, current-year, etc.)
startDate	string	❌ No	-	Custom start date (YYYY-MM-DD)
endDate	string	❌ No	-	Custom end date (YYYY-MM-DD)
proxyConfiguration	object	❌ No	-	Apify proxy settings

Input Schema Details

keyword

Array of keywords to search for in LinkedIn Ad Library.

Example:

{
  "keyword": ["apify", "web scraping", "automation"]
}

accountOwner

Filter ads by specific advertiser names (optional).

Example:

{
  "accountOwner": ["Apify", "Microsoft", "Google"]
}

countries

Array of country codes to filter ads by geographic targeting.

Example:

{
  "countries": ["US", "GB", "CA", "AU"]
}

Date Filtering Options

Predefined Options:

• last-30-days - Last 30 days
• current-month - Current month
• current-year - Current year
• last-year - Previous year
• custom-date-range - Custom date range (requires startDate and endDate)

Custom Date Range:

{
  "dateOption": "custom-date-range",
  "startDate": "2024-01-01",
  "endDate": "2024-12-31"
}

proxyConfiguration

Optional proxy settings for improved reliability:

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

---

📤 Output Structure

Ad Data Format

{
  "adId": "894398854",
  "advertiserName": "Apify",
  "advertiserBio": "CEO at Apify | Helping people get more value from the web",
  "isPromoted": true,
  "creativeType": "SPONSORED_STATUS_UPDATE",
  "headline": "$1M in prizes for tools AI needs. The frontier is open for builders.",
  "adText": "Companies deploying AI hit walls. Tools don't exist yet. That's your opportunity. Build on Apify, win your share.",
  "detailPageUrl": "https://www.linkedin.com/ad-library/detail/894398854",
  "imageUrl": "https://media.licdn.com/dms/image/v2/D4E10AQH0zRaEVZ_APg/...",
  "logoUrl": "https://media.licdn.com/dms/image/v2/D4E0BAQHAN7DZIQRKSw/...",
  "ctaText": "View details",
  "externalLinksInText": [],
  "scrapedAt": "2025-12-03T00:55:56.066Z"
}

Output Fields Explained

Ad Identification

• adId - Unique LinkedIn ad identifier
• advertiserName - Company/advertiser name
• advertiserBio - Advertiser bio/subtitle text (e.g., job title, company description, headline)
• isPromoted - Whether ad is promoted
• creativeType - Type of ad creative (SPONSORED_STATUS_UPDATE, etc.)

Ad Content

• headline - Ad headline text
• adText - Main ad body text/description
• ctaText - Call-to-action button text

Visual Assets

• imageUrl - URL of ad creative image
• logoUrl - URL of advertiser's logo

Additional Data

• detailPageUrl - LinkedIn URL to ad detail page
• externalLinksInText - Array of external URLs found in ad text
• scrapedAt - ISO 8601 timestamp when ad was scraped

---

📊 Pre-Configured Data Views

1. 📢 Overview

Quick summary of all ads with essential information including advertiser bio.

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

Use Case: Initial ad review and filtering

2. 📋 Detailed View

Complete ad information including external links, timestamps, and advertiser bio.

Fields: All ad data including images, logos, bio, external links, scrape timestamps

Use Case: In-depth ad analysis and competitive research

3. 🏢 Advertisers

Ads grouped by advertiser/company with bio information.

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

Use Case: Track specific advertisers, competitor monitoring

4. 🎨 Creative Analysis

Focus on ad creatives and content including advertiser bio.

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

Use Case: Creative inspiration, copywriting research, A/B testing ideas

---

💡 Use Cases

📊 Competitive Intelligence

• Competitor Ad Tracking - Monitor competitor ad campaigns and positioning
• Creative Research - Analyze successful ad creatives and messaging
• Messaging Analysis - Study competitor positioning, bio descriptions, and messaging
• Budget Estimation - Track ad volume and frequency by advertiser

🎯 Marketing & Advertising

• Creative Inspiration - Find ideas for your own campaigns
• Copy Research - Study effective headlines and ad text
• Bio & Description Ideas - Analyze how advertisers describe themselves
• CTA Analysis - Discover compelling call-to-action approaches
• Trend Monitoring - Track advertising trends in your industry

📈 Market Research

• Industry Analysis - Study advertising patterns by sector
• Brand Monitoring - Track brand advertising activity and positioning
• Geographic Insights - Analyze regional advertising differences
• Seasonal Patterns - Identify seasonal advertising trends
• Advertiser Positioning - Understand how companies present themselves

🤖 Automation & Integration

• Ad Monitoring Alerts - Get notified of new competitor ads
• Database Building - Create comprehensive ad databases with advertiser profiles
• API Integration - Feed data into your own systems
• Reporting Automation - Generate regular competitive reports

---

⚙️ Advanced Configuration

Multi-Keyword Search

Search for multiple keywords in one run:

{
  "keyword": [
    "web scraping",
    "data extraction",
    "api integration",
    "automation tools"
  ],
  "maxResults": 200
}

This will scrape up to 200 ads total across all keywords.

Account Owner Filtering

Track specific advertisers:

{
  "keyword": ["marketing automation"],
  "accountOwner": ["HubSpot", "Salesforce", "Marketo"],
  "maxResults": 0
}

Date Range Analysis

Analyze ads from specific time periods:

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

Geographic Targeting

Focus on specific countries:

{
  "keyword": ["fintech"],
  "countries": ["US", "GB", "SG", "HK"],
  "maxResults": 500
}

Using Proxies for Scale

For reliable large-scale scraping:

{
  "keyword": ["saas"],
  "maxResults": 1000,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

---

📈 Performance Metrics

Scraping Speed

• Single Ad - ~0.2 seconds
• Page (10 ads) - ~2-3 seconds (including delay)
• 100 Ads - ~30-40 seconds
• 1000 Ads - ~5-7 minutes

Resource Usage

• Memory - 256MB minimum, 2048MB maximum
• CPU - Low to moderate usage
• Network - Moderate bandwidth usage

---

⚠️ 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
• External links are extracted from ad text content
• Advertiser bio reflects current LinkedIn profile information

Rate Limiting

• Built-in 2-second delays between pages
• Retry logic handles temporary failures
• Proxy usage recommended for large-scale operations
• LinkedIn may implement rate limiting

Updates & Maintenance

LinkedIn may update their Ad Library structure. If the actor stops working:

1. Check for actor updates on Apify
2. Report issues via GitHub or Apify support
3. Monitor actor changelog for fixes

---

📚 Additional Resources

Sample Searches

General Keyword:

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

Competitor Research:

{
  "keyword": ["web scraping"],
  "accountOwner": ["ParseHub", "Octoparse", "Apify"],
  "dateOption": "last-30-days"
}

Industry Analysis:

{
  "keyword": ["marketing automation", "crm software"],
  "countries": ["US", "GB", "CA"],
  "maxResults": 500
}

Seasonal Campaign:

{
  "keyword": ["christmas", "holiday sale"],
  "dateOption": "custom-date-range",
  "startDate": "2024-12-01",
  "endDate": "2024-12-25"
}

---

💬 Support & Contact

Need help or have questions? We're here for you:

• 📧 Email: fridaytechnolog@gmail.com
• 🙋 GitHub: DZ-ABDLHAKIM
• 🐦 Twitter: @DZ_45Omar
• 📧 Apify Profile: dz_omar

---

🌟 Related Actors by DZ_OMAR

🎬 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!