LinkedIn Ad Library Scraper

The Actor searches LinkedIn Ad Library records by advertiser, paying entity, creative keyword, country, date range, or impression range; it can also retrieve the detail record from a LinkedIn Ad Library detail URL. Search results are paginated until maxItems is reached or the source has no further page.

Search records contain ad_id, ad_url, thumbnail, and is_video. A detail lookup, or the optional enrichAdDetails step on a search, can add ad_format, advertiser, advertiser_company_id, advertiser_logo, paid_for_by, run_dates, creative_body, creative_headline, creative_image, and total_impressions. Fields that are not present for an ad are returned as null.

Choosing the workflow

scraperType selects one of two workflows:

• adsSearch searches the Ad Library. At least one search filter is required. maxItems defaults to 50; 0 removes that item limit.
• adDetail retrieves one record from the LinkedIn Ad Library detail URL. The legacy ad_id input also accepts a numeric identifier for existing integrations. Search filters, maxItems, and enrichAdDetails do not apply to this workflow.

The following search retrieves up to 20 cloud-related ads served in the United States and adds details for every saved record:

{
  "scraperType": "adsSearch",
  "keyword": "cloud",
  "countries": "US",
  "maxItems": 20,
  "enrichAdDetails": true
}

Paste a detail URL for a direct-detail run:

{
  "scraperType": "adDetail",
  "ad_id": "https://www.linkedin.com/ad-library/detail/1532791186"
}

A live direct-detail response returned this subset:

{
  "ad_id": "1532791186",
  "ad_format": "Single Image Ad",
  "advertiser": "Runpod",
  "advertiser_company_id": "80190603",
  "paid_for_by": "Runpod",
  "run_dates": null,
  "creative_headline": "Deploy AI systems on reliable GPU infrastructure.",
  "total_impressions": null
}

A separate search response for the same ad included ad_url as https://www.linkedin.com/ad-library/detail/1532791186, a thumbnail URL, and is_video: false. total_impressions is present only when LinkedIn provides an impression range. ad_details_enriched appears only for search records whose optional detail request succeeded. The add-on is charged only for those successful detail requests.

Search filters and boundaries

account_owner and company_name are separate LinkedIn Ad Library filters. payer matches the entity named in the ad's Paid for by disclosure; keyword matches creative text. countries accepts one ISO 3166-1 alpha-2 code per run, such as US.

date_option accepts last-30-days, current-month, current-year, last-year, or custom-date-range. A custom range requires both startdate and enddate in YYYY-MM-DD form, and the start date cannot be later than the end date. Dates cannot be supplied with another date option.

Each impression boundary is a value-and-unit pair: impressions_min_value with impressions_min_unit, and impressions_max_value with impressions_max_unit. Units are none, thousand, and million. When both boundaries are set, the minimum cannot exceed the maximum.

Related Actors

LinkedIn Company Scraper retrieves public company-page data when the required output is company context rather than an advertising record. LinkedIn Post Scraper retrieves a known public post, activity, or article when organic post text and reactions are required.