Skip to main content
POST
/
lead-search-at-scale
cURL
curl --request POST \
  --url https://web-scraping-api2.p.rapidapi.com/lead-search-at-scale \
  --header 'Content-Type: application/json' \
  --header 'x-rapidapi-key: <api-key>' \
  --data '{
  "url": "https://www.linkedin.com/sales/search/people?coach=false&query=(filters%3AList((type%3AREGION%2Cvalues%3AList((id%3A103644278%2CselectionType%3AINCLUDED)))%2C(type%3ACURRENT_COMPANY%2Cvalues%3AList((id%3A82274765%2CselectionType%3AINCLUDED)))))",
  "current_company_ids": [
    162479,
    1053
  ],
  "title_keywords": [
    "Director",
    "Operation"
  ],
  "company_headcounts": [
    "1001-5000",
    "5001-10000"
  ],
  "functions": [
    "Accounting",
    "Administrative"
  ],
  "geo_codes": [
    103644278,
    102299470
  ],
  "past_company_ids": [
    1009
  ],
  "industry_codes": [
    3,
    4
  ],
  "seniority_levels": [],
  "year_in_current_company": [],
  "year_in_current_position": [],
  "years_of_experience": [],
  "current_company_names": [
    "Apple",
    "Microsoft"
  ],
  "past_company_names": [
    "Apple",
    "Microsoft"
  ],
  "company_type": [],
  "company_headquarter_location_ids": [],
  "company_headquarter_location_ids_exclude": [],
  "seniority_levels_exclude": [],
  "past_job_titles": [
    "CEO"
  ],
  "current_company_ids_exclude": [],
  "title_keywords_exclude": [
    "Sales"
  ],
  "functions_exclude": [],
  "geo_codes_exclude": [
    105080838,
    102257491
  ],
  "past_company_ids_exclude": [
    1009
  ],
  "past_job_titles_exclude": [
    "Founder"
  ],
  "industry_codes_exclude": [
    5,
    6
  ],
  "first_name": "",
  "last_name": "",
  "profile_languages": [],
  "school_ids": [
    123456
  ],
  "school_ids_exclude": [
    654321
  ],
  "changed_jobs": "false",
  "posted_on_linkedin": "false",
  "mentioned_in_news": "false",
  "keywords": "system",
  "zipcode_ids": [
    90001
  ],
  "radius": 5
}'
{
  "message": "Use this request_id to check your search with 'Check Search Status' endpoint",
  "request_id": "0bb8360c779317e5f6fc1722a8bd26a1",
  "total_count": 11075
}

​
Having a big employee search? No problem, we now can scrape searches that are up to 50k results.

​
🛠 How the Process Works

  • Launch your search with specific criteria via this endpoint.
  • This endpoint returns a request_id, allowing you to track progress through the Check Search Status endpoint.
  • The search initiation alone costs 50 credits, even if the search returns 0 results.
  • Then each result costs 1 credits, and will be charged in advanced before you actually fetch the results.

​
Step 2️⃣: Monitor Search Progress

​
Step 3️⃣: Retrieve Results

  • Once the search is complete, access the results via the Get Search Results endpoint.
  • Fetching results is free of charge.

​
This endpoint is for custom-plan users only. Please contact us for more details.

💡 For better understanding and demo code, please follow this tutorial

Authorizations

​
x-rapidapi-key
string
header
required

Body

application/json
​
url
string<uri>

The LinkedIn Sales Navigator URL for searching employees. When using this parameter, all other parameters will be ignored.

Example:

"https://www.linkedin.com/sales/search/people?coach=false&query=(filters%3AList((type%3AREGION%2Cvalues%3AList((id%3A103644278%2CselectionType%3AINCLUDED)))%2C(type%3ACURRENT_COMPANY%2Cvalues%3AList((id%3A82274765%2CselectionType%3AINCLUDED)))))"

​
current_company_ids
integer[]

To filter by current company. Learn how to find a company_id. Maximum: 10 elements.

Example:
[162479, 1053]
​
title_keywords
string[]

Maximum: 20 elements.

Example:
["Director", "Operation"]
​
company_headcounts
enum<string>[]
Example:
["1001-5000", "5001-10000"]
​
functions
enum<string>[]
Example:
["Accounting", "Administrative"]
​
geo_codes
integer[]

To filter by location. Learn how to find a geo_code. Maximum: 20 elements.

Example:
[103644278, 102299470]
​
past_company_ids
integer[]

To filter by past company. Learn how to find a company_id. Maximum: 10 elements.

Example:
[1009]
​
industry_codes
integer[]

All industry codes could be found on this page.

Example:
[3, 4]
​
seniority_levels
enum<string>[]
Example:
[]
​
year_in_current_company
enum<string>[]
Example:
[]
​
year_in_current_position
enum<string>[]
Example:
[]
​
years_of_experience
enum<string>[]
Example:
[]
​
current_company_names
string[]

In case the company_id is not available, use this filter instead. Maximum: 10 elements.

Example:
["Apple", "Microsoft"]
​
past_company_names
string[]

In case the company_id is not available, use this filter instead. Maximum: 10 elements.

Example:
["Apple", "Microsoft"]
​
company_type
enum<string>[]
Example:
[]
​
company_headquarter_location_ids
integer[]

Learn how to find a geo_code/location_id. Maximum: 20 elements.

Example:
[]
​
company_headquarter_location_ids_exclude
integer[]

To exclude some locations. Learn how to find a geo_code/location_id. Maximum: 20 elements.

Example:
[]
​
seniority_levels_exclude
enum<string>[]
Example:
[]
​
past_job_titles
string[]
Example:
["CEO"]
​
current_company_ids_exclude
integer[]

To exclude some companies. Learn how to find a company_id. Maximum: 10 elements.

Example:
[]
​
title_keywords_exclude
string[]

Maximum: 20 elements.

Example:
["Sales"]
​
functions_exclude
enum<string>[]
Example:
[]
​
geo_codes_exclude
integer[]

To exclude some locations. Learn how to find a geo_code. Maximum: 20 elements.

Example:
[105080838, 102257491]
​
past_company_ids_exclude
integer[]

Learn how to find a company_id. Maximum: 10 elements.

Example:
[1009]
​
past_job_titles_exclude
string[]
Example:
["Founder"]
​
industry_codes_exclude
integer[]
Example:
[5, 6]
​
first_name
string
Example:

""

​
last_name
string
Example:

""

​
profile_languages
enum<string>[]
Example:
[]
​
school_ids
integer[]

Maximum: 10 elements.

Example:
[123456]
​
school_ids_exclude
integer[]

Maximum: 10 elements.

Example:
[654321]
​
changed_jobs
enum<string>
Available options:
true,
false
Example:

"false"

​
posted_on_linkedin
enum<string>
Available options:
true,
false
Example:

"false"

​
mentioned_in_news
enum<string>
Available options:
true,
false
Example:

"false"

​
keywords
string

Support Boolean keywords as well. For example: AI OR "machine learning".

Example:

"system"

​
zipcode_ids
integer[]

Maximum: 5 elements.

Example:
[90001]
​
radius
enum<integer>
default:5

To be used together with the zipcode_ids filter to define the radius in mile.

Available options:
1,
5,
10,
25,
35,
50,
75,
100
Example:

5

Response

Success.

​
message
string
Example:

"Use this request_id to check your search with 'Check Search Status' endpoint"

​
request_id
string
Example:

"0bb8360c779317e5f6fc1722a8bd26a1"

​
total_count
integer
Example:

11075