Search for leads

Search for leads based on your Ideal Customer Profile (ICP). Retrieve leads by criteria or from specified companies.

Parallel requests limit: 50 requests

Recommended timeout: 100 seconds

Use Case:

Build a targeted list of prospects for outreach campaigns

Additional Information:

• 50 Parallel processing available (multiple threads)
• Supported locations:
  • List of Supported Locations.
  • In case of inputting a location which is not listed you will receive a ValidationError (free request), with Hint what location you need to edit.
• Personas rules: (see example request first)
  • Parent List contains a list of personas (list type).
  • 1 parameter is Name (string type) - required.
  • 2 parameter is Function (list of type strings) - required
    • If words like OR operator.
    • e.g. To look for all marketing and sales titles you have to create ["marketing", "sales"] function.
  • 3 parameter is Seniority (list of type strings) - optional (if not selected, you should pass it as [ ] (empty list) )
    • It works like Logical_conjunction: in conjunction with Functions looks for a 1-to-1 match
      • For example if Seniority passed are ["Head", "Manager"].
    • e.g. To look for such titles: Head of Marketing, Head of Sales, Manager of Marketing, Manager of Sales - you have to create ["marketing", "sales"] Function and ["Head", "Manager"] Seniority.
    • Expands
      • VP automatically search for [VP, SVP, EVP, GVP]
  • 4 parameter is Prohibit Keywords (list of type strings) - optional (if not selected, you should pass it as [ ] (empty list) )
    • When at least 1 of that keyword appears in the Job Title of lead, this lead will be filtered out.
  • In case of bad input you will receive a ValidationError (free request), with Hint what you need to edit.
  • More Persona Bad Examples and Good Practise you can see here
• limit_by rules:
  • Will return only N-strip of first leads that match input criteria
• company_link supported formats:
  • https://www.linkedin.com/company/reply-io
  • https://www.linkedin.com/company/reply-io/
  • linkedin.com/company/reply-io
  • https://in.linkedin.com/company/reply-io
  • http://linkedin.com/company/reply-io
  • linkedin.com/pub/…
  • linkedin.com/pub-profile/…
  • http://www.linkedin.com/pub-profile/…
  • https://www.linkedin.com/company/18584851 (sales id)
  • https://www.linkedin.com/sales/company/18584851
• company_types:
  • "Public Company", "Educational", "Self Employed", "Government Agency"
  • "Non Profit", "Self Owned", "Privately Held", "Partnership"
• By default Generect is able to search up to linkedin limits (2500 results)
• Parameter "company_locations" - companies headquarters locations
• Parameter "company_headcounts" - headcounts of companies, vars - ["1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10 000+"]
• Parameter "exclude_names" - skip leads by unformatted full name
• Parameter "filter_empty_vars" - skip leads if variables is empty/None/False
  • available - job_started_on, profile_photo, started_at_position, company_website
• Parameter "group" - list of groups id
• Parameter "schools" - list of schools id
• Parameter "past_company_names" - list of past company names
• Parameter "years_in_company" - list of ids by time in current company
• Parameter "years_in_position" - list of ids by time in current position
• Parameter "linkedin_filter_link" - allows you to use pre-built LinkedIn search URLs instead of specifying individual search criteria

Time ranges for "years_in_company" & "years_in_position":

1. “Less than 1 year”
2. “1 to 2 years”
3. “3 to 5 years”
4. “6 to 10 years”
5. “More than 10 years”

LinkedIn Filter Link Usage

The linkedin_filter_link parameter allows you to use a pre-built LinkedIn search URL instead of manually specifying individual search criteria. This is particularly useful when you have complex search filters already configured in LinkedIn.

Supported LinkedIn URLs:

• Sales Navigator People Search: https://www.linkedin.com/sales/search/people?query=...
• Regular LinkedIn People Search: https://www.linkedin.com/search/results/people/?keywords=...

How it works:

1. Create your desired search in LinkedIn (Sales Navigator or regular search)
2. Copy the URL from the browser address bar
3. Use this URL as the linkedin_filter_link parameter
4. The API will extract and apply the search filters from your URL

Usage Example:

{
  "linkedin_filter_link": "https://www.linkedin.com/sales/search/people?query=(spellCorrectionEnabled%3Atrue%2Ckeywords%3Amarketing%2CfirstName%3A%2ClastName%3A%2Ctitle%3A%2Ccompany%3A%2Cschool%3A%2CcontactInterest%3A%2CnetworkDepth%3A%2Clanguage%3A%2Clocation%3A%2Cindustry%3A%2CcurrentCompany%3A%2CpastCompany%3A%2CprofileLanguage%3A%2CnonprofitInterest%3A%2CfortuneOrGlobal500Size%3A%2CsalesPersona%3A)",
  "limit_by": 100
}

Important Notes:

• When using linkedin_filter_link, you don’t need to specify other filter parameters (locations, company_name, personas, etc.)
• Maximum limit when using linkedin_filter_link is 2400 results
• The URL must contain valid query parameters that can be parsed
• Both Sales Navigator and regular LinkedIn search URLs are supported

Search by Company Name

You can search for leads by specifying the company name directly:

{
  "company_name": "Microsoft",
  "personas": [
    ["Marketing", ["marketing", "digital marketing"], [], []]
  ],
  "limit_by": 50
}

Important Notes for Company Search:

• You must specify exactly one of: company_id, company_link, or company_name
• The API will automatically find the LinkedIn company profile based on the provided information
• If no exact company match is found, the search may return an error or empty results

Search by Lead Criteria Only

For lead searches based purely on lead parameters without targeting a specific company, use the without_company parameter:

{
  "without_company": true,
  "locations": ["New York, New York, United States"],
  "personas": [
    ["Tech Leaders", ["CTO", "VP Engineering", "Tech Director"], ["VP", "Director"], []]
  ],
  "limit_by": 100
}

How Lead Criteria Search Works:

1. Searches for leads based only on their individual characteristics (job titles, locations, experience, etc.)
2. Does not require specifying any company information (company_id, company_link, or company_name)
3. Useful for finding leads across all companies that match specific criteria
4. Higher limit of 2400 results available
5. May have usage restrictions based on your account plan

Important Notes for Lead Criteria Search:

• without_company: true removes the requirement to specify company information
• Search is performed based entirely on lead parameters: personas, locations, seniority levels, etc.
• Maximum limit of 2400 results when using this mode
• May have daily usage limits depending on your subscription
• Cannot be used together with company_id, company_link, or company_name
• Ideal for broad prospecting across multiple companies based on lead profiles

Authorizations

Authorization · string · header · required

Body

application/json

company_link · string

company_id · integer

locations · string[]

personas · (string | string[])[][]

Show child attributes

limit_by · integer

exclude_names · string[]

filter_empty_vars · string[]

changed_jobs · boolean

posted_on_linkedin · boolean

mentioned_in_news · boolean

lead_industries · string[]

company_locations · string[]

company_headcounts · string[]

company_types · string[]

past_company_names · string[]

years_in_company · integer[]

years_in_position · integer[]

groups · integer[]

schools · integer[]

linkedin_filter_link · string

without_company · boolean

Response

200 - application/json

amount · number

Example:

leads · object[]

Show child attributes

Example:

results_count · string

Example:

status · string

Example: