API di LinkedIn Sales Navigator: accesso, limiti e l'alternativa per gli sviluppatori

Ultima verifica: 13 ottobre 2026.

Punto chiave: SNAP non ha alcun endpoint che esegua una ricerca di persone con filtri, né esportazioni di ricerche salvate o liste di lead. Nemmeno un partner approvato potrebbe ricostruire una funzione di ricerca Sales Navigator con il solo SNAP. Se al tuo prodotto servono risultati di ricerca, SNAP non è mai stato lo strumento giusto.

Eseguire una ricerca di persone con filtri

Imposta api su sales_navigator e category su people (o companies), poi combina i filtri che ti servono. keywords è testo libero, tenure accetta un elenco di intervalli in anni, profile_language un elenco di codici lingua, e company accetta liste di ID aziendali da includere ed escludere. Un filtro industry con una lista di inclusione funziona allo stesso modo. Il parametro di query limit imposta la dimensione della pagina, fino a 100 risultati per Sales Navigator.

curl --request POST \
  --url "https://{YOUR_DSN}/api/v1/linkedin/search?account_id={ACCOUNT_ID}&limit=50" \
  --header "X-API-KEY: {YOUR_ACCESS_TOKEN}" \
  --header "accept: application/json" \
  --header "content-type: application/json" \
  --data '{
    "api": "sales_navigator",
    "category": "people",
    "keywords": "head of sales",
    "tenure": [{ "min": 3 }],
    "profile_language": ["en"],
    "company": { "include": [1441], "exclude": [1035] }
  }'

Riutilizzare l'URL di una ricerca salvata o di una lista di lead

Molti utenti costruiscono prima la ricerca in Sales Navigator. Invece di ricreare ogni filtro nella tua interfaccia, accetta l'URL che copiano dal browser: una pagina di risultati, una ricerca salvata o una lista di lead. Invialo nel campo url e la ricerca viene eseguita con i filtri già codificati in quel link.

{
  "url": "https://www.linkedin.com/sales/search/people?query=(...)"
}

Risolvere gli ID dei filtri

Filtri come località, aziende o settori si aspettano ID LinkedIn, non nomi. Cercali prima con l'endpoint dei parametri di ricerca, poi riutilizza i valori id restituiti nel corpo della ricerca. Il parametro type indica cosa stai cercando, qui una località.

curl --request GET \
  --url "https://{YOUR_DSN}/api/v1/linkedin/search/parameters?account_id={ACCOUNT_ID}&type=LOCATION&keywords=los%20angeles&limit=100" \
  --header "X-API-KEY: {YOUR_ACCESS_TOKEN}" \
  --header "accept: application/json"

# Response: { "object": "LinkedinSearchParametersList", "items": [{ "title": "...", "id": "..." }] }

Paginare con il cursore

Ogni risposta contiene un cursor. Passalo come parametro di query cursor della richiesta successiva e fermati quando raggiungi paging.total_count, il limite per ricerca descritto sotto o il numero di risultati che serve davvero alla tua funzione.

const BASE = "https://{YOUR_DSN}/api/v1/linkedin/search";
const headers = {
  "X-API-KEY": process.env.UNIPILE_API_KEY,
  "accept": "application/json",
  "content-type": "application/json",
};

export async function searchSalesNavigator(accountId, body, maxResults = 500) {
  const results = [];
  let cursor = null;

  do {
    const params = new URLSearchParams({ account_id: accountId, limit: "100" });
    if (cursor) params.set("cursor", cursor);

    const res = await fetch(`${BASE}?${params}`, {
      method: "POST",
      headers,
      body: JSON.stringify(body),
    });
    if (!res.ok) throw new Error(`Search failed: ${res.status}`);

    const page = await res.json();
    results.push(...page.items);
    cursor = page.cursor;

    const target = Math.min(page.paging.total_count, maxResults);
    if (results.length >= target) break;
  } while (cursor);

  return results;
}

// Example: the first 500 matches of a search the user built in your app
const leads = await searchSalesNavigator("{ACCOUNT_ID}", {
  api: "sales_navigator",
  category: "people",
  keywords: "head of sales",
});

Volume giornaliero: per le ricerche di persone in Sales Navigator, si consiglia di restare intorno ai 2.500 profili al giorno per account collegato. Una ricerca che supera le 2.500 persone richiede filtri più stretti, non più pagine: suddividila per località, settore o anzianità.

Ultima verifica: 13 ottobre 2026, sulla documentazione limiti e restrizioni dei provider .

Esempio: la tua app serve 20 commerciali, ognuno dei quali collega un account Sales Navigator Core. Le loro licenze restano sui rispettivi abbonamenti LinkedIn. Dal tuo lato, la fattura API è di 20 account connessi a $5,50, quindi $110 al mese, senza costi per ricerca o per messaggio. Tutte le fasce di volume sono sulla pagina prezzi dell'API Unipile.

Ultima verifica: 26 ottobre 2026, sulla pagina dei piani Sales Navigator di LinkedIn. I prezzi LinkedIn sono al netto delle imposte e possono variare a seconda della regione.

In pratica: se non sei già partner SNAP, la scelta è fatta. E se lo sei, SNAP comunque non ti dà i risultati di ricerca come dati: i prodotti che ne hanno bisogno usano il modello lato utente accanto alle funzioni della partnership.

Lista di lead verso il CRM

JDJane Doe, VP SalesAbbinato

AKAlex Kim, Head of GrowthNuovo

MLMaria Lopez, CRONuovo

Arricchimento del CRM da una lista di lead

Un commerciale incolla nel tuo CRM l'URL di una lista di lead Sales Navigator. La tua app la esegue per suo conto, abbina i risultati ai contatti esistenti e crea i record mancanti, ognuno con un link al profilo LinkedIn.

API di LinkedIn per software CRM

Ricerca di sourcing

"api": "sales_navigator"Vendite

"api": "recruiter"Selezione

SRSam Reed, Backend EngineerShortlist

ATS e piattaforme di recruiting

I recruiter hanno spesso una licenza Sales Navigator o Recruiter. Lo stesso endpoint passa dall'una all'altra con il campo api , così un ATS può offrire ricerche di sourcing dalla licenza che il recruiter ha collegato.

API di LinkedIn per ATS

Sequenza multicanale

Giorno 1: messaggio LinkedInStep 1

Giorno 3: email di follow-upStep 2

Giorno 6: risposta rilevataStop

Piattaforme di engagement multicanale

Gli strumenti di sequenze combinano LinkedIn ed email. Una ricerca costruisce il pubblico sulla licenza dell'utente, poi i messaggi partono via LinkedIn e via Gmail, Outlook o IMAP con l' API Email, per conto dello stesso utente.

API di LinkedIn per piattaforme di engagement

Sviluppi per agenti IA? Il server MCP di Sales Navigator offre agli agenti di coding le stesse ricerche, con lo stesso modello per utente.