Saltar al contenido principal
POST
/
phone
/
single
curl --request POST \
  --url https://api.enrow.io/phone/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/michael-scott/",
    "custom": "#u84hde941Jdx"
  }'

{
  "credits_used": 40,
  "id": "94cbc13b-7d77-4f41-83f0-60106daa7182",
  "message": "Single search operating",
  "credits": {
    "amount": 40,
    "source": "sub",
    "split": { "fromPaygo": 0, "fromSub": 40 }
  }
}
POST 
https://api.enrow.io/phone/single
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):
​
linkedin_url
string
URL del perfil de LinkedIn de la persona.Nota: Tiene prioridad sobre la información individual si se proporcionan ambas.
Opción 2:
​
firstname
string
Nombre de la persona
​
lastname
string
Apellido de la persona
​
company_domain
string
Dominio de la empresa (p. ej., "dundermifflin.com")
​
company_name
string
Nombre de la empresa (alternativa a company_domain)
Adicional:
​
custom
string
Un valor personalizado que puedes usar para referenciar un ID interno. Estará presente en los resultados.
​
settings
object
Configuración relacionada con esta búsqueda.

​
Respuesta

​
201 — Búsqueda individual creada

​
message
string
Mensaje de confirmación
​
id
string
Identificador único de esta búsqueda. Úsalo para recuperar los resultados a través del endpoint GET.
​
credits_used
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.
​
credits
object
Desglose de créditos

​
Respuestas de error

CodeMessage
400Invalid linkedin_url format
401No apikey found in the x-api-key headers
401This apikey is not valid
401This account is not allowed to use the phone search feature
402Insufficient credits
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. 
curl --request POST \
  --url https://api.enrow.io/phone/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/michael-scott/",
    "custom": "#u84hde941Jdx"
  }'

{
  "credits_used": 40,
  "id": "94cbc13b-7d77-4f41-83f0-60106daa7182",
  "message": "Single search operating",
  "credits": {
    "amount": 40,
    "source": "sub",
    "split": { "fromPaygo": 0, "fromSub": 40 }
  }
}

​
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.