Skip to main content
POST
POST
Ejecuta una búsqueda asíncrona para encontrar un número de teléfono y el país asociado. Autentica cada solicitud con tu clave de API en la cabecera x-api-key. La 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, ya que es la mejor manera de distinguir a una sola persona y evitar problemas relacionados con homónimos.

Cuerpo de la solicitud

Opción 1 (Recomendada):
string
URL del perfil de LinkedIn de la persona.Nota: Tiene prioridad sobre la información individual si se proporcionan ambas.
Opción 2:
string
Nombre de la persona
string
Apellido de la persona
string
Dominio de la empresa (p. ej., "dundermifflin.com")
string
Nombre de la empresa (alternativa a company_domain)
Adicional:
string
Un valor personalizado que puedes usar para referenciar un ID interno. Estará presente en los resultados.
object
Configuración relacionada con esta búsqueda.

Respuesta

201 — Búsqueda individual creada

string
Mensaje de confirmación
string
Identificador único de esta búsqueda. Úsalo para recuperar los resultados a través del endpoint GET.
number
Número de créditos consumidos (50 de forma predeterminada; puede variar según el plan). Consulta Créditos y facturación para conocer los costes por endpoint.
object
Desglose de créditos

Respuestas de error

En caso de créditos insuficientes (402), el cuerpo de la respuesta es { "reason": "...", "success": false }. Consulta Gestión de errores para ver la lista completa de códigos de estado y formatos de respuesta.

Próximos pasos

Obtener el resultado

Recupera el número de teléfono encontrado usando el id de la búsqueda.

Buscar teléfonos en lote

Ejecuta varias búsquedas de teléfono en una sola solicitud.

Autenticación

Cómo pasar tu clave de API en la cabecera x-api-key.

Webhooks

Recibe notificaciones automáticas cuando se complete una búsqueda.