Search Leads

POST /search-leads

Search for employees/leads using Sales Navigator filters. This is an asynchronous endpoint that creates a search job.

How the Process Works

Step 1: Initiate Search

• Launch your search with specific criteria via this endpoint.
• This endpoint returns a request_id for tracking progress.
• This step costs 50 credits, even if the search returns 0 results.

Step 2: Monitor Search Progress

• Use the Check Search Status endpoint to track your search.
• This action is free of charge.

Step 3: Retrieve Results

• Once the search is complete, access the results via the Get Lead Results endpoint.
• Retrieving each result incurs 1 credit.

For tutorials and demo code, see How to Search Leads.

Parameters

You can either provide search filters OR a Sales Navigator URL.

Option 1: Search Filters

Parameter	Type	Required	Description
title_keywords	array	No	Job titles to search for (e.g., ["CEO", "Founder"])
current_company_names	array	No	Current company names
current_company_ids	array	No	Current company LinkedIn IDs
past_company_names	array	No	Past company names
past_company_ids	array	No	Past company LinkedIn IDs
geo_codes	array	No	Location geo codes
industry_codes	array	No	Industry codes
school_ids	array	No	School LinkedIn IDs
keywords	string	No	General search keywords
limit	integer	No	Max results (1-2500, default: 100)

Option 2: Sales Navigator URL

Parameter	Type	Required	Description
sales_nav_url	string	Yes	LinkedIn Sales Navigator search URL
limit	integer	No	Max results (1-2500, default: 100)

See Understanding Employee Search Filters for all available filters and geo codes.

Example Request

cURL

curl --request POST \
  --url https://api.infoplug.io/search-leads \
  --header 'Content-Type: application/json' \
  --header 'X-INFOPLUG-API-KEY: YOUR_API_KEY' \
  --data '{
    "geo_codes": [103644278],
    "title_keywords": ["CEO", "Founder"],
    "current_company_names": ["Google", "Microsoft"],
    "limit": 100
  }'

Python

import requests

url = "https://api.infoplug.io/search-leads"
headers = {
    "Content-Type": "application/json",
    "X-INFOPLUG-API-KEY": "YOUR_API_KEY"
}
data = {
    "geo_codes": [103644278],
    "title_keywords": ["CEO", "Founder"],
    "current_company_names": ["Google", "Microsoft"],
    "limit": 100
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Node.js

const response = await fetch('https://api.infoplug.io/search-leads', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-INFOPLUG-API-KEY': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    geo_codes: [103644278],
    title_keywords: ['CEO', 'Founder'],
    current_company_names: ['Google', 'Microsoft'],
    limit: 100
  })
});
const data = await response.json();
console.log(data);

Example Response

200 OK

{
  "message": "Employee search job created",
  "request_id": "search-leads-1234567890-abc123",
  "status": "processing",
  "search_type": "standard"
}

400 Bad Request

{
  "message": "invalid_parameter",
  "parameter": "limit",
  "details": "Limit must be between 1 and 2500"
}

401 Unauthorized

{
  "message": "unauthorized",
  "details": "Invalid or missing API key"
}