API de LinkedIn Sales Navigator: acceso, límites y la alternativa para desarrolladores

Última verificación: 13 de octubre de 2026.

Punto clave: SNAP no tiene ningún endpoint que lance una búsqueda de personas con filtros, ni exportación de búsquedas guardadas o listas de leads. Ni siquiera un partner aprobado podría reconstruir una función de búsqueda de Sales Navigator solo con SNAP. Si tu producto necesita resultados de búsqueda, SNAP nunca fue la herramienta adecuada.

Lanzar una búsqueda de personas con filtros

Define api como sales_navigator y category como people (o companies) y combina los filtros que necesites. keywords es texto libre, tenure admite una lista de rangos en años, profile_language una lista de códigos de idioma, y company admite listas de IDs de empresas a incluir y excluir. Un filtro industry con una lista de inclusión funciona igual. El parámetro de consulta limit fija el tamaño de página, hasta 100 resultados en 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 la URL de una búsqueda guardada o una lista de leads

Muchos usuarios construyen primero su búsqueda en Sales Navigator. En lugar de recrear cada filtro en tu interfaz, acepta la URL que copian desde su navegador: una página de resultados, una búsqueda guardada o una lista de leads. Envíala en el campo url y la búsqueda se ejecuta con los filtros ya codificados en ese enlace.

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

Resolver los IDs de los filtros

Filtros como ubicaciones, empresas o sectores esperan IDs de LinkedIn, no nombres. Búscalos primero con el endpoint de parámetros de búsqueda y reutiliza los valores id devueltos en el cuerpo de tu búsqueda. El parámetro type indica qué buscas, aquí una ubicación.

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 con el cursor

Cada respuesta incluye un cursor. Pásalo como parámetro de consulta cursor de la siguiente petición y detente al llegar a paging.total_count, al límite por búsqueda descrito más abajo o al número de resultados que tu función necesita realmente.

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",
});

Volumen diario: para las búsquedas de personas en Sales Navigator, se recomienda mantenerse en torno a 2.500 perfiles al día por cuenta vinculada. Una búsqueda que supera las 2.500 personas necesita filtros más precisos, no más páginas: divídela por ubicación, sector o antigüedad.

Última verificación: 13 de octubre de 2026, según la documentación de límites y restricciones de los proveedores .

Ejemplo: tu app da servicio a 20 comerciales que vinculan cada uno una cuenta de Sales Navigator Core. Sus asientos siguen en sus propias suscripciones de LinkedIn. Por tu parte, la factura de la API es de 20 cuentas conectadas a $5,50, es decir, $110 al mes, sin coste por búsqueda ni por mensaje. Consulta todos los tramos de volumen en la página de precios de la API de Unipile.

Última verificación: 26 de octubre de 2026, según la página de planes de Sales Navigator de LinkedIn. Los precios de LinkedIn no incluyen impuestos y pueden variar según la región.

En la práctica: si no eres ya partner de SNAP, la elección está hecha. Y si lo eres, SNAP sigue sin darte los resultados de búsqueda como datos: los productos que los necesitan usan el modelo del lado del usuario junto con las funciones de su partnership.

Lista de leads al CRM

JDJane Doe, VP SalesVinculado

AKAlex Kim, Head of GrowthNuevo

MLMaria Lopez, CRONuevo

Enriquecimiento del CRM desde una lista de leads

Un comercial pega en tu CRM la URL de una lista de leads de Sales Navigator. Tu app la lanza en su nombre, cruza los resultados con los contactos existentes y crea los registros que faltan, cada uno con un enlace al perfil de LinkedIn.

API de LinkedIn para software CRM

Búsqueda de sourcing

"api": "sales_navigator"Ventas

"api": "recruiter"Selección

SRSam Reed, Backend EngineerPreselección

ATS y plataformas de reclutamiento

Los reclutadores suelen tener un asiento de Sales Navigator o de Recruiter. El mismo endpoint cambia de uno a otro con el campo api , así que un ATS puede ofrecer búsquedas de sourcing desde el asiento que haya vinculado el reclutador.

API de LinkedIn para ATS

Secuencia multicanal

Día 1: mensaje de LinkedInPaso 1

Día 3: email de seguimientoPaso 2

Día 6: respuesta detectadaParar

Plataformas de engagement multicanal

Las herramientas de secuencias combinan LinkedIn y email. Una búsqueda construye la audiencia en el asiento del usuario y luego los mensajes salen por LinkedIn y por Gmail, Outlook o IMAP con la API de Email, en nombre del mismo usuario.

API de LinkedIn para plataformas de engagement

¿Desarrollas para agentes de IA? El servidor MCP de Sales Navigator da a los agentes de código las mismas búsquedas, con el mismo modelo por usuario.