Risultato Email

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

const data = await response.json();
console.log(data);

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

GET

find

single

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

const data = await response.json();
console.log(data);

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

GET

https://api.enrow.io/email/find/single?id={id}

Recupera il risultato di una ricerca email avviata in precedenza utilizzando il suo ID univoco. Autentica ogni richiesta con la tua chiave API nell’header x-api-key.

L’utilizzo di un webhook ti consente di evitare la chiamata a questo endpoint GET, poiché verrai notificato nell’istante in cui la tua ricerca è terminata. Consulta Come funzionano i webhook.

Parametri di query

string

obbligatorio

L’identificatore univoco restituito dalla richiesta POST

Risposta

200 — Ricerca completata

string

L’indirizzo email trovato

string

valid (email trovata) o invalid (email non trovata). Perché binario?

number

Costo finale della ricerca, al netto dei rimborsi: 1 per un’email trovata, 0 per un’email non trovata (0.25 per una ricerca a partire dall’URL di un profilo LinkedIn o per un account con un tasso di successo anormalmente basso, vedi Crediti e fatturazione). Una ricerca a partire dall’URL di un profilo LinkedIn che fallisce a causa di un problema da parte nostra costa 0: vedi Risultati di una ricerca a partire da un URL di profilo LinkedIn.

object

Informazioni di contatto e aziendali. Per una ricerca a partire dall’URL di un profilo LinkedIn, presente solo se viene trovata un’email.

Mostra proprietà di info

string

Dominio dell’azienda

string

Nome dell’azienda

string

Nome completo come fornito nella richiesta

string

Nome

string

Cognome

string

Genere (male o female) — solo se retrieve_gender è stato impostato su true

object

Proprietà personalizzate passate nella richiesta originale, restituite così come sono

string

Solo per una ricerca a partire dall’URL di un profilo LinkedIn. Indica come si è conclusa la ricerca: found, profile_not_found, no_current_company, email_not_found o lookup_failed. Vedi Risultati di una ricerca a partire da un URL di profilo LinkedIn.

string

Solo per una ricerca a partire dall’URL di un profilo LinkedIn. Il linkedin_url che hai inviato.

202 — Ricerca ancora in corso

string

ongoing — la ricerca non è ancora terminata. Riprova a breve, oppure utilizza un webhook per essere notificato automaticamente. Il recupero di un risultato non consuma crediti; consulta Crediti e fatturazione.

Risposte di errore

Codice	Messaggio
400	`The single search id is missing in the URL query string`
500	`Could not retrieve single search results`

Consulta Gestione degli errori per l’elenco completo dei codici di stato e dei formati di risposta.

Risultati di una ricerca a partire da un URL di profilo LinkedIn

Una ricerca avviata a partire dall’URL di un profilo LinkedIn mantiene il campo binario qualification e aggiunge due campi: linkedin_status, che indica come si è conclusa la ricerca, e linkedin_url, l’URL che hai inviato.

`linkedin_status`	Significato	`qualification`	`credits_used`
`found`	L’email professionale della persona è stata trovata e verificata	`valid`	`1`
`profile_not_found`	Nessun profilo trovato per questo URL LinkedIn	`invalid`	`0.25`
`no_current_company`	Il profilo non mostra alcuna posizione attuale da cui avviare la ricerca	`invalid`	`0.25`
`email_not_found`	Profilo trovato, ma nessuna email presso l’azienda attuale della persona	`invalid`	`0.25`
`lookup_failed`	Non è stato possibile completare la ricerca a causa di un problema da parte nostra. Il costo viene rimborsato per intero: riprova tra qualche minuto	`invalid`	`0`

Quando l’email viene trovata, info riporta il nome e l’azienda letti dal profilo: firstname, lastname, company_name e company_domain, più gender quando retrieve_gender è true. In tutti gli altri casi, la risposta non contiene né email né info: non rivela mai a chi appartiene il profilo. Se l’email o il profilo si trovano nella tua lista di soppressione, l’email trovata non viene restituita: il risultato riporta email_not_found e costa 1 credito, come un’email trovata. Mentre la ricerca è in corso, l’endpoint restituisce il consueto 202 con qualification: "ongoing".

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "crm_id": "lead_001"
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "company_name": "Dunder Mifflin",
    "firstname": "Dwight",
    "lastname": "Schrute"
  },
  "linkedin_status": "found",
  "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
  "qualification": "valid",
  "credits_used": 1
}

{
  "custom": {
    "crm_id": "lead_001"
  },
  "linkedin_status": "no_current_company",
  "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
  "qualification": "invalid",
  "credits_used": 0.25
}

curl --request GET \
  --url 'https://api.enrow.io/email/find/single?id=0cf517bc-16e8-45bc-b967-ab9116b3c804' \
  --header 'x-api-key: YOUR_API_KEY'

const searchId = '0cf517bc-16e8-45bc-b967-ab9116b3c804';
const response = await fetch(`https://api.enrow.io/email/find/single?id=${searchId}`, {
  headers: {
    'x-api-key': process.env.ENROW_API_KEY
  }
});

const data = await response.json();
console.log(data);

import requests
import os

search_id = "0cf517bc-16e8-45bc-b967-ab9116b3c804"
url = f"https://api.enrow.io/email/find/single?id={search_id}"
headers = {
    "x-api-key": os.getenv("ENROW_API_KEY")
}

response = requests.get(url, headers=headers)
print(response.json())

{
  "email": "dwight.schrute@dundermifflin.com",
  "custom": {
    "external_id": "do4eIF8jF40x!",
    "partition_number": 2
  },
  "info": {
    "company_domain": "dundermifflin.com",
    "fullname": "Dwight Schrute",
    "firstname": "dwight",
    "lastname": "schrute"
  },
  "qualification": "valid"
}

{
  "message": "..."
}

Passaggi successivi

Trova un'email

Avvia una singola ricerca email per ottenere un id di ricerca.

Ottieni risultati in blocco

Recupera i risultati di una ricerca email in blocco.

Webhook

Ricevi una notifica automatica al completamento di una ricerca.

Autenticazione

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

Per iniziare

Email Finder

Email Verifier

Phone Finder

Account

Parametri di query

Risposta

200 — Ricerca completata

202 — Ricerca ancora in corso

Risposte di errore

Risultati di una ricerca a partire da un URL di profilo LinkedIn

Passaggi successivi

Trova un'email

Ottieni risultati in blocco

Webhook

Autenticazione

​Parametri di query

​Risposta

​200 — Ricerca completata

​202 — Ricerca ancora in corso

​Risposte di errore

​Risultati di una ricerca a partire da un URL di profilo LinkedIn

​Passaggi successivi

Trova un'email

Ottieni risultati in blocco

Webhook

Autenticazione

Parametri di query

Risposta

200 — Ricerca completata

202 — Ricerca ancora in corso

Risposte di errore

Risultati di una ricerca a partire da un URL di profilo LinkedIn

Passaggi successivi