Turn a filter into an ICP-tight audience.
People search, company search, and the list endpoints behind Sales Navigator — on our managed seats or your own.
Edges is not related to LinkedIn and is not an official LinkedIn product.
// Search surfaces
Three ways to build an audience.
Standard LinkedIn, Sales Navigator, and Recruiter — surfaced behind one query grammar. Point at the tier your seats already have.
People search
Search profiles by title, seniority, geography, company, and keyword. Cursor-paginated, deduped, and ready to pipe into enrichment.
- POSTsearch-peoplelinkedin
- POSTsearch-peoplesales nav
- POSTsearch-peoplerecruiter
Company search
Find accounts by industry, headcount band, geography, and growth. The firmographic filters that map to your ICP definition.
- POSTsearch-companieslinkedin
- POSTsearch-companiessales nav
- POSTsearch-company-employeessales nav
Saved lists
Pull the lead lists and account lists your team already curates in Sales Navigator — as structured, paginated JSON on every run.
- POSTextract-leads-listsales nav
- POSTextract-accounts-listsales nav
- POSTsearch-metricssales nav
// The request
Each surface takes its own input.
Filters live inside a LinkedIn search URL — pass the one for the surface you're on. The row shape and cursor pagination are shared.
// POST /v1/actions/salesnavigator-search-people/run/live
{
"input": {
"sales_navigator_profile_search_url":
"https://www.linkedin.com/sales/search/people?…"
},
"identity_ids": ["id_9f2a"],
"identity_mode": "auto"
}// → 200 · next page via X-Pagination-Next
{
"items": {
"full_name": "Jane Doe",
"job_title": "VP Sales",
"company_name": "Acme",
"linkedin_profile_url": "in/janedoe",
"connection_degree": "2nd"
}
}// The pattern
Search → dedupe → enrich → sync.
Every list you build feeds the rest of the API. The search endpoints hand you profile and company IDs; enrichment and signals take it from there.
- 1
Build the search URL
Compose the filters in LinkedIn, Sales Nav, or Recruiter and pass the resulting search URL for that surface.
- 2
Page the results
Follow the
X-Pagination-Nextheader until it stops appearing. Every row carries a stable profile ID. - 3
Enrich the rows
Pipe IDs into the enrichment API for contact, experience, and firmographics — one payload per row.
- 4
Sync & subscribe
Push to your CRM or warehouse, then subscribe the audience to signals so it stays current.
// Playbooks
What teams build with search.
The list is the starting point. The value is what runs downstream of it.
ICP audience refresh
Re-run a saved search on a schedule so your outbound list matches the ICP as the market moves — no manual exports.
TAM sizing
Company search across headcount and industry bands gives a defensible total-addressable-market count in minutes.
List → warehouse
Pull Sales Nav lead and account lists into BigQuery or Snowflake as structured rows, deduped on every run.
Persona segmentation
Split one search into title-based personas, then route each to a different sequence or owner automatically.
Account expansion
From a won account, search company employees to find the next buying committee — same firmographics, new contacts.
Enrich-on-match
Only spend credits on rows that clear your filters. Search server-side, enrich the matches, skip the rest.
// FAQ
Search, answered.
Filter grammar, pagination, and per-surface limits are in the docs.
Which surface should I use?
Standard LinkedIn for breadth, Sales Navigator for richer filters and saved lists, Recruiter for talent search. Point at whichever tier your seats hold — the query shape is identical.
How does pagination work?
Leave the cursor empty on the first call, then follow the X-Pagination-Next header (or pass its cursor) until it stops appearing. Cursors expire after 24 hours.
Can I bind to a saved search?
Yes — reference a Sales Navigator saved search or lead/account list by ID and Edges paginates the whole thing for you, no filters needed inline.
Are results enrichment-ready?
Every row carries a stable profile or company ID. Pipe it straight into the enrichment API for full contact, experience, and firmographic payloads.
What does search cost?
Search pages are billed per returned page, not per filter. Enrichment of matched rows is billed separately — so you only pay to enrich what clears your ICP.
How fresh are the results?
Searches run live against LinkedIn on every call, so results reflect the current index — not a stale snapshot from a static database.
Build the exact list. Enrich the matches.
Point a filter at Sales Navigator and page the first thousand rows free.