HarvestAPI: Search Leads

Search LinkedIn profiles with Sales Navigator-style filters (current company, job title, location, seniority), including listing employees of one or more.

Tool ID: harvestapi_search_leads

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'harvestapi_search_leads',
  {
    "search": "software companies hiring engineers",
    "currentCompanies": "example",
    "pastCompanies": "example"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute harvestapi_search_leads --input '{
  "search": "software companies hiring engineers",
  "currentCompanies": "example",
  "pastCompanies": "example"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "elements": [
      {
        "linkedinUrl": "https://www.linkedin.com/in/jane-doe"
      }
    ],
    "status": "OK"
  }
}

Use deepline describe harvestapi_search_leads --json for the latest machine-readable contract.

Input reference

Searches LinkedIn profiles with Sales Navigator-style filters. Use currentCompanies for company employee discovery and preserve sessionId across pages. Known provider behavior: currentCompanies is matched by company name even when a LinkedIn company ID or URL is provided, so similarly named companies can appear. Verify each result’s currentPositions.companyId against the intended company ID.

Name	Type	Required	Default	Details
`payload.search`	`string`	No	—	Free-text profile search.
`payload.currentCompanies`	`string`	No	—	Comma-separated current company names, LinkedIn company URLs, or identifiers. maximum 50. HarvestAPI matches this filter by company name even when an ID or URL is provided, so verify returned currentPositions.companyId values.
`payload.pastCompanies`	`string`	No	—	Comma-separated past company filters. maximum 50.
`payload.locations`	`string`	No	—	Comma-separated location filters. maximum 70.
`payload.geoIds`	`string`	No	—	Comma-separated LinkedIn geography IDs.
`payload.schools`	`string`	No	—	Comma-separated school filters. maximum 50.
`payload.currentJobTitles`	`string`	No	—	Comma-separated current job-title filters. maximum 70. Split longer title lists across separate searches.
`payload.pastJobTitles`	`string`	No	—	Comma-separated past job-title filters. maximum 70.
`payload.firstNames`	`string`	No	—	Comma-separated first names. maximum 70.
`payload.lastNames`	`string`	No	—	Comma-separated last names. maximum 70.
`payload.industryIds`	`string`	No	—	Comma-separated LinkedIn industry IDs. maximum 70.
`payload.yearsAtCurrentCompanyIds`	`string`	No	—	Comma-separated years-at-current-company filter IDs.
`payload.yearsOfExperienceIds`	`string`	No	—	Comma-separated years-of-experience filter IDs.
`payload.seniorityLevelIds`	`string`	No	—	Comma-separated seniority-level IDs.
`payload.functionIds`	`string`	No	—	Comma-separated job-function IDs.
`payload.recentlyChangedJobs`	`boolean`	No	—	Filter to profiles that recently changed jobs.
`payload.postedOnLinkedin`	`boolean`	No	—	Filter to profiles that posted on LinkedIn.
`payload.profileLanguages`	`string`	No	—	Comma-separated profile languages.
`payload.companyHeadcount`	`string`	No	—	Comma-separated current-company headcount ranges.
`payload.companyHeadquarterLocations`	`string`	No	—	Comma-separated current-company headquarters locations. maximum 70.
`payload.excludeLocations`	`string`	No	—	Comma-separated locations to exclude. maximum 70.
`payload.excludeGeoIds`	`string`	No	—	Comma-separated geography IDs to exclude. maximum 70.
`payload.excludeCurrentCompanies`	`string`	No	—	Comma-separated current companies to exclude. maximum 50.
`payload.excludePastCompanies`	`string`	No	—	Comma-separated past companies to exclude. maximum 50.
`payload.excludeSchools`	`string`	No	—	Comma-separated schools to exclude. maximum 50.
`payload.excludeCurrentJobTitles`	`string`	No	—	Comma-separated current job titles to exclude. maximum 70.
`payload.excludePastJobTitles`	`string`	No	—	Comma-separated past job titles to exclude. maximum 70.
`payload.excludeIndustryIds`	`string`	No	—	Comma-separated industry IDs to exclude. maximum 70.
`payload.excludeSeniorityLevelIds`	`string`	No	—	Comma-separated seniority-level IDs to exclude. maximum 20.
`payload.excludeFunctionIds`	`string`	No	—	Comma-separated function IDs to exclude. maximum 30.
`payload.excludeCompanyHeadquarterLocations`	`string`	No	—	Comma-separated company headquarters locations to exclude. maximum 70.
`payload.salesNavUrl`	`string`	No	—	Sales Navigator search URL whose filters should be reproduced. Format: `uri`.
`payload.page`	`integer`	No	`1`	Result page, from 1 through 100. Minimum: 1. Maximum: 100.
`payload.sessionId`	`string`	No	—	Search session identifier to preserve across later pages.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.elements`	`array`	Yes	—	—
`result.data.elements[].id`	`string`	No	—	—
`result.data.elements[].linkedinUrl`	`string`	Yes	—	—
`result.data.elements[].firstName`	`string`	No	—	—
`result.data.elements[].lastName`	`string`	No	—	—
`result.data.elements[].summary`	`string`	No	—	—
`result.data.elements[].openProfile`	`boolean`	No	—	—
`result.data.elements[].premium`	`boolean`	No	—	—
`result.data.elements[].location`	`object`	No	—	—
`result.data.elements[].location.linkedinText`	`string`	No	—	—
`result.data.elements[].pictureUrl`	`string`	No	—	—
`result.data.elements[].currentPositions`	`array`	No	—	—
`result.data.elements[].currentPositions[].companyName`	`string`	No	—	—
`result.data.elements[].currentPositions[].title`	`string`	No	—	—
`result.data.elements[].currentPositions[].description`	`string`	No	—	—
`result.data.elements[].currentPositions[].current`	`boolean`	No	—	—
`result.data.elements[].currentPositions[].startedOn`	`object`	No	—	—
`result.data.elements[].currentPositions[].startedOn.month`	`integer \| string \| null`	No	—	—
`result.data.elements[].currentPositions[].startedOn.year`	`integer`	No	—	Format: `int32`.
`result.data.elements[].currentPositions[].companyId`	`string`	No	—	—
`result.data.elements[].currentPositions[].companyLinkedinUrl`	`string`	No	—	—
`result.data.elements[].currentPositions[].tenureAtPosition`	`object`	No	—	—
`result.data.elements[].currentPositions[].tenureAtPosition.numYears`	`integer \| string`	No	—	—
`result.data.elements[].currentPositions[].tenureAtPosition.numMonths`	`integer \| string`	No	—	—
`result.data.elements[].currentPositions[].tenureAtCompany`	`object`	No	—	—
`result.data.elements[].currentPositions[].tenureAtCompany.numYears`	`integer \| string`	No	—	—
`result.data.elements[].currentPositions[].tenureAtCompany.numMonths`	`integer \| string`	No	—	—
`result.data.pagination`	`object`	No	—	—
`result.data.pagination.totalPages`	`integer`	No	—	Format: `int32`.
`result.data.pagination.totalElements`	`integer`	No	—	Format: `int32`.
`result.data.pagination.pageNumber`	`integer`	No	—	Format: `int32`.
`result.data.pagination.previousElements`	`integer`	No	—	Format: `int32`.
`result.data.pagination.pageSize`	`integer`	No	—	Format: `int32`.
`result.data.pagination.paginationToken`	`string \| null`	No	—	—
`result.data.status`	`"OK" \| 200`	Yes	—	—
`result.data.error`	`""`	No	—	—
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: provider_usage (provider usage).
Estimated Deepline credits: 0.7 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation