Saltar para o conteúdo principal
POST
/
phone
/
single
curl --request POST \
  --url https://api.enrow.io/phone/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/michael-scott/",
    "custom": "#u84hde941Jdx"
  }'

{
  "credits_used": 40,
  "id": "94cbc13b-7d77-4f41-83f0-60106daa7182",
  "message": "Single search operating",
  "credits": {
    "amount": 40,
    "source": "sub",
    "split": { "fromPaygo": 0, "fromSub": 40 }
  }
}
POST 
https://api.enrow.io/phone/single
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):
​
linkedin_url
string
URL do perfil do LinkedIn da pessoa.Nota: Tem precedência sobre as informações individuais se ambas forem fornecidas.
Opção 2:
​
firstname
string
Nome da pessoa
​
lastname
string
Sobrenome da pessoa
​
company_domain
string
Domínio da empresa (por exemplo, "dundermifflin.com")
​
company_name
string
Nome da empresa (alternativa a company_domain)
Adicional:
​
custom
string
Um valor personalizado que você pode usar para referenciar um ID interno. Ele estará presente nos resultados.
​
settings
object
Configurações relacionadas a esta busca.

​
Resposta

​
201 — Busca única criada

​
message
string
Mensagem de confirmação
​
id
string
Identificador único desta busca. Use-o para recuperar os resultados por meio do endpoint GET.
​
credits_used
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.
​
credits
object
Detalhamento dos créditos

​
Respostas de Erro

CódigoMensagem
400Invalid linkedin_url format
401No apikey found in the x-api-key headers
401This apikey is not valid
401This account is not allowed to use the phone search feature
402Insufficient credits
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. 
curl --request POST \
  --url https://api.enrow.io/phone/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/michael-scott/",
    "custom": "#u84hde941Jdx"
  }'

{
  "credits_used": 40,
  "id": "94cbc13b-7d77-4f41-83f0-60106daa7182",
  "message": "Single search operating",
  "credits": {
    "amount": 40,
    "source": "sub",
    "split": { "fromPaygo": 0, "fromSub": 40 }
  }
}

​
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.