Skip to main content
GET
/
linkedin
/
ad-search
Search LinkedIn Ad Library
curl --request GET \
  --url https://api.harvest-api.com/linkedin/ad-search \
  --header 'X-API-Key: <api-key>'
{
  "elements": [
    "<unknown>"
  ],
  "pagination": {
    "totalPages": 123,
    "totalElements": 123,
    "pageNumber": 123,
    "previousElements": 123,
    "pageSize": 123,
    "paginationToken": "<string>"
  },
  "status": "<string>",
  "error": "<string>",
  "query": {
    "search": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.harvest-api.com/llms.txt

Use this file to discover all available pages before exploring further.

Scrape LinkedIn Ad Library Search to find ads based on various criteria such as keywords, account owners, countries, and date ranges. 
const params = new URLSearchParams({
  keyword: 'sales',
  accountOwner: 'ai',
  countries: 'US,CA,FR',
  dateOption: 'custom-date-range',
  startdate: '2025-01-01',
  enddate: '2025-12-31',
});

fetch(`https://api.harvest-api.com/linkedin/ad-library?${params.toString()}`, {
  headers: { 'X-API-Key': '<api-key>' },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
searchUrl
string

Scrape Ad Library search URL, for example: https://www.linkedin.com/ad-library/search?accountOwner=test&keyword=test&dateOption=custom-date-range&startdate=2025-07-07&enddate=2025-08-21

​
keyword
string

Search by keyword

​
accountOwner
string

Search by company or advertiser name

​
countries
string

One or comma separated list of country codes to filter ads by country. Eg. 'US,GB,FR'. Supports "ALL" value to search in all countries.

​
dateOption
string

One of the following options to filter ads by date: 'last-30-days', 'current-month', 'current-year', 'last-year', 'custom-date-range'

​
startdate
string

Start date for 'custom-date-range' filter in 'YYYY-MM-DD' format

​
enddate
string

End date for 'custom-date-range' filter in 'YYYY-MM-DD' format

​
paginationToken
string<nullable>

Pagination token from the previous response for fetching the next page

Response

A list of ads matching the search criteria.

​
elements
any[]
​
pagination
object
​
status
string

Status of the response.

​
error
string

Error message, if any.

​
query
object