Data catalog / leads

Leads data

Advanced LinkedIn lead search with 30+ filters, including seniority, function, geography, and Sales Navigator URL support.

In short: RichAPI POST /lead_search searches LinkedIn people with Sales Navigator-style filters: current and past job titles, seniority, function, industry, company size, company headquarters, current and past companies, schools, geography, profile language, years of experience, years at current company, recently changed jobs, a fuzzy search_query, and exclusion versions of most filters. It also accepts a full sales_nav_url. Filter labels come from POST /search_reference_data, which is free. Pagination uses page plus a session_id you generate. Billing is 10 credits per call plus 0.5 credits per result.

Last updated October 13, 2026

People search with Sales Navigator filters

POST /lead_search finds LinkedIn members with the filters sales teams use in Sales Navigator: current and past job titles, seniority, function, industry, company size, company headquarters, current and past employers, schools, geography, profile language, years of experience, years at the current company, and whether the person changed jobs recently. Most filters have an exclude_ version, so you can ask for "VPs of Sales at software companies, not at these 40 customers".

If you already built the search in Sales Navigator, pass its URL as sales_nav_url. You can add individual filters on top of it.

Each result carries firstName, lastName, linkedinUrl, location and an openProfile flag.

Get the filter labels right

Seniority, function, industry and company size take LinkedIn's own labels, which the API converts to LinkedIn IDs. A label LinkedIn does not use matches nothing. Call POST /search_reference_data first. It is free, takes no input, and returns every valid label for seniority, function, industry, company size and geography.

For locations, geo_ids is more precise than locations. POST /geo_id_search turns a place name such as "London" into its LinkedIn geo ID for 0.01 credits.

Endpoints and rates

Endpoint What it does Credits Billed
/lead_search Advanced LinkedIn lead search with 30+ filters including seniority, function, geography, company, title, Sales Navigator URL, and exclusion filter support. 10 + 0.5 per result per call + per result
/search_reference_data Returns all valid filter labels (seniority levels, industries, functions, etc.) for use with Lead Search. 0 free
/geo_id_search Resolve a location name to a LinkedIn Geo ID for use with profile and lead search filters. 0.01 per call

Rates are read from the live OpenAPI spec. Credits are prepaid and never expire, and the price of a credit depends on your package: see pricing.

What lead search costs

10 credits per call plus 0.5 credits per person returned. A page with 25 people costs 10 + 25 × 0.5 = 22.5 credits. The 10-credit base is charged on every call, including one that matches nobody, so check a new filter set on one page before you page through thousands.

People search costs 0.1 credits per result with no base charge, which is five times cheaper per row. Use it when titles, industry, location, company domain and headcount are enough. Use lead search when you need seniority, function, tenure, job changes, exclusions or a Sales Navigator URL.

Paging through results

Generate one random string, a UUID works, and send it as session_id with every page of the same search. It keeps the pages on the same scraping resource, so page 2 continues page 1. Count page from 1.

Then the usual chain: find emails with the email finder and check them with the email verifier. Turn a hiring post into a contactable list and List build and verify show the full sequence.

Reference

company_headquarter_locationsarray of object · Optional
Company headquarters location filters.
company_sizearray of object · Optional
Company size ranges.
current_companiesarray of object · Optional
Current company LinkedIn URLs or IDs.
current_job_titlesarray of object · Optional
Current job title filters.
exclude_company_headquarter_locationsarray of object · Optional
Company headquarters locations to exclude.
exclude_current_companiesarray of object · Optional
Current company LinkedIn URLs or IDs to exclude.
exclude_current_job_titlesarray of object · Optional
Current job titles to exclude.
exclude_functionsarray of object · Optional
Job function labels to exclude.
exclude_geo_idsarray of object · Optional
LinkedIn geo IDs or location names to exclude.
exclude_industriesarray of object · Optional
Industry labels to exclude.
exclude_locationsarray of object · Optional
Location text values to exclude.
exclude_past_companiesarray of object · Optional
Past company LinkedIn URLs or IDs to exclude.
exclude_past_job_titlesarray of object · Optional
Past job titles to exclude.
exclude_schoolsarray of object · Optional
School LinkedIn URLs or IDs to exclude.
exclude_seniorityarray of object · Optional
Seniority labels to exclude.
first_namesarray of object · Optional
First name filters.
functionsarray of object · Optional
Job function labels resolved to LinkedIn functionIds.
geo_idsarray of object · Optional
LinkedIn geo IDs or location names
industriesarray of object · Optional
Industry labels resolved to LinkedIn industryIds.
last_namesarray of object · Optional
Last name filters.
locationsarray of object · Optional
Location names
pageinteger · Optional
Positive page number for pagination. Defaults to 1.
past_companiesarray of object · Optional
Past company LinkedIn URLs or IDs.
past_job_titlesarray of object · Optional
Past job title filters.
profile_languagesarray of object · Optional
Profile language labels resolved to language codes.
recently_changed_jobsboolean · Optional
Filter for people who recently changed jobs.
sales_nav_urlstring · Optional
Full LinkedIn Sales Navigator search URL. May be combined with individual filters.
schoolsarray of object · Optional
School LinkedIn URLs or IDs.
search_querystring · Optional
Fuzzy keyword search.
seniorityarray of object · Optional
Seniority labels resolved to LinkedIn seniorityLevelIds.
session_idstring · Optional
Optional unique ID used to keep pagination requests on the same scraping resource. Generate a random string (for example, a UUID) and send the same value with each page request
years_at_current_companyarray of object · Optional
Tenure range labels resolved to LinkedIn yearsAtCurrentCompanyIds.
years_of_experiencearray of object · Optional
Experience range labels resolved to LinkedIn yearsOfExperienceIds.

Request

Minimum required parameters for a leads data call.

Request
{
  "current_job_titles": [
    "Head of Sales",
    "VP Sales"
  ],
  "seniority": [
    "Director",
    "Vice President"
  ],
  "industries": [
    "Software Development"
  ],
  "company_headquarter_locations": [
    "United States"
  ],
  "recently_changed_jobs": true,
  "page": 1,
  "session_id": "4f9d2c71-8b3e-4e0a-9a51-2d6c0e7b1f38"
}

See it in a workflow

Playbooks

Real patterns, recipes, and prompts other builders run on RichAPI

Start free with 100 credits

Developer Docs

Auth, request shape, and error handling

See Documentation

FAQ

Frequently asked questions

Advanced LinkedIn lead search with 30+ filters, including seniority, function, geography, and Sales Navigator URL support.
Every endpoint is billed from the same credit pool, at the published rate on /pricing — never a separate contract per endpoint.
Yes — the same endpoint is reachable from an MCP client (Claude, ChatGPT, Cursor, Windsurf) using the same key and credit pool. See /mcp.

Related data