---
title: "Search linkedin lead"
description: "Run job:linkedin.lead.search through the looot API: 1 provider, from $0.1 per call. Inputs, prices, output shape and code for curl, JavaScript and Python."
sidebar:
  hidden: true
---

{/* Generated by scripts/generate-api-reference.mjs from data/api-reference.json. Do not edit. */}

Search linkedin lead.

Job id `linkedin.lead.search`, in [Social data](/catalog/social) (LinkedIn). As of 2026-10-07, 1 provider serve it through 1 tool. Run `job:linkedin.lead.search` and looot picks one of them; with `fallback` on, a miss moves on to the next. See [Jobs](/concepts/jobs).

## Inputs

This job has one tool, so it takes that tool's fields. Any key you send passes through unchanged.

| 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 |

## Providers and prices

| Provider | Tool | Price |
| --- | --- | --- |
| [HarvestAPI](/providers/harvestapi) | [`harvestapi-lead-search`](/reference/tools/harvestapi-lead-search) | $0.1 per call |

A call that fails at the provider costs $0. See [What's free](/money/free-and-failures).

## 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](/get-started/sign-in#use-the-token-in-scripts-and-agents) 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:

<CodeGroup>

```bash curl
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":"job:linkedin.lead.search","input":{},"wait":30}'
```

```js JavaScript
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: "job:linkedin.lead.search",
    input: {},
    wait: 30,
  }),
});
const run = await response.json();
console.log(run.status, run.result);
```

```python Python
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": "job:linkedin.lead.search",
        "input": {},
        "wait": 30,
    },
    timeout=90,
)
run = response.json()
print(run["status"], run.get("result"))
```

</CodeGroup>

To pin one provider, send its tool id as `endpointId` instead of `job:linkedin.lead.search`. The shared input names above are for the `job:` run only; a tool id takes that tool's own field names, listed on its page, and refuses the shared ones when they differ.
