---
title: "Search LinkedIn leads"
method: GET
path: "/linkedin/lead-search"
---

# Search LinkedIn leads

`GET /linkedin/lead-search`

Search LinkedIn profile leads by filters with advanced inclusion and exclusion criteria

## Query parameters

- `search` string
- `currentCompanies` string
- `pastCompanies` string
- `locations` string
- `geoIds` string
- `schools` string
- `currentJobTitles` string
- `pastJobTitles` string
- `firstNames` string
- `lastNames` string
- `industryIds` string
- `yearsAtCurrentCompanyIds` string
- `yearsOfExperienceIds` string
- `seniorityLevelIds` string
- `functionIds` string
- `recentlyChangedJobs` boolean
- `postedOnLinkedin` boolean
- `profileLanguages` string
- `companyHeadcount` string
- `companyHeadquarterLocations` string
- `excludeLocations` string
- `excludeGeoIds` string
- `excludeCurrentCompanies` string
- `excludePastCompanies` string
- `excludeSchools` string
- `excludeCurrentJobTitles` string
- `excludePastJobTitles` string
- `excludeIndustryIds` string
- `excludeSeniorityLevelIds` string
- `excludeFunctionIds` string
- `excludeCompanyHeadquarterLocations` string
- `salesNavUrl` string
- `page` integer
- `sessionId` string
- `usePrivatePool` string
- `requiredAccountId` string

## Response `200`

Lead search response

- object
  - `elements` LeadShort[]
    - `id` string
    - `linkedinUrl` string, required
    - `firstName` string
    - `lastName` string
    - `openProfile` boolean
    - `premium` boolean
    - `location` object
      - `linkedinText` string
    - `pictureUrl` string
    - `currentPositions` object[]
      - `companyName` string
      - `title` string
      - `description` string
      - `startedOn` object
        - `month` string, nullable
        - `year` integer
      - `companyId` string
      - `companyLinkedinUrl` string
      - `tenureAtPosition` object
        - `numYears` string
        - `numMonths` string
      - `tenureAtCompany` object
        - `numYears` string
        - `numMonths` string
  - `pagination` Pagination
    - `totalPages` integer
    - `totalElements` integer
    - `pageNumber` integer
    - `previousElements` integer
    - `pageSize` integer
    - `paginationToken` string, nullable
  - `status` string
  - `error` string

## Other responses

- `400` — Unexpected error

---

[API](https://skmtc.net/harvestapi/apis/harvestapi-linkedin-api-reference.md) · [All operations](https://skmtc.net/harvestapi/apis/harvestapi-linkedin-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harvestapi/harvestapi-linkedin-api-reference/versions/8dbddebc7f88/schema)