Leads Database API
Search a database of 587 million professional profiles and 55 thousand investors by country, job function, seniority, industry, technology and contact availability.
Faceted search and identifier lookup over a standalone leads database — 587,191,569 profiles, 22,288,004 companies and 54,954 investors.
This is a different database from the rest of the API. Nothing here reads or writes your workspace, your LinkedIn accounts, or your campaigns, and no request touches LinkedIn. Results come from a stored dataset, so no account is used and no rate limit is consumed.
How it fits your workflow
The leads database is a catalogue you browse, not a system of record. Search it, select the people you want, and import them — at which point they become ordinary contacts in your workspace and every other API applies. The two halves meet exactly once, at import.
Browse (Leads API) → Import → Campaigns, messaging, contacts (rest of the API)The join key back to your workspace is linkedInUrl.
Endpoints
Search Profiles →
GET /leads/search
Faceted search over 587M profiles. Filter by country, job function, seniority, industry, connections, company size, revenue, technologies and contact availability. Returns opaque cursors for pagination.
List Facet Values →
GET /leads/facet-values
The known values for any facet — job levels, industries, technologies, cities — most common first, with counts and a substring search for type-ahead. GET /leads/facets names the parameters; this says what each accepts. Together they are enough to build a filter UI without hard-coding anything.
Describe Facets →
GET /leads/facets
Every filterable parameter, its type, whether it can be counted, and which filter combinations are servable. Static and free — it never touches the database.
Enrich a Person →
POST /leads/enrich
Resolve one email address or LinkedIn URL against both collections. Makes no external call and consumes no credits — it is a lookup in the stored dataset.
Search Investors →
GET /leads/investors
Faceted search over VC firms and individual investors. Filter by stage, sector, cheque size, geography and type. Unlike profile search this returns live, filter-aware counts and a real total.
Two things to know before you start
Filters must be servable. Profile search refuses any filter combination that would scan the whole collection, returning 400 unindexed_filter with the combinations that do work. This protects response times; it is not a bug. See the Facets Reference.
Counts are precomputed. The facets block on a search response is not a count of your result set — it is a precomputed tally, labelled with the scope it was computed over. See Facets Reference.
Responses carry no identifiers
No _id, orgId or personId is ever returned. Pagination cursors encode an offset, never a document id, and are signed and bound to the filter that produced them — a cursor cannot be altered or replayed against a different query.
API Overview
Complete guide to the ConnectSafely API including authentication, rate limits, error handling, and endpoint groups for LinkedIn automation and data retrieval.
Facets Reference
Every filterable facet on the leads database - profiles and investors - with types, countability, servable filter combinations and how precomputed counts are scoped.
