LinkedIn API Voyager

> ⚠️ MUDANÇA DE PACOTE: Esta biblioteca foi renomeada e movida de linkedin-api-voyager para @florydev/linkedin-api-voyager.
> Por favor, atualize suas dependências. A versão antiga não receberá novas atualizações.


Biblioteca TypeScript para interagir com endpoints internos do LinkedIn (Voyager). Esta não é uma API oficial.

Instalação

``bash
npm install @florydev/linkedin-api-voyager


ou


yarn add @florydev/linkedin-api-voyager
`

Configuração (Obrigatório)

Atenção: Esta biblioteca deve ser executada exclusivamente no lado do servidor (Node.js). O uso direto no navegador (client-side) resultará em erros de CORS e restrições de segurança.

Se você estiver usando em uma aplicação web (React, Vue, etc.), você deve criar uma API ou função intermediária no seu backend para chamar esta biblioteca.

$3

No ponto de entrada da sua aplicação backend (ex: index.ts, server.ts):

`ts
import { Client } from "@florydev/linkedin-api-voyager";

// Configure suas credenciais uma única vez
Client({
JSESSIONID: process.env.LINKEDIN_JSESSIONID, // ex: "ajax:123456789" (apenas os números se preferir, a lib trata)
li_at: process.env.LINKEDIN_LI_AT, // ex: "AQEDAR..."
});
`

$3

1. Faça login no LinkedIn pelo navegador.
2. Abra o DevTools do navegador.
3. Vá em:
- Chrome/Edge: Application -> Storage -> Cookies -> https://www.linkedin.com
- Firefox: Storage -> Cookies -> https://www.linkedin.com
4. Copie os valores:
- li_at: valor completo.
- JSESSIONID: valor completo (ex: "ajax:123456789").

> Nota: Nunca comite suas credenciais reais no código. Use variáveis de ambiente (.env).

Exemplos de Uso

Após inicializar o Client, você pode importar e usar qualquer função diretamente:

`ts
import {
getUserMiniProfile,
getProfissionalExperiences,
getCompany,
searchPeople,
getCommentsByPostUrl,
} from "@florydev/linkedin-api-voyager";

// Exemplo: Buscar perfil
const profile = await getUserMiniProfile("florymignon");
console.log(profile);

// Exemplo: Buscar experiências
const experiences = await getProfissionalExperiences("florymignon");

// Exemplo: Buscar empresa
const company = await getCompany("microsoft");

// Exemplo: Pesquisar pessoas
const people = await searchPeople("software engineer");

// Exemplo: Buscar comentários
const comments = await getCommentsByPostUrl(
"https://www.linkedin.com/feed/update/urn:li:activity-1234567890/",
);
`

API

$3

- Client(config: { JSESSIONID: string; li_at: string }): Configura a instância global do axios. Deve ser chamado antes de qualquer outra função.
- API_BASE_URL: https://www.linkedin.com/voyager/api

$3

A biblioteca exporta funções dos seguintes módulos:

- user: Perfis e dados de usuário.
- company: Dados de empresas.
- posts: Interações com posts e comentários.
- search: Busca de pessoas e empresas.
- utils: Utilitários gerais.

Autor

Flory Muenge Tshiteya

- Github: @Floryvibla
- LinkedIn: Flory Muenge Tshiteya
- 🐦 X (Twitter): @DevFlory

``

$3

Tipos exportados:

- MiniUserProfileLinkedin

Funções exportadas:

- getUserMiniProfile(identifier: string): Promise
- Busca dados básicos do perfil (nome, headline, imagens) e também o about.
- identifier é o publicIdentifier (parte final da URL linkedin.com/in/).

- extractProfileIdLinkedin(profileUrl: string): Promise
- Extrai o publicIdentifier de uma URL linkedin.com/in/....
- Se você passar apenas o identificador, ele tenta usar diretamente.
- Retorna o ID numérico interno (sem o prefixo urn:li:fsd_profile:) quando encontra.

- getProfileSectionAbout(identifier: string): Promise
- Retorna o texto de “Sobre” (about) do perfil.

- getProfissionalExperiences(identifier: string): Promise>
- Retorna a lista de experiências profissionais.
- Para cada experiência, tenta enriquecer com dados de empresa via getCompany.

- getContactInfo(identifier: string): Promise<{ ... }>
- Retorna informações de contato quando disponíveis (email, telefones, sites etc.).

- getLinkedinSkills(identifier: string): Promise>
- Retorna as skills (habilidades) listadas no perfil.

- getLinkedinEducation(identifier: string): Promise>
- Retorna a educação (escola, degree, datas, skills relacionadas quando houver).

- getLinkedinCertifications(identifier: string): Promise>
- Retorna certificações.

Exemplo:

`ts
import {
getUserMiniProfile,
getProfileSectionAbout,
getProfissionalExperiences,
getContactInfo,
getLinkedinSkills,
getLinkedinEducation,
getLinkedinCertifications,
} from "linkedin-api-voyager";

const identifier = "florymignon";

const mini = await getUserMiniProfile(identifier);
const about = await getProfileSectionAbout(identifier);
const experiences = await getProfissionalExperiences(identifier);
const contact = await getContactInfo(identifier);
const skills = await getLinkedinSkills(identifier);
const education = await getLinkedinEducation(identifier);
const certifications = await getLinkedinCertifications(identifier);
``

$3

Funções exportadas:

- getCompany(identifier: string): Promise
- Busca dados de uma empresa pelo universalName (slug da página).
- Exemplo de slug: https://www.linkedin.com/company/microsoft/ -> microsoft.

Exemplo:

`ts
import { getCompany } from "linkedin-api-voyager";

const company = await getCompany("microsoft");
`

$3

Funções exportadas:

- parseResponsePostLinkedin(response: any, key: string, accumulatedData: any): any
- Helper para selecionar itens do included a partir de *elements.

- getCommentsByPostUrl(url: string, start = 0, limit = 50, accumulatedComments: unknown[] = []): Promise
- Busca comentários de um post (paginando recursivamente até acabar).

- getPosts(): Promise
- Atualmente retorna [] (placeholder).

- getPostLinkedin(url: string, commentsCount = 10, likesCount = 10): Promise
- Busca um post pelo slug da URL e retorna os dados do post e do autor.

- getUserPosts({ identifier, start = 0, count = 50, accumulatedPosts = [] }): Promise
- Busca posts do usuário por identifier (publicIdentifier).

- helperGetPosts(response: any, key: string, accumulatedPosts?: any, addFields?: Record): any
- Helper para extrair posts e contagens (likes, comentários, shares).

- helperGetImageUrl(item: any): string
- Helper para montar a URL de imagem, priorizando o maior artifact.

Exemplo (comentários):

`ts
import { getCommentsByPostUrl } from "linkedin-api-voyager";

const comments = await getCommentsByPostUrl(
"https://www.linkedin.com/feed/update/urn:li:activity-1234567890/",
);
`

$3

Constantes internas:

- MAX_SEARCH_COUNT = 25 (limite máximo por chamada na busca geral)

Funções exportadas:

- search(params: ISearchParams): Promise
- Busca geral usando query e/ou filters (formato Voyager).
- Aceita paginação via offset.

- searchPeople(queryOrParams: string | ISearchPeopleParams): Promise
- Busca pessoas com helpers para montar filtros (networkDepth, regiões, empresas etc.).

Exemplo:

`ts
import { search, searchPeople } from "linkedin-api-voyager";

const res = await search({ query: "react developer" });
const people = await searchPeople({
query: "engenheiro de software",
regions: ["br:0"],
});
`

$3

Funções exportadas (helpers usados em parsing e normalização):

- filterKeys(obj: any, keysToKeep: string[]): any
- filterOutKeys(obj: any, keysToIgnore: string[]): any
- getNestedValue(obj: any, path: string): any
- extractFields(data: any[], fieldsMap: Record): any[]
- debugObjectStructure(obj: any, maxDepth = 3, currentDepth = 0): void
- resolveReferences(data: any, included: any[]): any
- extractDataWithReferences(elements: string[], included: any[], fieldsMap?: Record): any[]
- debugResolvedStructure(elements: string[], included: any[], maxDepth = 2): void
- extractFieldsFromIncluded(included: any[], fields: string[]): Array>
- mergeExtraFields(mainData: any[], extraData: Array>, matchKey = "companyUrn"): any[]
- getDataIncludedForEntity(jsonData: Record, entityUrn: string): any
- extractExperiences(jsonData: Record): Array<{ role: string | null; idCompany: string | null; company: string | null; ... }>
- assert(value: unknown, message?: string | Error): asserts value
- getIdFromUrn(urn?: string): string | undefined
- getUrnFromRawUpdate(update?: string): string | undefined
- isLinkedInUrn(urn?: string): boolean
- parseExperienceItem(item: any, opts: { isGroupItem?: boolean; included: any[] }): ExperienceItem
- getGroupedItemId(item: any): string | undefined
- omit(inputObj: object, ...keys: string[]): object
- resolveImageUrl(vectorImage?: VectorImage): string | undefined
- resolveLinkedVectorImageUrl(linkedVectorImage?: LinkedVectorImage): string | undefined
- stringifyLinkedInDate(date?: LIDate): string | undefined
- normalizeRawOrganization(o?: RawOrganization): Organization

Exemplo (mapear campos com path aninhado):

`ts
import { extractFields } from "linkedin-api-voyager";

const fieldsMap = {
nome: "firstName",
headline: "headline",
foto: "profilePicture.displayImageReferenceResolutionResult.vectorImage.rootUrl",
};

const mapped = extractFields([someObject], fieldsMap);
`

$3

Este arquivo exporta tipos e interfaces TypeScript usados pela biblioteca (por exemplo: ISearchParams, ISearchPeopleParams, SearchResponse, Organization, ExperienceItem`).

Limitações e considerações

- Usa endpoints internos do LinkedIn (Voyager), que podem mudar sem aviso.
- Requer cookies válidos de uma sessão autenticada.
- Use com moderação para reduzir risco de bloqueio.
- Respeite os termos de uso do LinkedIn.

Licença

MIT