Search LinkedIn leads
harvestapi.linkedin.leads.searchSearch LinkedIn profile leads by filters with advanced inclusion and exclusion criteria
- Price
- $0.1/callAt provider cost
- Success rate
- 100%Last 30 days · 19,755 calls
- Latency p50
- 3.7 sp95 15 s
- Last verified
- Sep 10, 2026Verified working
GEThttps://toolswitch.dev/v1/tools/harvestapi.linkedin.leads.search?page=1¤tCompanies=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2FgooglePreview- 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. Returns 25 rows per page in live tests; page is capped at 100. Private account/session and Sales Navigator URL overrides are outside this tool.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
page | integer | Optional | Page number for pagination (clamped at 100) | 1 |
geoIds | string | Optional | Filter by LinkedIn Geo ID. Comma-separated. Overrides location param. Use /linkedin/geo-id-search to find IDs | |
search | string | Optional | Search query. Fuzzy search, supports LinkedIn's search operators | |
schools | string | Optional | Filter by school IDs or URLs. Comma-separated (max 50) | |
lastNames | string | Optional | Filter by last names. Comma-separated (max 70) | |
locations | string | Optional | Filter by location text. Comma-separated (max 70) | |
firstNames | string | Optional | Filter by first names. Comma-separated (max 70) | |
functionIds | string | Optional | Filter by job function IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#functionids | |
industryIds | string | Optional | Filter by industry IDs. Comma-separated (max 70). Full list: https://github.com/HarvestAPI/linkedin-industry-codes-v2/blob/main/linkedin_industry_code_v2_all_eng_with_header.csv | |
excludeGeoIds | string | Optional | Geo IDs to exclude from search. Comma-separated (max 70) | |
pastCompanies | string | Optional | Filter by past company IDs or URLs. Comma-separated (max 50) | |
pastJobTitles | string | Optional | Filter by past job titles. Comma-separated (max 70) | |
excludeSchools | string | Optional | Schools to exclude. Comma-separated (max 50) | |
companyHeadcount | string | Optional | Filter by company headcount. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#companyheadcount | |
currentCompanies | string | Optional | Filter by current company IDs or URLs. Comma-separated (max 50) | https://www.linkedin.com/company/google |
currentJobTitles | string | Optional | Filter by current job titles. Comma-separated (max 70) | |
excludeLocations | string | Optional | Locations to exclude from search. Comma-separated (max 70) | |
postedOnLinkedin | boolean | Optional | Filter leads who posted on LinkedIn in the last 30 days | |
profileLanguages | string | Optional | Filter by profile languages. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#profilelanguages | |
seniorityLevelIds | string | Optional | Filter by seniority level IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#senioritylevelids | |
excludeFunctionIds | string | Optional | Function IDs to exclude. Comma-separated (max 30) | |
excludeIndustryIds | string | Optional | Industry IDs to exclude. Comma-separated (max 70) | |
recentlyChangedJobs | boolean | Optional | Filter leads who recently changed jobs in the last 90 days. | |
excludePastCompanies | string | Optional | Past companies to exclude. Comma-separated (max 50) | |
excludePastJobTitles | string | Optional | Past job titles to exclude. Comma-separated (max 70) | |
yearsOfExperienceIds | string | Optional | Filter by years of experience IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsofexperienceids | |
excludeCurrentCompanies | string | Optional | Current companies to exclude. Comma-separated (max 50) | |
excludeCurrentJobTitles | string | Optional | Current job titles to exclude. Comma-separated (max 70) | |
excludeSeniorityLevelIds | string | Optional | Seniority level IDs to exclude. Comma-separated (max 20) | |
yearsAtCurrentCompanyIds | string | Optional | Filter by years at current company IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsatcurrentcompanyids | |
companyHeadquarterLocations | string | Optional | Filter by company headquarter location text. Comma-separated (max 70) | |
excludeCompanyHeadquarterLocations | string | Optional | Company headquarter locations to exclude from search. Comma-separated (max 70) | |
- Query parameters
pageintegerOptionalPage number for pagination (clamped at 100)
Example:
1geoIdsstringOptionalFilter by LinkedIn Geo ID. Comma-separated. Overrides location param. Use /linkedin/geo-id-search to find IDs
searchstringOptionalSearch query. Fuzzy search, supports LinkedIn's search operators
schoolsstringOptionalFilter by school IDs or URLs. Comma-separated (max 50)
lastNamesstringOptionalFilter by last names. Comma-separated (max 70)
locationsstringOptionalFilter by location text. Comma-separated (max 70)
firstNamesstringOptionalFilter by first names. Comma-separated (max 70)
functionIdsstringOptionalFilter by job function IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#functionids
industryIdsstringOptionalFilter by industry IDs. Comma-separated (max 70). Full list: https://github.com/HarvestAPI/linkedin-industry-codes-v2/blob/main/linkedin_industry_code_v2_all_eng_with_header.csv
excludeGeoIdsstringOptionalGeo IDs to exclude from search. Comma-separated (max 70)
pastCompaniesstringOptionalFilter by past company IDs or URLs. Comma-separated (max 50)
pastJobTitlesstringOptionalFilter by past job titles. Comma-separated (max 70)
excludeSchoolsstringOptionalSchools to exclude. Comma-separated (max 50)
companyHeadcountstringOptionalFilter by company headcount. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#companyheadcount
currentCompaniesstringOptionalFilter by current company IDs or URLs. Comma-separated (max 50)
Example:
https://www.linkedin.com/company/googlecurrentJobTitlesstringOptionalFilter by current job titles. Comma-separated (max 70)
excludeLocationsstringOptionalLocations to exclude from search. Comma-separated (max 70)
postedOnLinkedinbooleanOptionalFilter leads who posted on LinkedIn in the last 30 days
profileLanguagesstringOptionalFilter by profile languages. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#profilelanguages
seniorityLevelIdsstringOptionalFilter by seniority level IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#senioritylevelids
excludeFunctionIdsstringOptionalFunction IDs to exclude. Comma-separated (max 30)
excludeIndustryIdsstringOptionalIndustry IDs to exclude. Comma-separated (max 70)
recentlyChangedJobsbooleanOptionalFilter leads who recently changed jobs in the last 90 days.
excludePastCompaniesstringOptionalPast companies to exclude. Comma-separated (max 50)
excludePastJobTitlesstringOptionalPast job titles to exclude. Comma-separated (max 70)
yearsOfExperienceIdsstringOptionalFilter by years of experience IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsofexperienceids
excludeCurrentCompaniesstringOptionalCurrent companies to exclude. Comma-separated (max 50)
excludeCurrentJobTitlesstringOptionalCurrent job titles to exclude. Comma-separated (max 70)
excludeSeniorityLevelIdsstringOptionalSeniority level IDs to exclude. Comma-separated (max 20)
yearsAtCurrentCompanyIdsstringOptionalFilter by years at current company IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsatcurrentcompanyids
companyHeadquarterLocationsstringOptionalFilter by company headquarter location text. Comma-separated (max 70)
excludeCompanyHeadquarterLocationsstringOptionalCompany headquarter locations to exclude from search. Comma-separated (max 70)
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
curl -X GET 'https://toolswitch.dev/v1/tools/harvestapi.linkedin.leads.search?page=1¤tCompanies=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fgoogle' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/harvestapi.linkedin.leads.search?page=1¤tCompanies=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fgoogle",
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.leads.search?page=1¤tCompanies=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fgoogle", {
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.1/call, including the service fee.