Sales Navigator API
LinkedIn Sales Navigator endpoints supported by ConnectSafely — lead and account search, SSI score, InMail credits, and auto-detected conversations. Requires an active Sales Navigator subscription on the LinkedIn account.
The ConnectSafely Sales Navigator API exposes LinkedIn Sales Navigator–specific functionality: Lead Search, Account Search, the Social Selling Index (SSI), InMail credits, and auto-detected conversation routing. These endpoints require a LinkedIn account with an active Sales Navigator seat.
Why Use the Sales Navigator API?
- Advanced Search — Run Lead Search and Account Search using full Sales Navigator filters by passing a Sales Navigator URL
- Social Selling Index (SSI) — Track SSI score with per-pillar breakdown and industry/network percentile rank
- InMail Credits — Get a full credits breakdown (available, used, total) for Sales Navigator accounts
- Auto-Detection — Several conversation endpoints auto-detect Sales Nav accounts and route through Sales Nav APIs transparently
Requirements
| Requirement | Notes |
|---|---|
| Active Sales Navigator seat | Required for /ssi, /inmail/credits, and Sales Nav search URLs |
| Authentication | Bearer token via Authorization: Bearer <your_api_key> |
| Account ID | Most endpoints accept an accountId query/body parameter to target a specific connected LinkedIn account |
Sales Navigator Endpoints
Click on any endpoint below to view detailed documentation, parameters, example requests, and try it live in the interactive playground.
Search (Sales Navigator URLs)
The standard People and Company search endpoints accept a Sales Navigator search URL via the url parameter, which switches the underlying engine to Sales Navigator Lead Search or Account Search with full filter support (revenue, employees, seniority, etc.).
Search people (Sales Navigator Lead Search) →
POST /linkedin/search/people
Pass a Sales Navigator URL (containing /sales/search/people) in the url field to use Sales Navigator Lead Search instead of regular LinkedIn search. Rate limit: 300 searches per account per month. Maximum 1000 results per search.
Search companies (Sales Navigator Account Search) →
POST /linkedin/search/companies
Pass a Sales Navigator company search URL (containing /sales/search/company) in the url field to use Sales Navigator Account Search with advanced filters like revenue and employee count. Rate limit: 300 searches per account per month.
Analytics & Account
Get Social Selling Index (SSI) →
GET /linkedin/ssi
Get the Sales Navigator Social Selling Index for a LinkedIn account. Returns the overall SSI score (0–100), per-pillar breakdown (Professional Brand, Find Right People, Insight Engagement, Strong Relationship) with industry and network averages, and rank percentile within the account's industry and network.
Get InMail credits →
GET /linkedin/inmail/credits
Get the InMail credits balance. For Sales Navigator accounts, returns a full breakdown including availableCredits, usedCredits, and totalCredits. Auto-detects account type (Sales Navigator, Business Premium, Recruiter, Free).
Conversations (with Sales Nav auto-detection)
The standard LinkedIn Messaging API endpoints automatically detect Sales Navigator accounts and route through the Sales Nav APIs — no extra work required on your side.
| Endpoint | Sales Nav Behavior |
|---|---|
GET /conversations | Auto-merges Sales Nav threads into the standard conversation list. Each item includes a source: "sales_navigator" field and a salesNavThreadId |
GET /conversations/{conversationUrn}/messages | Auto-detects Sales Nav thread URNs (urn:li:salesNav_thread:*) and serves messages via the Sales Nav API |
POST /conversations/send | Auto-detects Sales Nav accounts and routes through the Sales Nav messaging API. Returns a threadId for Sales Nav sends |
Use Cases
- Sales Prospecting — Run targeted Lead Search with Sales Navigator filters (seniority, function, company size, geography) and message qualified leads
- Account-Based Marketing — Use Account Search with revenue and headcount filters to identify and engage target accounts
- CRM Sync — Copy outbound messages to your CRM with
copyToCrm: true - Sales Coaching — Track SSI score and per-pillar breakdown to coach reps on Social Selling performance
- Outreach Capacity Planning — Monitor InMail credits across accounts before launching campaigns
Notes
- Endpoints under
/ssiand Sales Nav search URLs will return a 400/error response if the LinkedIn account does not have an active Sales Navigator seat. - The
premiumTypefield on InMail credits and error responses identifies the account type (SALES_NAVIGATOR,BUSINESS_PREMIUM,RECRUITER,FREE,UNKNOWN). - The standard
/conversationsendpoints transparently handle both standard and Sales Nav threads — no special handling needed.
Get Social Selling Index (SSI)
Get the Sales Navigator Social Selling Index (SSI) for a LinkedIn account. Returns the overall SSI score (0-100), per-pillar breakdown with industry and network averages, and rank percentile within the account's industry and network. Requires a LinkedIn account with Sales Navigator access to the SSI dashboard.
Search People (Lead Search)
Next Page