HarvestAPI / Search LinkedIn leads
HarvestAPI tool harvestapi-lead-search on looot: input fields, $0.1 per call, output shape, and code to run it with curl, JavaScript or Python.
Search LinkedIn profile leads by filters with advanced inclusion and exclusion criteria
- Tool id:
harvestapi-lead-search - Provider: HarvestAPI
- Job: Search linkedin lead (
linkedin.lead.search) - Price: $0.1 per call. A call that fails at the provider costs $0.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
companyHeadcount |
string | no | Filter by company headcount. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#companyheadcount |
companyHeadquarterLocations |
string | no | Filter by company headquarter location text. Comma-separated (max 70) |
currentCompanies |
string | no | Filter by current company IDs or URLs. Comma-separated (max 50) |
currentJobTitles |
string | no | Filter by current job titles. Comma-separated (max 70) |
excludeCompanyHeadquarterLocations |
string | no | Company headquarter locations to exclude from search. Comma-separated (max 70) |
excludeCurrentCompanies |
string | no | Current companies to exclude. Comma-separated (max 50) |
excludeCurrentJobTitles |
string | no | Current job titles to exclude. Comma-separated (max 70) |
excludeFunctionIds |
string | no | Function IDs to exclude. Comma-separated (max 30) |
excludeGeoIds |
string | no | Geo IDs to exclude from search. Comma-separated (max 70) |
excludeIndustryIds |
string | no | Industry IDs to exclude. Comma-separated (max 70) |
excludeLocations |
string | no | Locations to exclude from search. Comma-separated (max 70) |
excludePastCompanies |
string | no | Past companies to exclude. Comma-separated (max 50) |
excludePastJobTitles |
string | no | Past job titles to exclude. Comma-separated (max 70) |
excludeSchools |
string | no | Schools to exclude. Comma-separated (max 50) |
excludeSeniorityLevelIds |
string | no | Seniority level IDs to exclude. Comma-separated (max 20) |
firstNames |
string | no | Filter by first names. Comma-separated (max 70) |
functionIds |
string | no | Filter by job function IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#functionids |
geoIds |
string | no | Filter by LinkedIn Geo ID. Comma-separated. Overrides location param. Use /linkedin/geo-id-search to find IDs |
industryIds |
string | no | 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 |
lastNames |
string | no | Filter by last names. Comma-separated (max 70) |
locations |
string | no | Filter by location text. Comma-separated (max 70) |
page |
integer | no | Page number for pagination (clamped at 100) |
pastCompanies |
string | no | Filter by past company IDs or URLs. Comma-separated (max 50) |
pastJobTitles |
string | no | Filter by past job titles. Comma-separated (max 70) |
postedOnLinkedin |
boolean | no | Filter leads who posted on LinkedIn in the last 30 days |
profileLanguages |
string | no | Filter by profile languages. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#profilelanguages |
recentlyChangedJobs |
boolean | no | Filter leads who recently changed jobs in the last 90 days. |
requiredAccountId |
string | no | If we provide you a private pool of accounts, you can use this parameter to specify which account should be used for this request. |
salesNavUrl |
string | no | LinkedIn Sales Navigator search URL to use for the search. This will override all other search parameters, except the page parameter. For pagination, please pass the page query parameter separately. Note: the scraper doesn’t scrape the URL direc |
schools |
string | no | Filter by school IDs or URLs. Comma-separated (max 50) |
search |
string | no | Search query. Fuzzy search, supports LinkedIn’s search operators |
seniorityLevelIds |
string | no | Filter by seniority level IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#senioritylevelids |
sessionId |
string | no | Session ID to use for the search. See https://docs.harvestapi.io/linkedin-api-reference/leads/search-leads#session-id for details. |
usePrivatePool |
string | no | Set to true to use your private pool of resources (if available) |
yearsAtCurrentCompanyIds |
string | no | Filter by years at current company IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsatcurrentcompanyids |
yearsOfExperienceIds |
string | no | Filter by years of experience IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsofexperienceids |
Output
The run’s result holds the provider’s answer. Signed in, looot inspect harvestapi-lead-search prints its fields.
Run it
Every call needs your API token in LOOOT_TOKEN; Sign in shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With wait: 30 the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll GET /v1/runs/<runId>.
Example input with placeholder values:
curl -X POST "https://api.looot.ai/v1/runs" \
-H "Authorization: Bearer $LOOOT_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"endpointId":"harvestapi-lead-search","input":{},"wait":30}'const response = await fetch("https://api.looot.ai/v1/runs", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.LOOOT_TOKEN}`,
"Content-Type": "application/json",
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify({
endpointId: "harvestapi-lead-search",
input: {},
wait: 30,
}),
});
const run = await response.json();
console.log(run.status, run.result);import os
import uuid
import requests
response = requests.post(
"https://api.looot.ai/v1/runs",
headers={
"Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"endpointId": "harvestapi-lead-search",
"input": {},
"wait": 30,
},
timeout=90,
)
run = response.json()
print(run["status"], run.get("result"))To let looot pick among every provider of this job instead, send job:linkedin.lead.search as endpointId; see the job page.