Vai al contenuto principale
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
Esegui una ricerca asincrona per trovare un numero di telefono e il paese associato. Autentica ogni richiesta con la tua chiave API nell’header x-api-key. La ricerca deve contenere uno dei seguenti elementi:
  • L’URL del profilo LinkedIn di una persona (ad es. https://www.linkedin.com/in/michael-scott/)
  • La combinazione di informazioni individuali: firstname + lastname + (company_name o company_domain)
L’URL LinkedIn prevarrà sempre sulle informazioni individuali se entrambi sono presenti, poiché è il modo migliore per identificare in modo univoco una singola persona ed evitare problemi legati all’omonimia.

​
Corpo della richiesta

Opzione 1 (Consigliata):
​
linkedin_url
string
URL del profilo LinkedIn della persona.Nota: Ha la precedenza sulle informazioni individuali se entrambi sono forniti.
Opzione 2:
​
firstname
string
Nome della persona
​
lastname
string
Cognome della persona
​
company_domain
string
Dominio dell’azienda (ad es. "dundermifflin.com")
​
company_name
string
Nome dell’azienda (alternativa a company_domain)
Aggiuntivo:
​
custom
string
Un valore personalizzato che puoi utilizzare per fare riferimento a un ID interno. Sarà presente nei risultati.
​
settings
object
Impostazioni relative a questa ricerca.

​
Risposta

​
201 — Ricerca singola creata

​
message
string
Messaggio di conferma
​
id
string
Identificatore univoco per questa ricerca. Utilizzalo per recuperare i risultati tramite l’endpoint GET.
​
credits_used
number
Numero di crediti consumati (50 per impostazione predefinita; può variare in base al piano). Consulta Crediti e fatturazione per i costi per endpoint.
​
credits
object
Dettaglio dei crediti

​
Risposte di errore

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
In caso di crediti insufficienti (402), il corpo della risposta è { "reason": "...", "success": false }. Consulta Gestione degli errori per l’elenco completo dei codici di stato e dei formati di risposta. 
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 }
  }
}

​
Prossimi passi

Ottieni il risultato

Recupera il numero di telefono trovato usando l’id della ricerca.

Trova telefoni in blocco

Esegui più ricerche di telefono in un’unica richiesta.

Autenticazione

Come passare la tua chiave API nell’header x-api-key.

Webhook

Ricevi una notifica automatica al completamento di una ricerca.