Skip to main content
POST
POST
Execute uma busca assíncrona para encontrar um número de telefone e o país associado. Autentique cada requisição com sua chave de API no cabeçalho x-api-key. A busca precisa conter:
  • A URL do perfil do LinkedIn de uma pessoa (por exemplo, https://www.linkedin.com/in/michael-scott/)
  • A combinação de informações individuais: firstname + lastname + (company_name ou company_domain)
A URL do LinkedIn sempre prevalecerá sobre as informações individuais se ambas estiverem presentes, pois é a melhor forma de distinguir uma única pessoa e evitar problemas relacionados a homônimos.

Corpo da Requisição

Opção 1 (Recomendada):
string
URL do perfil do LinkedIn da pessoa.Nota: Tem precedência sobre as informações individuais se ambas forem fornecidas.
Opção 2:
string
Nome da pessoa
string
Sobrenome da pessoa
string
Domínio da empresa (por exemplo, "dundermifflin.com")
string
Nome da empresa (alternativa a company_domain)
Adicional:
string
Um valor personalizado que você pode usar para referenciar um ID interno. Ele estará presente nos resultados.
object
Configurações relacionadas a esta busca.

Resposta

201 — Busca única criada

string
Mensagem de confirmação
string
Identificador único desta busca. Use-o para recuperar os resultados por meio do endpoint GET.
number
Número de créditos consumidos (50 por padrão; pode variar conforme o plano). Veja Créditos e cobrança para os custos por endpoint.
object
Detalhamento dos créditos

Respostas de Erro

Em caso de créditos insuficientes (402), o corpo da resposta é { "reason": "...", "success": false }. Veja Tratamento de erros para a lista completa de códigos de status e formatos de resposta.

Próximos passos

Obter o resultado

Recupere o número de telefone encontrado usando o id da busca.

Encontrar telefones em massa

Execute várias buscas de telefone em uma única requisição.

Autenticação

Como passar sua chave de API no cabeçalho x-api-key.

Webhooks

Seja notificado automaticamente quando uma busca for concluída.