API de perfil por usuário do LinkedIn: perfis em lote

Verifique perfis públicos do LinkedIn por nome de usuário ou URL do perfil e receba foto, nome, título, localização, país, empresa, número de seguidores, resumo, idiomas, formação e experiência profissional. Perfis inexistentes ou privados são retornados como não ativados. A tarefa usa o fluxo padrão de processamento assíncrono em lote.

Formato de entrada

Envie um arquivo de texto com um nome de usuário do LinkedIn por linha. São aceitos o slug do perfil, @slug e a URL completa linkedin.com/in/<slug>; a correspondência ignora maiúsculas e minúsculas.

williamhgates
@satyanadella
https://www.linkedin.com/in/john-smith-1a2b3c4/

Criar uma tarefa

POST https://api.numberchecker.ai/v1/tasks

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="linkedin_username"'

A API retorna um ID de tarefa. Guarde esse ID e use-o para consultar o status.

Resposta do upload

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Verificar status da tarefa

POST https://api.numberchecker.ai/v1/gettasks

curl --location 'https://api.numberchecker.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Consulte até que status se torne exported. Não trate pending ou processing como resultado concluído.

Resposta em processamento

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Resposta exportada

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Campos do resultado

Campo	Descrição	Exemplo
username	Nome de usuário ou URL do perfil exatamente como enviado.	williamhgates
activated	Se um perfil público foi encontrado para o usuário (no também cobre perfis privados ou inexistentes).	yes
avatar	Se o perfil tem uma foto real (yes/no).	yes
avatar_url	URL da foto de perfil (não expira).	https://media.licdn.com/dms/image/…
name	Nome completo.	Bill Gates
headline	Título do perfil.	Chair, Gates Foundation
location	Localização como exibida no perfil.	Seattle, Washington, United States
country	Código de país ISO derivado da localização.	US
company	Empresa atual.	Gates Foundation
followers	Número de seguidores.	40653538
about	Texto da seção Sobre.	Chair of the Gates Foundation. …
badges	Selos de verificação, ex.: Creator, Top Voice.	Creator, Top Voice
languages	Idiomas, separados por ;.	English;German
current_title	Cargo atual quando não ocultado pelo proprietário.	Co-chair
education	Lista JSON de {organization,start,end}.	[{“organization”:“Harvard University”,“start”:1973,“end”:1975}]
experience	Lista JSON de {organization,start,end}.	[{“organization”:“Gates Foundation”,“start”:2000}]
masked	Campos ocultados pelas configurações de visibilidade, separados por ;.	jobTitle;worksFor

Tratamento do arquivo de resultado

Baixe o arquivo por result_url somente após a tarefa ser exportada. Preserve os nomes das colunas retornados ao processar o arquivo.

Campos da resposta

Campo	Descrição
created_at	Data e hora de criação da tarefa.
updated_at	Data e hora da última atualização de status.
task_id	Identificador exclusivo da tarefa.
status	pending, processing, exported ou failed.
total	Total de valores de entrada processados.
success	Valores processados com sucesso.
failure	Valores cujo processamento falhou.
result_url	URL de download quando a tarefa é exportada.
actual_amount	Valor final liquidado, quando disponível.
estimated_amount	Valor estimado retornado ao criar a tarefa.

Códigos de status

Status	Descrição
200	Solicitação bem-sucedida.
202	Tarefa criada com sucesso e cobrança estimada aplicada.
400	Arquivo inválido, tipo de tarefa não compatível ou poucas entradas válidas.
401	Chave de API ausente ou inválida.
402	Saldo insuficiente.
403	Produto indisponível para sua conta (descontinuado ou restrito à lista de permissões); entre em contato com o suporte.
404	Tarefa não encontrada.
413	O arquivo enviado é grande demais.
500	Erro interno do servidor; tente novamente mais tarde.
503	Produto temporariamente indisponível (pausado para manutenção); nada é cobrado, tente novamente mais tarde.

Observações operacionais

• A tarefa é assíncrona; use o ID da tarefa para consultar o status.
• Verifique os limites de entrada do produto antes do upload.
• As linhas com falha aparecem no resultado exportado e são refletidas nos contadores.
• Os campos acima são baseados no sample atual e podem mudar quando o esquema de exportação upstream mudar.