Saltar para o conteúdo principal
POST
/
phone
/
bulk
curl --request POST \
  --url https://api.enrow.io/phone/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/phone"
    }
  }'

{
  "credits_used": 80,
  "estimated_duration": 1,
  "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
  "message": "Bulk search operating",
  "credits": {
    "amount": 80,
    "source": "sub",
    "split": {
      "fromPaygo": 0,
      "fromSub": 80
    }
  }
}
POST 
https://api.enrow.io/phone/bulk
Execute várias buscas de telefone em uma única requisição. Até 3.000 buscas por lote. Autentique cada requisição com sua chave de API no cabeçalho x-api-key. Para encontrar um único número de telefone, use o endpoint Encontrar Telefone. Cada 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.

​
Request Body

​
searches
array of objects
obrigatório
Cargas de busca para as quais encontrar os números de telefone correspondentes.
​
custom
object
Parâmetros personalizados que serão retornados na resposta GET e na notificação por webhook.
​
settings
object
Configurações relativas a toda a busca em lote.

​
Response

​
201 — Busca em lote criada

​
message
string
Mensagem de confirmação
​
id
string
Identificador único para este lote. Use-o para recuperar os resultados por meio do endpoint GET.
​
credits_used
number
Total de créditos consumidos. Consulte Créditos e cobrança para os custos por endpoint.
​
estimated_duration
number
Tempo estimado de processamento em minutos (não garantido)
​
credits
object
Detalhamento dos créditos

​
Error Responses

CodeMessage
400At least 1 phone search must be present in the payload
400Missing payload
400Too many searches. Limit is currently at 3000 per batch.
401This apikey is not valid
401This account is not allowed to use the phone search feature
402Insufficient credits
Quando os créditos são insuficientes, o endpoint em lote retorna HTTP 402 com um corpo no formato { "message": "..." }. Consulte 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/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/phone"
    }
  }'

{
  "credits_used": 80,
  "estimated_duration": 1,
  "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
  "message": "Bulk search operating",
  "credits": {
    "amount": 80,
    "source": "sub",
    "split": {
      "fromPaygo": 0,
      "fromSub": 80
    }
  }
}

​
Próximos passos

Obter resultados em lote

Recupere os números de telefone encontrados usando o id do lote.

Encontrar um único telefone

Execute uma única busca de telefone a partir de uma URL do LinkedIn ou nome e empresa.

Webhooks

Seja notificado automaticamente quando uma busca em lote for concluída.

Créditos e cobrança

Veja como os créditos são consumidos em cada endpoint.