SalesNav

Voyager provides direct access to LinkedIn Sales Navigator’s internal APIs. SalesNav endpoints offer richer data, advanced filters, and capabilities beyond the standard LinkedIn API — lead search with 28 structured filters, account dossiers, employee insights, relationship maps, personas, alerts, messaging, credits, and more.

SalesNav endpoints require an active Sales Navigator subscription on your LinkedIn account. You must sync the li_a and li_ep_auth_context cookies in addition to the standard li_at and JSESSIONID cookies.

Every Voyager response is wrapped in the standard envelope { success, statusCode, message, data, errors }. The JSON examples below show only the endpoint-specific payload — access res.data.<field> in your client. See Introduction for the full envelope shape.

Prerequisites

Required Cookies

Cookie	Purpose
`li_at`	Standard LinkedIn auth
`JSESSIONID`	Standard LinkedIn session
`li_a`	SalesNav authentication token
`li_ep_auth_context`	Enterprise profile context (base64-encoded enterprise profile URN)

Verify SalesNav Access

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/session/capabilities"

Check that salesNavSessionValid: true in the response.

SalesNav Health Check

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/health"

Search Leads

Search for leads by keyword or by SalesNav search URL:

$ # By keywords
$ curl -X POST "$BASE/api/salesnav/search" \
>   -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "keywords": "VP Engineering fintech London",
>     "maxResults": 25
>   }'

1 {
2   "success": true,
3   "data": [
4     {
5       "fullName": "Jane Smith",
6       "title": "VP Engineering",
7       "company": "FinCorp",
8       "location": "London, United Kingdom",
9       "connectionDegree": "2ND",
10       "leadId": "ACwAABCD1234",
11       "profileUrl": "https://www.linkedin.com/in/janesmith/"
12     }
13   ]
14 }

By SalesNav URL

If you have a pre-built SalesNav search URL with advanced filters:

$ curl -X POST "$BASE/api/salesnav/search" \
>   -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "searchUrl": "https://www.linkedin.com/sales/search/people?query=...",
>     "maxResults": 50
>   }'

Get Lead Profile

Get a detailed SalesNav lead profile (async job):

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/leads/ACwAABCD1234"

Returns { jobId, pollUrl } — poll for the result:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/jobs/JOB_ID"

Lead Timeline

Get a lead’s activity history (job changes, posts, mentions):

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/leads/ACwAABCD1234/timeline?count=10"

Lead Insights

Get a lead’s posts and comments for conversation intelligence:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/leads/ACwAABCD1234/insights"

Account (Company) Profile

Get detailed company data from SalesNav (async job):

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/accounts/12345678"

Account Employees

Get employees of a SalesNav account (async job):

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/accounts/12345678/employees?limit=50"

Saved Lists

Export leads from a SalesNav saved list (async job):

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/lists/LIST_ID?limit=100"

Alerts

Get SalesNav alerts (job changes, post activity, company news):

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/alerts?start=0&count=25"

SalesNav Inbox

Read your SalesNav messages (separate from LinkedIn inbox):

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/inbox?start=0&count=20"

Profile Viewers

See who viewed your SalesNav profile:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/viewers?start=0&count=20"

Batch Operations

Batch Lead Profiles

Fetch up to 10 lead profiles in a single async job:

$ curl -X POST "$BASE/api/salesnav/leads/read" \
>   -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   -H "Content-Type: application/json" \
>   -d '{"leads": [{"leadId": "ACwAABCD1234"}, {"leadId": "ACwAAEFGH5678"}]}'

Batch Account Profiles

Fetch up to 5 account profiles:

$ curl -X POST "$BASE/api/salesnav/accounts/read" \
>   -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   -H "Content-Type: application/json" \
>   -d '{"accounts": [{"accountId": "12345678"}, {"accountId": "87654321"}]}'

Batch List Export

Export multiple saved lists:

$ curl -X POST "$BASE/api/salesnav/lists/read" \
>   -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   -H "Content-Type: application/json" \
>   -d '{"lists": [{"listId": "abc123"}, {"listId": "def456"}], "limit": 100}'

Account Intelligence

Account Dossier

Get AI-generated competitive landscape, challenges, and strengths:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/companies/12345678/dossier"

Returns competitive analysis, company challenges, and strategic insights.

Employee Insights

Track headcount growth/decline over time:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/companies/12345678/insights"

Returns monthly headcount timeseries data (e.g., 57 → 110 employees, +93% growth).

Similar Companies

Find lookalike companies:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/companies/12345678/similar"

Relationship Map

Get org chart data for an account:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/companies/12345678/relationship-map"

Buyer Personas

Get configured ICP buyer personas:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/personas"

Job Change Triggers

Get lead insights including recent job changes:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/leads/ACwAABCD1234/job-changes"

InMail Credits

Check your remaining InMail credit balance:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/credits"

SalesNav Read Receipts

Check if a SalesNav message was read:

$ curl -H "Authorization: Bearer $KEY" \
>   -H "X-User-Id: $USER" \
>   "$BASE/api/salesnav/inbox/THREAD_ID/seen"

SalesNav API Architecture

Under the hood, Voyager uses LinkedIn’s sales-api endpoints:

All requests go to https://www.linkedin.com/sales-api/salesApi*
Decoration parameters use URL-encoded parentheses (%28/%29)
The x-li-identity header is derived from the li_ep_auth_context cookie
Search uses the salesApiLeadSearch endpoint with q=searchQuery

SalesNav has its own API layer separate from the standard LinkedIn Voyager API. Response formats, URN schemes, and rate limits differ. SalesNav lead IDs are not the same as standard LinkedIn profile URNs.

Lead Discovery Guide — SalesNav-powered lead pipeline
Async Jobs — Polling for SalesNav job results
Sessions — SalesNav cookie requirements

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/session/capabilities"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/health"

$	# By keywords
$	curl -X POST "$BASE/api/salesnav/search" \
>	-H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"keywords": "VP Engineering fintech London",
>	"maxResults": 25
>	}'

1	{
2	"success": true,
3	"data": [
4	{
5	"fullName": "Jane Smith",
6	"title": "VP Engineering",
7	"company": "FinCorp",
8	"location": "London, United Kingdom",
9	"connectionDegree": "2ND",
10	"leadId": "ACwAABCD1234",
11	"profileUrl": "https://www.linkedin.com/in/janesmith/"
12	}
13	]
14	}

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/leads/ACwAABCD1234"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/jobs/JOB_ID"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/leads/ACwAABCD1234/timeline?count=10"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/leads/ACwAABCD1234/insights"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/accounts/12345678"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/accounts/12345678/employees?limit=50"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/lists/LIST_ID?limit=100"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/alerts?start=0&count=25"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/inbox?start=0&count=20"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/viewers?start=0&count=20"

$	curl -X POST "$BASE/api/salesnav/leads/read" \
>	-H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	-H "Content-Type: application/json" \
>	-d '{"leads": [{"leadId": "ACwAABCD1234"}, {"leadId": "ACwAAEFGH5678"}]}'

$	curl -X POST "$BASE/api/salesnav/accounts/read" \
>	-H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	-H "Content-Type: application/json" \
>	-d '{"accounts": [{"accountId": "12345678"}, {"accountId": "87654321"}]}'

$	curl -X POST "$BASE/api/salesnav/lists/read" \
>	-H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	-H "Content-Type: application/json" \
>	-d '{"lists": [{"listId": "abc123"}, {"listId": "def456"}], "limit": 100}'

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/companies/12345678/dossier"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/companies/12345678/insights"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/companies/12345678/similar"

SalesNav

Prerequisites

Required Cookies

Verify SalesNav Access

SalesNav Health Check

Search Leads

By SalesNav URL

Get Lead Profile

Lead Timeline

Lead Insights

Account (Company) Profile

Account Employees

Saved Lists

Alerts

SalesNav Inbox

Profile Viewers

Batch Operations

Batch Lead Profiles

Batch Account Profiles

Batch List Export

Account Intelligence

Account Dossier

Employee Insights

Similar Companies

Relationship Map

Buyer Personas

Job Change Triggers

InMail Credits

SalesNav Read Receipts

SalesNav API Architecture

Related

SalesNav

Prerequisites

Required Cookies

Verify SalesNav Access

SalesNav Health Check

Search Leads

By SalesNav URL

Get Lead Profile

Lead Timeline

Lead Insights

Account (Company) Profile

Account Employees

Saved Lists

Alerts

SalesNav Inbox

Profile Viewers

Batch Operations

Batch Lead Profiles

Batch Account Profiles

Batch List Export

Account Intelligence

Account Dossier

Employee Insights

Similar Companies

Relationship Map

Buyer Personas

Job Change Triggers

InMail Credits

SalesNav Read Receipts

SalesNav API Architecture

Related

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/companies/12345678/relationship-map"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/personas"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/leads/ACwAABCD1234/job-changes"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/credits"

$	curl -H "Authorization: Bearer $KEY" \
>	-H "X-User-Id: $USER" \
>	"$BASE/api/salesnav/inbox/THREAD_ID/seen"