API do LinkedIn Sales Navigator: acesso, limites e a alternativa para desenvolvedores

Última verificação: 13 de outubro de 2026.

Ponto-chave: O SNAP não tem endpoint que faça uma busca de pessoas com filtros, nem exportação de buscas salvas ou listas de leads. Nem um parceiro aprovado conseguiria reconstruir um recurso de busca do Sales Navigator só com o SNAP. Se o seu produto precisa de resultados de busca, o SNAP nunca foi a ferramenta certa.

Fazer uma busca de pessoas com filtros

Defina api como sales_navigator e category como people (ou companies) e combine os filtros de que precisa. keywords é texto livre, tenure recebe uma lista de faixas em anos, profile_language uma lista de códigos de idioma, e company recebe listas de IDs de empresas para incluir e excluir. Um filtro industry com lista de inclusão funciona do mesmo jeito. O parâmetro de query limit define o tamanho da página, até 100 resultados no 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] }
  }'

Reutilizar a URL de uma busca salva ou lista de leads

Muitos usuários montam a busca primeiro no Sales Navigator. Em vez de recriar cada filtro na sua interface, aceite a URL que eles copiam do navegador: uma página de resultados, uma busca salva ou uma lista de leads. Envie-a no campo url e a busca roda com os filtros já codificados nesse link.

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

Resolver IDs de filtros

Filtros como localizações, empresas ou setores esperam IDs do LinkedIn, não nomes. Consulte-os primeiro no endpoint de parâmetros de busca e reutilize os valores id retornados no corpo da busca. O parâmetro type indica o que você procura, aqui uma localização.

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": "..." }] }

Paginar com o cursor

Cada resposta traz um cursor. Passe-o como parâmetro de query cursor da próxima requisição e pare ao atingir paging.total_count, o limite por busca descrito abaixo ou o número de resultados de que o seu recurso realmente precisa.

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 diário: para buscas de pessoas no Sales Navigator, a recomendação é ficar em torno de 2.500 perfis por dia por conta vinculada. Uma busca com mais de 2.500 pessoas precisa de filtros mais estreitos, não de mais páginas: divida por localização, setor ou tempo de casa.

Última verificação: 13 de outubro de 2026, com base na documentação de limites e restrições dos provedores .

Exemplo: o seu app atende 20 vendedores que vinculam, cada um, uma conta Sales Navigator Core. As licenças deles continuam nas próprias assinaturas do LinkedIn. Do seu lado, a fatura da API é de 20 contas conectadas a $5,50, ou seja, $110 por mês, sem taxa por busca nem por mensagem. Veja todas as faixas de volume na página de preços da API Unipile.

Última verificação: 26 de outubro de 2026, com base na página de planos do Sales Navigator do LinkedIn. Os preços do LinkedIn não incluem impostos e podem variar por região.

Na prática: se você ainda não é parceiro do SNAP, a escolha está feita. E se é, o SNAP continua sem entregar resultados de busca como dados: produtos que precisam deles usam o modelo do lado do usuário junto com os recursos da parceria.

Lista de leads para o CRM

JDJane Doe, VP SalesVinculado

AKAlex Kim, Head of GrowthNovo

MLMaria Lopez, CRONovo

Enriquecimento do CRM a partir de uma lista de leads

Um vendedor cola no seu CRM a URL de uma lista de leads do Sales Navigator. O seu app a executa em nome dele, cruza os resultados com contatos existentes e cria os registros que faltam, cada um com link para o perfil do LinkedIn.

API do LinkedIn para software de CRM

Busca de sourcing

"api": "sales_navigator"Vendas

"api": "recruiter"Contratação

SRSam Reed, Backend EngineerPré-seleção

ATS e plataformas de recrutamento

Recrutadores costumam ter uma licença do Sales Navigator ou do Recruiter. O mesmo endpoint alterna entre os dois pelo campo api , então um ATS pode oferecer buscas de sourcing a partir da licença que o recrutador vinculou.

API do LinkedIn para ATS

Sequência multicanal

Dia 1: mensagem no LinkedInEtapa 1

Dia 3: email de follow-upEtapa 2

Dia 6: resposta detectadaParar

Plataformas de engajamento multicanal

Ferramentas de sequência combinam LinkedIn e email. Uma busca monta o público na licença do usuário, e as mensagens saem pelo LinkedIn e pelo Gmail, Outlook ou IMAP com a API de Email, em nome do mesmo usuário.

API do LinkedIn para plataformas de engajamento

Desenvolve para agentes de IA? O servidor MCP do Sales Navigator dá aos agentes de código as mesmas buscas, com o mesmo modelo por usuário.