API de perfil por e-mail no LinkedIn: enriquecimento em massa

Verifique se os e-mails estão registrados no LinkedIn e enriqueça cada um com atributos de perfil. Envie um endereço de e-mail por linha. O resultado sempre tem um conjunto fixo de colunas.

Exemplo para enviar o arquivo de detecção:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="linkedin_profile"'

Exemplo para consultar o status da tarefa:

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

Resposta para upload bem-sucedido:

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2026-04-28T11:58:08.916446594Z"
}

Resposta para status de processamento:

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Resposta quando a tarefa for concluída (inclui a URL de download):

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL da requisição para upload de arquivo

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

Parâmetros da requisição para upload de arquivo

Parâmetro	Descrição
file	file, um endereço de e-mail por linha
task_type	string, defina como linkedin_profile

URL da requisição para consultar status

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

Parâmetros da requisição para consultar status

Parâmetro	Descrição
task_id	string, ID da tarefa retornado na criação

Campos do resultado

Campo	Descrição
email	Endereço de e-mail
activated	Se a conta está registrada/ativada (yes / no)
country	País / região
gender	Gênero inferido
industry	Setor
job_title	Cargo
inferred_salary	Faixa salarial estimada

Formato da resposta

Campo	Descrição
created_at	Timestamp quando a tarefa foi criada
updated_at	Timestamp da última atualização de status
task_id	Identificador único da tarefa
user_id	ID do usuário
status	pending · processing · exported · failed (reembolsado automaticamente)
total	Total de números de telefone processados
success	Números identificados com sucesso
failure	Números que falharam no processamento
result_url	URL de download quando o status é exported
actual_amount	(Opcional) Valor efetivamente cobrado, disponível após a liquidação da tarefa
estimated_amount	(Resposta de criação) Valor estimado da tarefa; a cobrança final é liquidada na conclusão

Códigos de status

Status	Descrição
200	free, Solicitação bem-sucedida (ex.: consulta de status)
202	charge, Tarefa criada com sucesso; o valor estimado é deduzido
400	free, Solicitação inválida: parâmetros ou formato de arquivo inválidos, tipo de tarefa não suportado ou entradas válidas abaixo do lote mínimo
401	free, Chave de API ausente ou inválida
402	free, Saldo insuficiente
404	free, Tarefa não encontrada
413	free, Arquivo enviado muito grande
500	free, Erro interno do servidor, tente novamente mais tarde