Phone Finder
Buscar teléfono
Encuentra un único número de teléfono a partir de una URL de LinkedIn o de un nombre y empresa con la API de Phone Finder
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
Opción 2:
Adicional:
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_nameocompany_domain)
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.
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)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.

