unipile-v2-linkedin-searchlisted
Install: claude install-skill henriquecaner/next-level-outreach
# Unipile v2 — Busca LinkedIn / Sales Navigator
Na v2, Sales Navigator é **first-class**, com endpoints dedicados sob
`/v2/{account_id}/linkedin/sales-navigator/...`. `account_id` no PATH; paginação por
**`offset`/`limit`** (query). Ver [[unipile-v2-foundations]].
> ⚠️ **Pré-requisito de conexão:** a conta LinkedIn precisa ter sido conectada com o
> **produto `sales_navigator`** (`config.linkedin.products: ["classic","sales_navigator"]`
> no `POST /v2/auth/link`). Sem isso o LinkedIn conecta só como "Personal" (classic) e
> as rotas `sales-navigator/*` não funcionam. `npm run connect -- linkedin BR` já pede
> os dois produtos por padrão.
## Forma 1 (preferida p/ "todas as variáveis"): URL colada
`POST /v2/{account_id}/linkedin/sales-navigator/search` (application/json):
```json
{ "url": "https://www.linkedin.com/sales/search/people?query=..." }
```
Cole a URL de uma busca montada na UI nativa do Sales Navigator. A cobertura de
filtros passa a ser a própria UI do LinkedIn — nada a re-modelar. É o caminho padrão
do projeto para garantir que nenhum filtro se perca. Query: `limit`, `offset`.
## Forma 2: filtros estruturados
Endpoints separados por categoria (body = objeto de filtros):
- Pessoas: `POST /v2/{account_id}/linkedin/sales-navigator/search/people`
- Empresas: `POST /v2/{account_id}/linkedin/sales-navigator/search/companies`
### Sales Navigator — `people` (catálogo completo)
`keywords, first_name, last_name, location, location_by_postal_code, industry,
tenure, gro