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>[]
Available options:
Self-employed,
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
Example:
["1001-5000", "5001-10000"]
functions
enum<string>[]
Available options:
Accounting,
Administrative,
Arts and Design,
Business Development,
Community and Social Services,
Consulting,
Education,
Engineering,
Entrepreneurship,
Finance,
Healthcare Services,
Human Resources,
Information Technology,
Legal,
Marketing,
Media and Communication,
Military and Protective Services,
Operations,
Product Management,
Program and Project Management,
Purchasing,
Quality Assurance,
Real Estate,
Research,
Sales,
Customer Success and Support
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>[]
Available options:
Owner/Partner,
CXO,
Vice President,
Director,
Experienced Manager,
Entry Level Manager,
Strategic,
Senior,
Entry Level,
In Training
Example:
[]
year_in_current_company
enum<string>[]
Available options:
Less than 1 year,
1 to 2 years,
3 to 5 years,
6 to 10 years,
More than 10 years
Example:
[]
year_in_current_position
enum<string>[]
Available options:
Less than 1 year,
1 to 2 years,
3 to 5 years,
6 to 10 years,
More than 10 years
Example:
[]
years_of_experience
enum<string>[]
Available options:
Less than 1 year,
1 to 2 years,
3 to 5 years,
6 to 10 years,
More than 10 years
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>[]
Available options:
Public Company,
Privately Held,
Non Profit,
Educational Institution,
Partnership,
Self Employed,
Self Owned,
Government Agency
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>[]
Available options:
Owner/Partner,
CXO,
Vice President,
Director,
Experienced Manager,
Entry Level Manager,
Strategic,
Senior,
Entry Level,
In Training
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>[]
Available options:
Accounting,
Administrative,
Arts and Design,
Business Development,
Community and Social Services,
Consulting,
Education,
Engineering,
Entrepreneurship,
Finance,
Healthcare Services,
Human Resources,
Information Technology,
Legal,
Marketing,
Media and Communication,
Military and Protective Services,
Operations,
Product Management,
Program and Project Management,
Purchasing,
Quality Assurance,
Real Estate,
Research,
Sales,
Customer Success and Support
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>[]
Available options:
Arabic,
English,
Spanish,
Portuguese,
Chinese,
French,
Italian,
Russian,
German,
Dutch,
Turkish,
Tagalog,
Polish,
Korean,
Japanese,
Malay,
Norwegian,
Danish,
Romanian,
Swedish,
Bahasa Indonesia,
Czech
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