LinkedIn Ads Library Scraper

Scrape active LinkedIn ads with search URLs, filtering by company, country, and date.

---

Overview

This actor scrapes the LinkedIn Ad Library to extract detailed information about active B2B advertising campaigns. Ideal for marketers, competitors, and researchers analyzing ad strategies. Support extracting generic preview cards, as well as deeply crawling ad details for CTA buttons, click URLs, and raw media sources.

---

Features

• Flexible URL Input: Supports direct search URLs generated from the LinkedIn Ad Library frontend.
• Pagination Support: Automatically clicks through and loads all pagination fragment tokens.
• Deep Detail Scraping Option: Optional scrapeAdDetails flag to navigate inside every single ad and pull extended profiles (CTAs, Advertiser URLs, Document/Video Sources).
• Proxy Support: Works well with residential proxies to bypass LinkedIn rate limits.
• Concurrent Processing: Process multiple generic ad results safely using Crawlee.

---

How to Use

1. Configure Input: Set your search URL in the input JSON (see configuration below).
2. Run via Apify: Execute the actor on Apify platform.
3. Export Data: Download results as JSON, CSV, or Excel.
4. Analyze: Track ad creatives, sponsors, and run dates.

---

Input Configuration

Example: Using LinkedIn Ads Library URLs

{
    "startUrls": [
        "https://www.linkedin.com/ad-library/search?accountOwner=nvidia&countries=BR&dateOption=last-30-days"
    ],
    "scrapeAdDetails": true,
    "maxItems": 100,
    "minDelay": 5,
    "maxDelay": 10,
    "proxy": {
         "useApifyProxy": false,
         "proxyUrls": ["http://YOUR_PROXY_URL"]
    }
}

Supported URL Formats

The scraper accepts multiple types of LinkedIn URLs out of the box:

1. Advanced Search URLs

https://www.linkedin.com/ad-library/search?accountOwner=JetBrains
https://www.linkedin.com/ad-library/search?keyword=jetbrains
https://www.linkedin.com/ad-library/search?keyword=jetbrains&countries=FI&dateOption=current-year

How it works:

• Routes directly to the list crawler.
• Extracts all active ad cards matching the specific query combinations.
• Clicks through pagination automatically.
• Conditionally crawls individual ad links internally if scrapeAdDetails: true.

2. Direct Ad Detail URLs

https://www.linkedin.com/ad-library/detail/349389913

How it works:

• Automatically bypasses the visual grid.
• Pulls base advertiser details natively mapped to the direct detail ID.

---

Input Parameters

Parameter	Type	Description	Default
startUrls	Array	LinkedIn Ad Library Search URLs	Required
scrapeAdDetails	Boolean	Whether to perform deep extraction of additional properties (CTAs, media URLs). Slower but more detailed.	true
maxItems	Integer	Max ads to scrape per run	100
minDelay	Integer	Minimum delay (seconds) between requests	5
maxDelay	Integer	Maximum delay (seconds) between requests	10
maxRequestRetries	Integer	Retry attempts for failed requests	60
proxy	Object	Proxy configuration setup	Required (often Residentials)

---

Output Structure

Here is a sample extracted object when scrapeAdDetails is enabled:

{
  "adId": "1173514613",
  "adLibraryUrl": "https://www.linkedin.com/ad-library/detail/1173514613",
  "advertiserName": "NVIDIA Brasil",
  "advertiserLogo": "https://media.licdn.com/dms/image/v2/...",
  "body": "você sabI.A. que já é possível agentes de IA estimularem a tomada de decisões mais inteligentes entre as equipes?\nSaiba mais acessando nosso blog: https://nvda.ws/4bRCRLZ\n\n#NVIDIABrasil #vocesabIA #agentesdeia",
  "format": "SINGLE_IMAGE",
  "startUrl": "https://www.linkedin.com/ad-library/search?accountOwner=nvidia&countries=BR&dateOption=last-30-days",
  "imageUrl": "https://media.licdn.com/dms/image/v2/...",
  "paidBy": "NAÇÃO DIGITALSOLUTIONS LTDA",
  "advertiserUrl": "https://www.linkedin.com/company/40981439",
  "ctas": []
}

Basic Ad Information

Field	Type	Description
adId	String	LinkedIn's internal identifier for the advertisement
adLibraryUrl	String	Direct URL to access this ad inside the Ad Library
advertiserName	String	Profile/Company name of the advertiser running the ad
advertiserLogo	String	URL to the profile picture/logo of the advertising company
startUrl	String	The exact search URL from where this ad was discovered

---

Ad Delivery & Content

Field	Type	Description
format	String	Enum depicting the style constraint (e.g. SINGLE_IMAGE, VIDEO, DOCUMENT, CAROUSEL)
body	String	Full text body/caption of the LinkedIn advertisement post
imageUrl	String	Direct link to the image creative (only present if 1 image is used)
imageUrls	Array	Array of direct image links (presents mostly for carousels or documents)
videoUrl	String	Direct raw .mp4 link to the highest quality video source (only available if scrapeAdDetails=true & format is VIDEO)
documentUrl	String	Direct manifest link to the PDF attachment data (only available if scrapeAdDetails=true & format is DOCUMENT)

---

Deep Specifics (Requires scrapeAdDetails=true)

Field	Type	Description
paidBy	String	Legal entity legally marked as financing the campaign
advertiserUrl	String	Official LinkedIn page URL for the advertiser
ctas	Array	List of text representations of Call-To-Action buttons, sometimes empty []
headline	String	The bold, bottom structural headline text (if placed by the advertiser)
clickUrl	String	Destination external URL that native users would go to

---

Key Notes

1. Dynamic Render Extraction: Certain fields like raw video MP4s and hidden Document manifests are specifically extracted out of hidden DOM configs and <iframe> networks.
2. Missing Properties: Due to the varied structures of LinkedIn ads (Video vs Documents vs Text-Only), properties like videoUrl or documentUrl will not exist on every object!
3. Empty arrays: Many Single Image ads do not utilize ctas buttons or formal headline structures, resulting in empty arrays or missing properties accurately representing the ad.

---

Explore More Scrapers

If you found this Apify Scraper useful, be sure to check out our other powerful scrapers and actors at memo23's Apify profile. We offer a wide range of tools to enhance your web scraping and automation needs across various platforms and use cases.

Support

• For issues or feature requests, please use the Issues section of this actor.
• If you need customization or have questions, feel free to contact the author:
  • Author's website: https://muhamed-didovic.github.io/
  • Email: muhamed.didovic@gmail.com

Additional Services

• Request customization or whole dataset: muhamed.didovic@gmail.com
• If you need anything else scraped, or this actor customized, email: muhamed.didovic@gmail.com
• For API services of this scraper (no Apify fee, just usage fee for the API), contact: muhamed.didovic@gmail.com
• Email: muhamed.didovic@gmail.com