# LinkedIn Ad Library API
Scrape Ad Library data from LinkedIn easily with LinkedIn Ad Library API.
## About
LinkedIn is a business and employment-focused social media platform that works through websites and mobile apps. It was launched on May 5, 2003 by Reid Hoffman and Eric Ly. Since December 2016, LinkedIn has been a wholly owned subsidiary of Microsoft. The platform is primarily used for professional networking and career development, and allows jobseekers to post their CVs and employers to post jobs. From 2015, most of the company's revenue came from selling access to information about its members to recruiters and sales professionals. LinkedIn has more than 1 billion registered members from over 200 countries and territories.
## Why should you use it?
It provides a structured way to access LinkedIn Ad Library data, enabling easy processing without the need for login credentials or session cookies.
## Supported Ad Types
* **SINGLE_IMAGE_AD**
* **VIDEO_AD**
* **DOCUMENT_AD**
* **TEXT_AD**
* **SPOTLIGHT_AD**
* **CAROUSEL_AD**
* **FOLLOW_COMPANY_AD**
* **JOB_AD**
* **LINKEDIN_ARTICLE_AD**
* **EVENT_AD**
* **MESSAGE_AD**
## How to use
### Get by ID
To use this endpoint you need to supply ad ID. Usually you find ad that you are interested in. URL could look like this: `https://www.linkedin.com/ad-library/detail/971486723`. In this case ID is `971486723`.
Service will return response in this format:
```json
{
"id": 1001277563,
"url": "https://www.linkedin.com/ad-library/detail/1001277563",
"format": "VIDEO_AD",
"advertiser": {
"name": "JN",
"url": "https://www.linkedin.com/company/1211515?trk=ad_library_ad_preview_advertiser",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAfasdQFIxLcCtbdBEw/company-logo_100_100/company-logo_100_100/0/17151123703491195/jetbrains_logo?e=17663213620800&v=beta&t=XDs3I_n1d7H-OVKK04h_LdRL_-9vWNsxaweWD9euBm9Zw"
},
"title": "Junie,",
"body": "Trusted and reliable AI agent",
"buttons": [
"Learn more"
],
"impressions": [
{
"country": "Poland",
"impressions": "10000-50000",
"estimatedMin": 10000,
"estimatedMax": 50000
},
{
"country": "Belarus",
"impressions": "100-500",
"estimatedMin": 100,
"estimatedMax": 500
},
{
"country": "Brazil",
"impressions": "100-500",
"estimatedMin": 100,
"estimatedMax": 500
},
{
"country": "Switzerland",
"impressions": "100-500",
"estimatedMin": 100,
"estimatedMax": 500
}
],
"totalImpression": {
"raw": "10k-50k",
"estimatedMin": 10000,
"estimatedMax": 50000
},
"period": {
"start": "2025-10-20",
"end": "2025-11-10"
},
"targetingSettings": [
{
"target": "Language",
"value": "Targeting includes English"
},
{
"target": "Location",
"value": "Targeting includes Poland"
},
{
"target": "Audience",
"value": "Exclusion targeting applied"
}
],
"imageUrls": [],
"videoUrls": [
"https://dms.licdn.com/playlist/vid/v2/D4D10AdsfdsQEy0ZuHsvV-EA/mp4-360p-30fp-crf28/B4DZoBk.alKQCQ-/0/176096303268879/JB_External_Main_Video_ENG_subsmp4?e=214748323647&v=beta&t=dwvnJP6GrPI6r9Ufsda9bZSyRePWdr9f_xkHt0fdsafgTKE2gcOk"
],
"paidBy": "JN",
"clickUrl": "https://www.jn.com/junie/t",
"event": null
}
```
### Get by URL
To use this endpoint you need to supply ad URL. Usually you find ad that you are interested in. URL could look like this: `https://www.linkedin.com/ad-library/detail/971486723`.
In this example request would look like this: `https://linkedin-ad-library-api2.p.rapidapi.com/ads/by-url?url=https%3A%2F%2Fwww.linkedin.com%2Fad-library%2Fdetail%2F971486723`
URL should be base64 encoded.
Service will return response in this format:
```json
{
"id": 1001277563,
"url": "https://www.linkedin.com/ad-library/detail/1001277563",
"format": "VIDEO_AD",
"advertiser": {
"name": "JN",
"url": "https://www.linkedin.com/company/1211515?trk=ad_library_ad_preview_advertiser",
"logo": "https://media.licdn.com/dms/image/v2/D4E0BAfasdQFIxLcCtbdBEw/company-logo_100_100/company-logo_100_100/0/17151123703491195/jetbrains_logo?e=17663213620800&v=beta&t=XDs3I_n1d7H-OVKK04h_LdRL_-9vWNsxaweWD9euBm9Zw"
},
"title": "Junie,",
"body": "Trusted and reliable AI agent",
"buttons": [
"Learn more"
],
"impressions": [
{
"country": "Poland",
"impressions": "10000-50000",
"estimatedMin": 10000,
"estimatedMax": 50000
},
{
"country": "Belarus",
"impressions": "100-500",
"estimatedMin": 100,
"estimatedMax": 500
},
{
"country": "Brazil",
"impressions": "100-500",
"estimatedMin": 100,
"estimatedMax": 500
},
{
"country": "Switzerland",
"impressions": "100-500",
"estimatedMin": 100,
"estimatedMax": 500
}
],
"totalImpression": {
"raw": "10k-50k",
"estimatedMin": 10000,
"estimatedMax": 50000
},
"period": {
"start": "2025-10-20",
"end": "2025-11-10"
},
"targetingSettings": [
{
"target": "Language",
"value": "Targeting includes English"
},
{
"target": "Location",
"value": "Targeting includes Poland"
},
{
"target": "Audience",
"value": "Exclusion targeting applied"
}
],
"imageUrls": [],
"videoUrls": [
"https://dms.licdn.com/playlist/vid/v2/D4D10AdsfdsQEy0ZuHsvV-EA/mp4-360p-30fp-crf28/B4DZoBk.alKQCQ-/0/176096303268879/JB_External_Main_Video_ENG_subsmp4?e=214748323647&v=beta&t=dwvnJP6GrPI6r9Ufsda9bZSyRePWdr9f_xkHt0fdsafgTKE2gcOk"
],
"paidBy": "JN",
"clickUrl": "https://www.jn.com/junie/t",
"event": null
}
```
### Search Ads
Search parameters:
* **keyword** - filter ads by given keyword. Either `keyword` or `accountOwner` is required.
* **accountOwner** - filter ads by account that owns ads. Either `keyword` or `accountOwner` is required
* **countries** - filter ads by country they are shown.
* **dateOption** - filter ads by dates when they were published
* **startDate** - filter ads that were shown from `startDate`. Used only if `dateOption` is `custom-date-range`
* **endDate** - filter ads that were shown before `endDate`. Used only if `dateOption` is `custom-date-range`
* **paginationToken** - pagination token for the next page. On first request `paginationToken` is not required. If user wants next page for given search criteria, it needs to supply `paginationToken`
Example response:
```json
{
"ads": [
{
"url": "https://www.linkedin.com/ad-library/detail/971486723"
},
{
"url": "https://www.linkedin.com/ad-library/detail/971602313"
},
{
"url": "https://www.linkedin.com/ad-library/detail/971602233"
},
{
"url": "https://www.linkedin.com/ad-library/detail/971654423"
},
{
"url": "https://www.linkedin.com/ad-library/detail/971572633"
}
],
"isLastPage": false,
"paginationToken": "97-1764"
}
```
Posible values for `countires`: "AD","AE","AF","AG","AI","AL","AM","AN","AO","AQ","AR","AS","AT","AU",
"AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BM","BN",
"BO","BR","BS","BT","BV","BW","BY","BZ","CA","CB","CC","CD","CF","CG",
"CH","CI","CK","CL","CM","CN","CO","CR","CS","CU","CV","CX","CY","CZ",
"DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI",
"FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL",
"GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR",
"HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM",
"JO","JP","KE","KG","KH","KI","KM","KN","KO","KP","KR","KW","KY","KZ",
"LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD",
"ME","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU",
"MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP",
"NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR",
"PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD",
"SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV",
"SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TP",
"TR","TT","TV","TW","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VG",
"VI","VN","VU","WF","WS","YE","YT","YU","ZA","ZM","ZW"
Possible values for `dateOption`:
* **last-30-days** - show only ads that were active in last 30 days
* **current-month** - show only ads that were active this month
* **current-year** - show only ads that were active in current year
* **last-year** - show only ads that were active in last year
* **custom-date-range** - use custom date range
-------
**100% GDPR compliant**. We don’t have any databases.
------------
**DISCLAIMER**: This API provider is not affiliated with LinkedIn in any way.