Obter um E-mail de um Perfil do LinkedIn via API (Guia 2026)
Aprenda como acessar e-mails de contato que membros do LinkedIn escolheram compartilhar, utilizando a API do Unipile agindo em nome do seu usuário autenticado. A abordagem compatível e pronta para desenvolvedores para ferramentas de CRM, ATS e vendas.
"id_fornecedor": "urn:li:member:123456",
"primeiro_nome": "Sarah",
"sobrenome": "M.",
"manchete": "Chefe de Parcerias",
"informações_de_contato": {
"e-mail": "sarah.m@acmecorp.com"
},
/* presente apenas se o membro compartilhou */
}
Você consegue obter um e-mail de um perfil do LinkedIn via API?
Sim - mas apenas o e-mail que um membro do LinkedIn tem escolhido para tornar visível na seção de Informações de Contato deles. Quando esse membro é uma conexão do seu usuário autenticado, o LinkedIn expõe esse campo de e-mail através de sua plataforma. A API da Unipile, atuando em nome do usuário autenticado, recupera exatamente aquele campo - nada mais. Isso não é adivinhação nem casamento de padrões. Se o membro não compartilhou seu e-mail, o campo simplesmente estará ausente na resposta.
Por que desenvolvedores criam com a API de informações de contato do LinkedIn
Quando um membro do LinkedIn compartilha seu e-mail com sua rede, esse detalhe de contato se torna um valioso sinal de enriquecimento para softwares subsequentes. Aqui estão os principais casos de uso para Enriquecimento de perfil do LinkedIn pela API Unipile.
Quando uma conexão de primeiro grau de um usuário compartilhou seu e-mail no LinkedIn, seu CRM pode automaticamente popular ou atualizar o registro de contato com e-mail verificado - sem cópia manual, sem necessidade de fornecedor de dados de terceiros.
Caso de uso de CRMRecrutadores que usam seu ATS podem acessar o e-mail de contato que um candidato escolheu compartilhar, adicionando diretamente ao comprovante do candidato. Reduz o tempo de contato e mantém os dados atualizados sem busca manual.
Caso de uso ATSFerramentas de vendas podem exibir o e-mail compartilhado de um potencial cliente para ativar comunicação multicanal - acompanhamento por e-mail após uma interação no LinkedIn, tudo dentro do fluxo de trabalho do usuário autenticado. Sem listas de dados frios, sem bancos de dados comprados.
Caso de uso de ferramenta de vendasConstruindo um desses? Unipile oferece a você uma API unificada para dados de perfil do LinkedIn, mensagens, convites e e-mail, agindo em nome de cada um de seus usuários autenticados.
Comece a construirO modelo de usuário autenticado: em conformidade por design
A Unipile opera como um intermediário técnico independente, agindo em nome de cada usuário autenticado. Seu aplicativo nunca toca nas credenciais do LinkedIn diretamente - todo o fluxo passa pela sessão hospedada da Unipile, limitada ao que esse usuário já pode ver.
compartilhar o e-mail deles
o usuário autenticado
para enriquecimento de CRM / ATS
Seu usuário completa Fluxo de autenticação hospedado pela Unipile - um assistente seguro que gerencia a sessão do LinkedIn inteiramente dentro da infraestrutura da Unipile. Sua aplicação recebe um ID de conta, nunca uma senha ou cookie. Esta é a maneira correta de lidar com autenticação de terceiros: as credenciais são gerenciadas pelo próprio fluxo, não armazenadas em seus servidores.
Usando o ID da conta retornado na etapa 1, seu aplicativo chama GET /usuários/perfil com o identificador do perfil de destino como parâmetro de consulta. O Unipile encaminha a solicitação através da sessão do LinkedIn do usuário autenticado – exatamente como se esse usuário tivesse aberto o perfil. Veja o detalhamento completo de quais dados do LinkedIn podem ser extraídos dessa forma.
Se o proprietário do perfil tornou o email visível para conexões, ele aparece em contact_info.email campo. Caso contrário, o campo está ausente - não há fallback, não há adivinhação, não há dados de fontes externas. O que você recebe é precisamente o que o LinkedIn mostra para esse usuário em sua própria sessão. Este é o abordagem transparente e em conformidade para acessar dados de contato do LinkedIn.
Passo a passo: conectar uma conta do LinkedIn e recuperar e-mails de contato
Toda a configuração leva menos de 10 minutos. Nenhuma credencial armazenada no seu lado - tudo é executado através do fluxo de autenticação hospedado da Unipile.
Cadastre-se em dashboard.unipile.com. Você receberá um DSN (URL base) e um Chave de API - estas são as únicas credenciais que sua aplicação precisa armazenar. Sem senhas do LinkedIn, sem cookies, sem tokens.
Chamar POST /hosted/accounts/link com fornecedores: ["LINKEDIN"] para gerar um URL de autenticação hospedado seguro. Envie esse URL para o seu usuário - ele completará o login no LinkedIn dentro do assistente hospedado da Unipile. Nenhuma credencial chega aos seus servidores.
Após o usuário completar a autenticação, o Unipile retorna um account_id. Verifique o status da conta via GET /contas/{account_id} - o status deve exibir OPERACIONAL. A conta vinculada está pronta para realizar pesquisas de perfil em nome do seu usuário.
Passe o account_id como um cabeçalho e o identificador do perfil do LinkedIn como um parâmetro de consulta. Unipile retorna o objeto de perfil completo - incluindo contact_info.email se e somente se o proprietário do perfil optou por compartilhá-lo com suas conexões.
Recuperar um Perfil do LinkedIn, Email Incluído
enrolar --request OBTER \ --url https://api1.unipile.com:13111/api/v1/users/{user_id} \ --header 'X-API-KEY: {sua_chave_de_api}'
Uma única consulta de perfil retorna tudo o que o membro optou por tornar visível, com o e-mail em destaque. Quando a pessoa compartilhou seu endereço em suas Informações de Contato, ele retorna na mesma resposta, juntamente com cargo, empresa, localização e mais, recuperado em nome do usuário autenticado.
Recuperar um e-mail de perfil do LinkedIn via API: Node.js, Python, cURL
Todos os três exemplos seguem o mesmo padrão em conformidade: autenticação hospedada para vincular a conta do usuário, seguida por uma consulta de perfil que retorna contact_info.email quando o membro tiver optado por compartilhá-lo. Veja o Guia da API do LinkedIn em Python para uma cobertura mais aprofundada do SDK Python.
import { UnipileClient } from 'unipile-node-sdk';
// Passo 1: inicialize o cliente com seu DSN e chave de API
const client = new UnipileClient(
process.env.UNIPILE_DSN,
process.env.UNIPILE_API_KEY
);
// Passo 2: gere um link de autenticação hospedado para que o usuário possa vincular
// sua conta do LinkedIn - sem credenciais do seu lado
const Link Hospedado = await client.account.criarLinkDeAutenticaçãoHospedado({
tipo: 'criar',
filtros_de_fornecedores: ['LinkedIn'],
url_de_redirecionamento_de_sucesso: 'https://seuarquivo.com/callback',
});
// Envie o URL do hostedLink para o seu usuário - ele completa a autenticação lá
// Passo 3: uma vez que o usuário complete a autenticação, recupere seu perfil
// agindo em nome do usuário autenticado
const accountId = 'acc_recebido_do_webhook';
const perfil = await client.clientes.getProfile({
account_id: accountId,
identificador: 'urn:li:member:TARGET_PROFILE_ID',
});
// Passo 4: ler contact_info.email - presente apenas se o membro
// escolheu compartilhá-lo (sem adivinhações, sem fallback)
const e-mail = perfil?.informações de contato?.e-mail ?? nulo;
console.log('E-mail compartilhado:', e-mail);import os, solicitações
DSN = os.meio ambiente["UNIPILE_DSN"]
CHAVE_API = os.meio ambiente["UNIPILE_API_KEY"]
CABEÇALHOS = {"X-API-KEY": CHAVE_API}
# Etapa 1 - gerar um link de autenticação hospedado (sem armazenamento de credenciais)
resposta = solicitações.postagem(
f"{DSN}/hosted/accounts/link",
cabeçalhos=CABEÇALHOS,
json={
"tipo": "criar",
"filtros_provedores": ["LINKEDIN"],
"url_de_redirecionamento_de_sucesso": "https://seusite.com/callback",
}
)
print("Envie esta URL para o seu usuário:", resposta.json()["url"])
# Etapa 2 - após o usuário concluir a autenticação, recuperar seu perfil
# em nome do usuário autenticado
ID_DA_CONTA = "acc_recebido_de_webhook"
ID_PERFIL = "urn:li:member:TARGET_PROFILE_ID"
perfil_resp = solicitações.obter(
f"{DSN}/usuarios/perfil",
cabeçalhos={**CABEÇALHOS, "id-da-conta": ID_DA_CONTA},
parâmetros={"identificador": ID_PERFIL}
)
dados = perfil_resp.json()
# Etapa 3 - ler contact_info.email - ausente se não for compartilhado
e-mail = dados.obter("informações_de_contato", {}).obter("e-mail")
print("Email compartilhado:", e-mail ou "Não compartilhado por este membro")# Etapa 1 - gerar link de autenticação hospedado
enrolar -s -X POST ""${UNIPILE_DSN}/hosted/accounts/link"" \
-H ""X-API-KEY: ${UNIPILE_API_KEY}"" \
-H "Content-Type: application/json" \
-d '{
"tipo": "criar",
"providers_filters": ["LINKEDIN"],
"url_redirecionamento_sucesso": "https://yourapp.com/callback"
}'
# retorna { "url": "https://auth.unipile.com/..." }
# Envie esse URL ao usuário — ele concluirá a autenticação no LinkedIn por lá
# Etapa 2 - recuperar o perfil em nome do usuário autenticado
# (substitua ACCOUNT_ID e PROFILE_ID por valores reais)
enrolar -s -X GET \
""${UNIPILE_DSN}/users/profile?identifier=urn:li:member:TARGET_ID"" \
-H ""X-API-KEY: ${UNIPILE_API_KEY}"" \
-H "id-da-conta: ACCOUNT_ID"
# Exemplo de resposta (o e-mail só aparece se o membro o tiver compartilhado):
# {
# "primeiro_nome": "Sarah",
# "sobrenome": "M.",
# "contact_info": {
# "email": "sarah.m@acmecorp.com""
# }
# }contact_info.email O campo no endpoint de perfil é a maneira correta e oficial de acessar um e-mail que um membro escolheu compartilhar.O que você pode e não pode acessar através da API do perfil do LinkedIn
Entender o escopo real é essencial antes de construir. Veja também a análise completa dos dados que o LinkedIn pode extrair e Diretrizes da API de conformidade do LinkedIn.
contact_info.email
GET /usuarios/relacoes, enriquecível com dados de perfil por usuário
firstname.lastname@company.com adivinhando
Trabalhando dentro dos limites da API do LinkedIn
O LinkedIn impõe seus próprios limites diários em ações como convites, mensagens e visualizações de perfil. Unipile repassa esses limites nativos de forma transparente e nunca os levanta. Quão rápido e o quanto você corre permanece um decisão do lado do cliente, com limites seguros, mais rápidos e de risco exibidos por conta conectada, além de inicialização automática para novas contas.
Relatório de limites
pendente
pendente
pendente
pendente
API Unipile vs. exportação manual vs. corretores de dados de terceiros
Existem várias maneiras que os desenvolvedores tentam obter endereços de e-mail de perfis do LinkedIn. Esta tabela compara-os honestamente para que você possa escolher a abordagem que melhor se adapta à sua postura de conformidade.
| Critérios | Unipile API (em nome de)Recomendado | Exportação manual do LinkedIn | Corretores de dados de terceiros |
|---|---|---|---|
| Conformidade com os Termos de Serviço do LinkedIn | Sim - sessão autenticada por usuário | Manual apenas, não escalável | Geralmente viola os Termos de Serviço |
| Automatizável em escala | Sim – orientado por API, em uma base por usuário | Não - processo manual | Sim, mas frágil e arriscado |
| Fonte de dados de e-mail | Campo de Informações de Contato do membroSomente o que eles escolheram compartilhar | Exportação CSV do LinkedInLimitado às suas próprias conexões | Banco de dados de terceiros / AdivinhadoFrequentemente obsoleto, não verificado |
| Credenciais armazenadas em seu servidor | Fluxo de autenticação não hospedado | Usuário lida manualmente | Frequentemente sim - alto risco |
| Frescor em tempo real | Ao vivo da sessão do LinkedIn | Exportação de um ponto no tempo | Banco de dados muitas vezes desatualizado |
| Conformidade com o GDPR / proteção de dados | Membro escolheu compartilhar - base legal | Depende do uso | Normalmente, nenhuma base de consentimento |
| Integração CRM / ATS | API nativa, pronta para webhooks | Importação manual de CSV | Varia por fornecedor |
Construa seu contato no LinkedIn
integração de enriquecimento hoje
Unipile oferece uma API unificada para acessar os detalhes de contato que os membros do LinkedIn escolheram compartilhar, agindo em nome de cada um de seus usuários autenticados. Sem credenciais armazenadas em seu lado, sem um banco de dados separado para manter, sem adivinhação.
E-mail do LinkedIn da API de Perfil - Perguntas Frequentes
Respostas para as perguntas mais comuns sobre como obter e-mails de contatos do LinkedIn via API do Unipile - escopo, conformidade e implementação técnica.
Apenas o que o usuário autenticado já pode ver em sua própria sessão do LinkedIn. Se um membro compartilhou seu e-mail com conexões, ele aparece em contact_info.email. Caso contrário, o campo está ausente. Há sem banco de dados independente, sem adivinhações e sem dados de fontes externas. Este é o escopo honesto - e é por isso que a abordagem está em conformidade.
Acessar um e-mail que um membro do LinkedIn possui explicitamente escolhido para compartilhar com suas conexões, por meio de uma sessão autenticada agindo em nome desse usuário, é consistente com a forma como o LinkedIn expõe esses dados. O membro fez uma escolha deliberada de compartilhá-los. Dito isso, a legalidade também depende do seu uso pretendido: GDPR, CCPA e regulamentações semelhantes exigem uma base legal para o processamento de dados pessoais. Certifique-se de que seu caso de uso seja claramente intencional e que seus usuários sejam informados.
Não. O LinkedIn não expõe informações de contato para perfis fora da rede direta do usuário autenticado. contact_info.email campo está disponível apenas para Conexões de 1º grau que optaram por compartilhar. Perfis de segundo e terceiro graus não expõem esses dados. Esta é uma restrição em nível de plataforma, não uma limitação da Unipile.
O Unipile repassa os limites de taxa nativos do LinkedIn e as regras de visibilidade de forma transparente. A frequência, o volume e o propósito das consultas de perfil são um decisão do lado do cliente. Sua aplicação e seus usuários são responsáveis por garantir que o uso esteja em conformidade com os Termos de Serviço do LinkedIn e as regulamentações aplicáveis de proteção de dados. A Unipile é a intermediária técnica - o uso responsável é definido pelo cliente.
Não. A Unipile é não afiliado, endossado ou patrocinado pelo LinkedIn. Unipile é um intermediário técnico independente que atua em nome de usuários autenticados para exibir dados aos quais eles já têm acesso dentro de sua própria sessão do LinkedIn. LinkedIn é uma marca registrada da LinkedIn Corporation.
O Sales Navigator é um produto do LinkedIn para usuários individuais que trabalham na interface própria do LinkedIn. Unipile é uma API para desenvolvedores para desenvolvedores de software que incorporam acesso a dados do LinkedIn em seus próprios produtos - CRMs, ATSs, ferramentas de vendas. Os dois atendem a públicos diferentes. O Unipile expõe programaticamente as mesmas informações de contato que um usuário pode ver em sua sessão; ele não concede acesso a dados além do que o LinkedIn já expõe a esse usuário.
Não. A Unipile mantém em arquivo, índice ou banco de dados independentes de e-mails de contato do LinkedIn. Todos os e-mails retornados pela API são obtidos em tempo real do LinkedIn através da própria sessão do usuário autenticado no momento da solicitação. Não há banco de dados de e-mails construído ou vendido pela Unipile.
Quando um membro não compartilhou seu e-mail, contact_info.email simplesmente ausente da resposta. Use encadeamento opcional em JavaScript (profile?.contact_info?.email ?? null) ou .pegar() em Python (data.get("contact_info", {}).get("email")) e tratar nulo como "não compartilhado por este membro". Não tente alternativas como a verificação de tópicos de mensagens com regex - esse padrão não está em conformidade e produz resultados não confiáveis.
A Unipile oferece um teste gratuito para começar - sem necessidade de cartão de crédito. Os planos pagos escalam com o número de contas vinculadas e o volume de uso da API. Para uma visão geral mais ampla das opções de preços da API do LinkedIn, consulte o guia em se a API do LinkedIn é gratuita. Para começar a construir hoje, visite dashboard.unipile.com.
Ainda tem dúvidas sobre a API de e-mail do LinkedIn? Nossa equipe está aqui para ajudar.