Skip to main content
POST
POST
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

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

Respuesta

201 — Búsqueda en masa creada

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

Respuestas de error

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.

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.