Facebook Pixel
APILeads Database

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.

On this page