HarvestAPILinkedInSocial

Search LinkedIn ads

harvestapi.linkedin.ads.search

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

Price: $0.0016/callPelo preço do provedor
Success rate: —Ainda não há dados da taxa de sucessoAinda não há dados da taxa de sucesso
Latency p50: ——
Last verified: 10 de set. de 2026Verified working

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

Uses platform quota
Synchronous response
Reads public data

Parâmetros

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.

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Parâmetros de consulta
`enddate`	string	Opcional	End date for 'custom-date-range' filter in 'YYYY-MM-DD' format
`keyword`	string	Opcional	Search by keyword
`countries`	string	Opcional	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	Opcional	Start date for 'custom-date-range' filter in 'YYYY-MM-DD' format
`dateOption`	string	Opcional	One of the following options to filter ads by date: 'last-30-days', 'current-month', 'current-year', 'last-year', 'custom-date-range'
`accountOwner`	string	Opcional	Search by company or advertiser name	`Microsoft`
`paginationToken`	string	Opcional	Pagination token from the previous response for fetching the next page

Parâmetros de consulta
enddatestringOpcional
End date for 'custom-date-range' filter in 'YYYY-MM-DD' format
keywordstringOpcional
Search by keyword
countriesstringOpcional
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.
startdatestringOpcional
Start date for 'custom-date-range' filter in 'YYYY-MM-DD' format
dateOptionstringOpcional
One of the following options to filter ads by date: 'last-30-days', 'current-month', 'current-year', 'last-year', 'custom-date-range'
accountOwnerstringOpcional
Search by company or advertiser name
Exemplo: Microsoft
paginationTokenstringOpcional
Pagination token from the previous response for fetching the next page

Exemplos de código

Substitua $TOOLSWITCH_KEY pela chave criada no 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());

Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.0016/call, incluindo a taxa de serviço.