Search LinkedIn ads
harvestapi.linkedin.ads.searchRetrieve a list of LinkedIn Ads matching the specified search criteria.
- Price
- $0.0016/callAl precio del proveedor
- Success rate
- —Aún no hay datos de tasa de éxitoAún no hay datos de tasa de éxito
- Latency p50
- ——
- Last verified
- 10 sept 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 | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|---|
| Parámetros de consulta | ||||
enddate | cadena | Opcional | End date for 'custom-date-range' filter in 'YYYY-MM-DD' format | |
keyword | cadena | Opcional | Search by keyword | |
countries | cadena | 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 | cadena | Opcional | Start date for 'custom-date-range' filter in 'YYYY-MM-DD' format | |
dateOption | cadena | Opcional | One of the following options to filter ads by date: 'last-30-days', 'current-month', 'current-year', 'last-year', 'custom-date-range' | |
accountOwner | cadena | Opcional | Search by company or advertiser name | Microsoft |
paginationToken | cadena | Opcional | Pagination token from the previous response for fetching the next page | |
- Parámetros de consulta
enddatecadenaOpcionalEnd date for 'custom-date-range' filter in 'YYYY-MM-DD' format
keywordcadenaOpcionalSearch by keyword
countriescadenaOpcionalOne or comma separated list of country codes to filter ads by country. Eg. 'US,GB,FR'. Supports "ALL" value to search in all countries.
startdatecadenaOpcionalStart date for 'custom-date-range' filter in 'YYYY-MM-DD' format
dateOptioncadenaOpcionalOne of the following options to filter ads by date: 'last-30-days', 'current-month', 'current-year', 'last-year', 'custom-date-range'
accountOwnercadenaOpcionalSearch by company or advertiser name
Ejemplo:
MicrosoftpaginationTokencadenaOpcionalPagination token from the previous response for fetching the next page
Ejemplos de código
Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.
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());La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.0016/call, incluida la tarifa de servicio.