HarvestAPILinkedInSocial

Search LinkedIn ads

harvestapi.linkedin.ads.search

Retrieve a list of LinkedIn Ads matching the specified search criteria.

Price: $0.0016/callAt provider cost
Success rate: —No success-rate data yetNo success-rate data yet
Latency p50: ——
Last verified: Sep 10, 2026Verified working

GEThttps://toolswitch.dev/v1/tools/harvestapi.linkedin.ads.search?accountOwner=MicrosoftPreview

Uses platform quota
Synchronous response
Reads public data

Parameters

Use only the declared query parameters, once each, without a request body. Results are provider-native: inspect element/elements and body status/error; HTTP 200 alone does not prove a hit. Empty results can still be charged.

Parameter	Type	Required	Description	Example
Query parameters
`enddate`	string	Optional	End date for 'custom-date-range' filter in 'YYYY-MM-DD' format
`keyword`	string	Optional	Search by keyword
`countries`	string	Optional	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.
`startdate`	string	Optional	Start date for 'custom-date-range' filter in 'YYYY-MM-DD' format
`dateOption`	string	Optional	One of the following options to filter ads by date: 'last-30-days', 'current-month', 'current-year', 'last-year', 'custom-date-range'
`accountOwner`	string	Optional	Search by company or advertiser name	`Microsoft`
`paginationToken`	string	Optional	Pagination token from the previous response for fetching the next page

Query parameters
enddatestringOptional
End date for 'custom-date-range' filter in 'YYYY-MM-DD' format
keywordstringOptional
Search by keyword
countriesstringOptional
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.
startdatestringOptional
Start date for 'custom-date-range' filter in 'YYYY-MM-DD' format
dateOptionstringOptional
One of the following options to filter ads by date: 'last-30-days', 'current-month', 'current-year', 'last-year', 'custom-date-range'
accountOwnerstringOptional
Search by company or advertiser name
Example: Microsoft
paginationTokenstringOptional
Pagination token from the previous response for fetching the next page

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/harvestapi.linkedin.ads.search?accountOwner=Microsoft' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/harvestapi.linkedin.ads.search?accountOwner=Microsoft",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/harvestapi.linkedin.ads.search?accountOwner=Microsoft", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.0016/call, including the service fee.