📢 LinkedIn Ads Scraper

💡 A powerful scraper to extract advertising data from the LinkedIn Ads Library, providing comprehensive insights into LinkedIn advertising campaigns

Extract detailed advertising data from LinkedIn's Ad Library with this reliable scraping solution! Get structured data about ads, including advertiser information, campaign details, targeting, and performance metrics. Perfect for market research, competitor analysis, and advertising insights.

✨ What You'll Get

💎 Key Features

• Precise calculation of impressions by country
• Standardized date format (MM/DD/YYYY)
• Automatic timestamp conversion
• Hierarchical data organization
• URL cleaning and normalization

📊 Available Data

• Ad details and content
• Advertiser information
• Campaign dates and performance
• Targeting information
• Impression statistics by country
• Ad media (images, videos)
• Campaign URLs and links

Data Structure Details

Field	Type	Description
adID	int	Unique ad identifier
advertiserName	string	Name of the advertiser
advertiserLogo	string	URL of advertiser's logo
adImage	string	URL of ad creative
adDate	array	Ad run dates
adType	string	Type of advertisement
adDateTimestamps	array	Unix timestamps of run dates
adDescription	string	Ad copy text
adHashtags	array	Hashtags used in ad
adTotalImpressions	string	Total impression range
adImpressionsCountry	array	Impressions breakdown by country
adUrl	string	Ad detail page URL
adLinkUrl	string	Advertisement destination URL
adPaidBy	string	Entity paying for the ad
adTargeting	array	Targeting parameters used

🚀 Performance Features

⚡️ Lightning Fast:

• Parallel processing of ad pages
• Optimized batch processing
• Smart proxy handling
• Efficient URL cleaning and resolving

🛠️ Smart Handling:

• Proxy support
• Dynamic content extraction
• Automatic pagination
• Robust error recovery
• Multiple ad format support

🎯 Coverage:

• All ad types supported

📋 Quick Start

Input Parameters

Parameter	Type	Default	Description
searchUrl	string	required	LinkedIn Ads Library search URL
maxItems	integer	20	Maximum number of ads to scrape
proxyType	string	RESIDENTIAL	Type of proxy to use

Input

1{
2    "searchUrl": "https://www.linkedin.com/ad-library/search?keyword=renergy",
3    "maxItems": 20,
4    "proxyType": "RESIDENTIAL"
5}

Output Example

1{
2    "adId": "123456789",
3    "advertiserName": "Example Company",
4    "advertiserLogo": "https://example.com/logo.jpg",
5    "adImage": "https://example.com/ad.jpg",
6    "adDate": [
7        {"start": "02/01/2024"},
8        {"end": "02/28/2024"}
9    ],
10    "adDateTimestamps": {
11        "start": 1706745600000,
12        "end": 1709251200000
13    },
14    "adType": "Ad Single",
15    "adDescription": "Join our team of experts! We're looking for talented professionals to drive innovation and growth. Click to learn more about our exciting opportunities.",
16    "adHashtags": ["hiring", "jobs", "careers", "recruitment"],
17    "adTotalImpressions": "10k-15k",
18    "adImpressionsCountry": {
19        "France": {
20            "percentage": "45%",
21            "estimatedImpressions": {
22                "min": 4500,
23                "max": 6750
24            }
25        },
26        "Belgium": {
27            "percentage": "30%",
28            "estimatedImpressions": {
29                "min": 3000,
30                "max": 4500
31            }
32        },
33        "Switzerland": {
34            "percentage": "25%",
35            "estimatedImpressions": {
36                "min": 2500,
37                "max": 3750
38            }
39        }
40    },
41    "adUrl": "https://linkedin.com/ad-library/ad/123456789",
42    "adLinkUrl": "https://example.com/careers?utm_source=linkedin",
43    "adPaidBy": "Example Company Global Services",
44    "adTargeting": {
45        "language": [
46            "French",
47            "English"
48        ],
49        "location": [
50            "France",
51            "Belgium",
52            "Switzerland"
53        ],
54        "company": "Companies with 1000+ employees in Technology sector"
55    }

🔒 Reliability & Performance

Data Quality

• Structured ad content extraction
• Clean URL processing
• Consistent date formatting
• Reliable impression data
• Comprehensive targeting information

Technical Robustness

• Proxy rotation support
• Automatic retry mechanism
• Smart error handling
• Rate limiting compliance
• Session management

Performance Optimization

• Parallel request processing
• Efficient memory usage
• Smart batch processing
• Optimized content parsing

🤝 Support

• Need assistance? We're here to help!
• Open an issue for feature requests
• Technical support available
• Regular updates and maintenance

📝 Notes

• Respects LinkedIn's terms of service
• Data is from public Ad Library
• Use responsibly and ethically