Skip to main content
GET
/
linkedin
/
lead-search
Search LinkedIn leads
curl --request GET \
  --url https://api.harvest-api.com/linkedin/lead-search \
  --header 'X-API-Key: <api-key>'
{
  "elements": [
    {
      "linkedinUrl": "<string>",
      "id": "<string>",
      "firstName": "<string>",
      "lastName": "<string>",
      "openProfile": true,
      "premium": true,
      "location": {
        "linkedinText": "<string>"
      },
      "pictureUrl": "<string>",
      "currentPositions": [
        {
          "companyName": "<string>",
          "title": "<string>",
          "description": "<string>",
          "startedOn": {
            "month": "<string>",
            "year": 123
          },
          "companyId": "<string>",
          "companyLinkedinUrl": "<string>",
          "tenureAtPosition": {
            "numYears": "<string>",
            "numMonths": "<string>"
          },
          "tenureAtCompany": {
            "numYears": "<string>",
            "numMonths": "<string>"
          }
        }
      ]
    }
  ],
  "pagination": {
    "totalPages": 123,
    "totalElements": 123,
    "pageNumber": 123,
    "previousElements": 123,
    "pageSize": 123,
    "paginationToken": "<string>"
  },
  "status": "<string>",
  "error": "<string>"
}

​
Examples

const params = new URLSearchParams({
  page: '1',
  search: 'Machine Learning Engineer',
  currentCompany: 'https://www.linkedin.com/company/google',
  location: 'US',
  seniorityLevelIds: '120,210',
  profileLanguages: 'en',
  excludeSeniorityLevelIds: '220,300,310',
});
fetch(`https://api.harvest-api.com/linkedin/lead-search?${params.toString()}`, {
  headers: { 'X-API-Key': '<api-key>' },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
search
string
required

Search query. Fuzzy search, supports LinkedIn's search operators

​
currentCompanies
string

Filter by current company IDs or URLs. Comma-separated (max 50)

​
pastCompanies
string

Filter by past company IDs or URLs. Comma-separated (max 50)

​
locations
string

Filter by location text. Comma-separated (max 70)

​
geoIds
string

Filter by LinkedIn Geo ID. Comma-separated. Overrides location param. Use /linkedin/geo-id-search to find IDs

​
schools
string

Filter by school IDs or URLs. Comma-separated (max 50)

​
currentJobTitles
string

Filter by current job titles. Comma-separated (max 70)

​
pastJobTitles
string

Filter by past job titles. Comma-separated (max 70)

​
firstNames
string

Filter by first names. Comma-separated (max 70)

​
lastNames
string

Filter by last names. Comma-separated (max 70)

​
industryIds
string

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

​
yearsAtCurrentCompanyIds
string

Filter by years at current company IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsatcurrentcompanyids

​
yearsOfExperienceIds
string

Filter by years of experience IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#yearsofexperienceids

​
seniorityLevelIds
string

Filter by seniority level IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#senioritylevelids

​
functionIds
string

Filter by job function IDs. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#functionids

​
recentlyChangedJobs
boolean

Filter leads who recently changed jobs

​
profileLanguages
string

Filter by profile languages. Comma-separated. https://github.com/HarvestAPI/harvestapi-sdk/blob/main/packages/scraper/README.md#profilelanguages

​
excludeLocations
string

Locations to exclude from search. Comma-separated (max 70)

​
excludeGeoIds
string

Geo IDs to exclude from search. Comma-separated (max 70)

​
excludeCurrentCompanies
string

Current companies to exclude. Comma-separated (max 50)

​
excludePastCompanies
string

Past companies to exclude. Comma-separated (max 50)

​
excludeSchools
string

Schools to exclude. Comma-separated (max 50)

​
excludeCurrentJobTitles
string

Current job titles to exclude. Comma-separated (max 70)

​
excludePastJobTitles
string

Past job titles to exclude. Comma-separated (max 70)

​
excludeIndustryIds
string

Industry IDs to exclude. Comma-separated (max 70)

​
excludeSeniorityLevelIds
string

Seniority level IDs to exclude. Comma-separated (max 20)

​
excludeFunctionIds
string

Function IDs to exclude. Comma-separated (max 30)

​
page
integer
default:1

Page number for pagination (clamped at 100)

Response

Lead search response

​
elements
object[]
​
pagination
object
​
status
string
​
error
string