Ad libraries
LinkedIn Ads Library API
Search LinkedIn ads and retrieve creative and transparency details.
Find public campaigns by advertiser or keyword, continue through results and inspect creatives, messages and published targeting and impression ranges.
API availability: Available
http://localhost:3029Public API: https://api.scrapeatlas.com.Endpoints
/v1/linkedin/ads/searchSearch ads
Search one page by company, payer, keyword, company ID, countries, date preset or date pair, impression range and targeting facets, sorted newest or oldest first. Each card is enriched from its detail page. Pass the returned token with the same filters for continuation. Individual source failures are explicit partial results.
Reference/v1/linkedin/adAd details
Retrieve a public ad by exact ID or canonical URL. Includes creative media, payer, advertiser, disclosed targeting, dates and impressions. Image, video, carousel, messages, InMail, article and event creatives have dedicated extraction; native documents expose their previews, and other formats are reported with partial coverage.
Reference/v1/linkedin/ad-library/ads/searchUnified ad search
Search one page by company, payer, keyword, company ID, countries, date preset or date pair, impression range and targeting facets, sorted newest or oldest first. Each card is enriched from its detail page. Pass the returned token with the same filters for continuation. Individual source failures are explicit partial results.
Reference/v1/linkedin/ad-library/adsUnified ad details
Retrieve a public ad by exact ID or canonical URL. Includes creative media, payer, advertiser, disclosed targeting, dates and impressions. Image, video, carousel, messages, InMail, article and event creatives have dedicated extraction; native documents expose their previews, and other formats are reported with partial coverage.
ReferenceQuick start
Create an API key on your account page, then call the public API. Values below are placeholders.
curl "https://api.scrapeatlas.com/v1/linkedin/ads/search?company=microsoft" \
-H "x-api-key: YOUR_API_KEY"Coverage & limits
- Two active operations; 45-second deadline; 26 upstream attempts with one shared transient retry.
- Up to six detail pages are read side by side. Impression bounds are given as a pair (minImpressions and maxImpressions); a date preset and a date pair are alternatives.
- 24 ads per source page; 12 MiB total decoded browser responses, 2 MiB per HTML page, 60,000 DOM nodes and depth 80.
- Plain HTTPS reads with a browser TLS profile; a headed Chromium (Xvfb on Linux) is used only when a read is challenged. Optional residential proxy pools. No account, storage, media downloads or consumer runtime.
- Image, video, carousel, message, InMail, article and event details supported. Native documents expose their previews. Other formats and multiple variants are reported with partial coverage.
- targetingDetails preserves additional flags and normalizes whitespace; range impressions remain labels.
- Upstream challenges and throttling are explicit; successful cards are returned with failedAds when enrichment is partial.
| HTTP | failure.code | Meaning |
|---|---|---|
| 400 | invalid_request | Invalid, duplicate, unknown or conflicting inputs. |
| 401 | unauthorized | Missing or incorrect service key. |
| 403 | restricted_page | The source restricts this ad. |
| 404 | not_found | Missing ad or route. |
| 429 | upstream_rate_limited | Source throttling. |
| 502 | upstream_challenged unsupported_page | Challenge, unsupported markup or identity mismatch. |
| 502 | upstream_error unsafe_redirect response_too_large payload_too_complex request_limit | Bounded source failure. |
| 503 | busy | Worker capacity reached. |
| 504 | timeout | Request deadline elapsed. |
| 200 | partial | Unavailable details, other creative formats or additional variants. |
