Search LinkedIn leads
harvestapi_get_linkedin_lead_searchSearch LinkedIn profile leads by filters with advanced inclusion and exclusion criteria Uses the caller's OpenAny gateway credentials. Charges and authorization are determined by the gateway.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (clamped at 100) | |
| geoIds | No | Filter by LinkedIn Geo ID. Comma-separated. Overrides location param. Use /linkedin/geo-id-search to find IDs | |
| search | No | Search query. Fuzzy search, supports LinkedIn's search operators | |
| schools | No | Filter by school IDs or URLs. Comma-separated (max 50) | |
| lastNames | No | Filter by last names. Comma-separated (max 70) | |
| locations | No | Filter by location text. Comma-separated (max 70) | |
| sessionId | No | Session ID to use for the search. See https://docs.harvestapi.io/linkedin-api-reference/leads/search-leads#session-id for details. | |
| firstNames | No | Filter by first names. Comma-separated (max 70) | |
| functionIds | No | Filter by job function IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#functionids | |
| industryIds | 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 | |
| salesNavUrl | 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 directly, it will parse the URL, sanitize and validate params. It supports all parameters currently, but if LinkedIn adds new parameters in the future, they might not be supported until we update the API. Please contact us in this case. | |
| excludeGeoIds | No | Geo IDs to exclude from search. Comma-separated (max 70) | |
| pastCompanies | No | Filter by past company IDs or URLs. Comma-separated (max 50) | |
| pastJobTitles | No | Filter by past job titles. Comma-separated (max 70) | |
| excludeSchools | No | Schools to exclude. Comma-separated (max 50) | |
| usePrivatePool | No | Set to true to use your private pool of resources (if available) | |
| companyHeadcount | No | Filter by company headcount. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#companyheadcount | |
| currentCompanies | No | Filter by current company IDs or URLs. Comma-separated (max 50) | |
| currentJobTitles | No | Filter by current job titles. Comma-separated (max 70) | |
| excludeLocations | No | Locations to exclude from search. Comma-separated (max 70) | |
| postedOnLinkedin | No | Filter leads who posted on LinkedIn in the last 30 days | |
| profileLanguages | No | Filter by profile languages. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#profilelanguages | |
| requiredAccountId | 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. | |
| seniorityLevelIds | No | Filter by seniority level IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#senioritylevelids | |
| excludeFunctionIds | No | Function IDs to exclude. Comma-separated (max 30) | |
| excludeIndustryIds | No | Industry IDs to exclude. Comma-separated (max 70) | |
| recentlyChangedJobs | No | Filter leads who recently changed jobs in the last 90 days. | |
| excludePastCompanies | No | Past companies to exclude. Comma-separated (max 50) | |
| excludePastJobTitles | No | Past job titles to exclude. Comma-separated (max 70) | |
| yearsOfExperienceIds | No | Filter by years of experience IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsofexperienceids | |
| excludeCurrentCompanies | No | Current companies to exclude. Comma-separated (max 50) | |
| excludeCurrentJobTitles | No | Current job titles to exclude. Comma-separated (max 70) | |
| excludeSeniorityLevelIds | No | Seniority level IDs to exclude. Comma-separated (max 20) | |
| yearsAtCurrentCompanyIds | No | Filter by years at current company IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsatcurrentcompanyids | |
| companyHeadquarterLocations | No | Filter by company headquarter location text. Comma-separated (max 70) | |
| excludeCompanyHeadquarterLocations | No | Company headquarter locations to exclude from search. Comma-separated (max 70) |