Search database leads
Search cached leads. Database mode returns results in under 1 second. Billed per result returned.
Use Case:
Search cached lead data with fast database filters.Pricing
This is a billable endpoint — you are charged for each result returned. If no results are found, the request is free.Authorizations
Use the required Token prefix. Example: Authorization: Token xxxxxxxxx
Body
Job titles held by the people you want to find. A lead only needs to match one of the titles you provide — adding more expands your search. Results may also include similar titles (e.g. "marketing manager" can return "content marketing manager"). Combine with seniorities to target both function and level. Examples: "sales development representative", "marketing manager", "software engineer".
Job seniority levels at the lead's current employer (current position only, not previous roles). A lead needs to match at least one; adding more values expands your search. Allowed values: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. Combine with job_titles to narrow targeting.
Geographic locations where leads currently live — matches across cities, states/regions and countries. A lead needs to match at least one. To filter by the employer's HQ location, use company_locations. Examples: "San Francisco, California, United States", "Germany", "London".
Locations to exclude from results.
Headquarters location of the lead's current employer; a lead is included if their company's HQ matches at least one. Filters by where the company is based — distinct from locations, which is where the lead personally lives.
Company locations to exclude.
Industries of the lead's current employer; a lead is included if their company matches at least one. Values follow LinkedIn's industry taxonomy. Examples: "Software Development", "Financial Services", "Information Technology".
Company industries to exclude.
Size of the lead's current employer, as employee-count ranges; a lead is included if their company falls into at least one. Allowed values: "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+".
Company size ranges to exclude.
Company types: "Public Company", "Privately Held", "Non Profit", "Government Agency", "Educational", "Self Employed", "Partnership", "Self Owned".
Target company name (mutually exclusive with company_link and company_id).
LinkedIn company URL (mutually exclusive with company_name and company_id).
LinkedIn company numeric ID (mutually exclusive with company_name and company_link).
Search by lead criteria only, without targeting a specific company.
List of persona tuples. Each persona: [name, functions, seniorities, prohibits, priority?].
Skip leads by full name.
Skip leads by Sales Navigator ID.
Skip leads where these fields are empty. Options: job_started_on, profile_photo, started_at_position, company_website.
Maximum number of leads to return.
Number of leads to skip (for pagination).
Fields to apply strict matching on (e.g. "company_locations").