Saltar al contenido 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
Ejecuta varias búsquedas de teléfono en una sola solicitud. Hasta 3000 búsquedas por lote. Autentica cada solicitud con tu clave de API en el encabezado x-api-key. Para encontrar un único número de teléfono, usa el endpoint Buscar un teléfono. Cada búsqueda debe contener una de las siguientes opciones:
  • La URL del perfil de LinkedIn de una persona (p. ej., https://www.linkedin.com/in/michael-scott/)
  • La combinación de información individual: firstname + lastname + (company_name o company_domain)
La URL de LinkedIn siempre prevalecerá sobre la información individual si ambas están presentes.

​
Cuerpo de la solicitud

​
searches
array of objects
requerido
Cargas útiles de búsqueda para las que encontrar los números de teléfono correspondientes.
​
custom
object
Parámetros personalizados que se devolverán en la respuesta GET y en la notificación del webhook.
​
settings
object
Ajustes relativos a la búsqueda en masa completa.

​
Respuesta

​
201 — Búsqueda en masa creada

​
message
string
Mensaje de confirmación
​
id
string
Identificador único de este lote. Úsalo para recuperar los resultados a través del endpoint GET.
​
credits_used
number
Total de créditos consumidos. Consulta Créditos y facturación para conocer los costos por endpoint.
​
estimated_duration
number
Tiempo de procesamiento estimado en minutos (no garantizado)
​
credits
object
Desglose de créditos

​
Respuestas de error

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
Cuando los créditos son insuficientes, el endpoint de masa devuelve HTTP 402 con un cuerpo de la forma { "message": "..." }. Consulta Manejo de errores para ver la lista completa de códigos de estado y formatos de respuesta.
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 pasos

Obtener resultados en masa

Recupera los números de teléfono encontrados usando el id del lote.

Buscar un teléfono

Ejecuta una única búsqueda de teléfono a partir de una URL de LinkedIn o nombre y empresa.

Webhooks

Recibe una notificación automática cuando se complete una búsqueda en masa.

Créditos y facturación

Descubre cómo se consumen los créditos en cada endpoint.