E-mailresultaat ophalen

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}

Haal het resultaat op van een eerder gestarte e-mailzoekopdracht met behulp van het unieke ID. Authenticeer elk verzoek met je API-sleutel in de x-api-key-header.

Met een webhook kun je deze GET-endpoint overslaan, omdat je op het moment dat je zoekopdracht klaar is meteen een melding ontvangt. Zie Hoe webhooks werken.

Queryparameters

string

vereist

De unieke identifier die door het POST-verzoek wordt geretourneerd

Response

200 — Zoekopdracht voltooid

string

Het gevonden e-mailadres

string

valid (e-mail gevonden) of invalid (e-mail niet gevonden). Waarom binair?

number

Uiteindelijke kosten van de zoekopdracht na terugbetalingen: 1 voor een gevonden e-mailadres, 0 voor een niet-gevonden e-mailadres (0.25 voor een zoekopdracht op basis van een LinkedIn-profiel-URL of voor een account met een abnormaal laag succespercentage, zie Credits & facturatie). Een zoekopdracht op basis van een LinkedIn-profiel-URL die mislukt door een probleem aan onze kant, kost 0: zie Resultaten van een zoekopdracht op basis van een LinkedIn-profiel-URL.

object

Contact- en bedrijfsinformatie. Bij een zoekopdracht op basis van een LinkedIn-profiel-URL alleen aanwezig als er een e-mailadres is gevonden.

Tonen info-eigenschappen

string

Bedrijfsdomein

string

Bedrijfsnaam

string

Volledige naam zoals opgegeven in het verzoek

string

Voornaam

string

Achternaam

string

Geslacht (male of female) — alleen als retrieve_gender op true was ingesteld

object

Aangepaste eigenschappen die in het oorspronkelijke verzoek zijn meegegeven, ongewijzigd geretourneerd

string

Alleen bij een zoekopdracht op basis van een LinkedIn-profiel-URL. Hoe de zoekopdracht is afgelopen: found, profile_not_found, no_current_company, email_not_found of lookup_failed. Zie Resultaten van een zoekopdracht op basis van een LinkedIn-profiel-URL.

string

Alleen bij een zoekopdracht op basis van een LinkedIn-profiel-URL. De linkedin_url die je hebt meegestuurd.

202 — Zoekopdracht nog bezig

string

ongoing — de zoekopdracht is nog niet voltooid. Vraag binnenkort opnieuw op, of gebruik een webhook om automatisch op de hoogte te worden gesteld. Het ophalen van een resultaat verbruikt geen credits; zie Credits en facturering.

Foutreacties

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

Zie Foutafhandeling voor de volledige lijst met statuscodes en responsformaten.

Resultaten van een zoekopdracht op basis van een LinkedIn-profiel-URL

Een zoekopdracht die is gestart op basis van een LinkedIn-profiel-URL behoudt het binaire veld qualification en voegt twee velden toe: linkedin_status, dat aangeeft hoe de zoekopdracht is afgelopen, en linkedin_url, de URL die je hebt meegestuurd.

`linkedin_status`	Betekenis	`qualification`	`credits_used`
`found`	Het professionele e-mailadres van de persoon is gevonden en geverifieerd	`valid`	`1`
`profile_not_found`	Geen profiel gevonden op deze LinkedIn-URL	`invalid`	`0.25`
`no_current_company`	Het profiel vermeldt geen huidige functie om de zoekopdracht op te baseren	`invalid`	`0.25`
`email_not_found`	Profiel gevonden, maar geen e-mailadres bij het huidige bedrijf van de persoon	`invalid`	`0.25`
`lookup_failed`	De zoekopdracht kon niet worden voltooid door een probleem aan onze kant. De kosten worden volledig terugbetaald: probeer het over een paar minuten opnieuw	`invalid`	`0`

Als het e-mailadres is gevonden, geeft info de naam en het bedrijf zoals ze op het profiel staan: firstname, lastname, company_name en company_domain, plus gender als retrieve_gender op true staat. In alle andere gevallen bevat de response geen email en geen info: er staat nooit in van wie het profiel is. Staat het e-mailadres of het profiel op je suppressielijst, dan wordt het gevonden e-mailadres achtergehouden: het resultaat toont email_not_found en kost 1 credit, net als een gevonden e-mailadres. Zolang de zoekopdracht loopt, retourneert het endpoint de gebruikelijke 202 met 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": "..."
}

Volgende stappen

Een e-mail vinden

Start een enkele e-mailzoekopdracht om een zoek-id te verkrijgen.

Bulkresultaten ophalen

Haal de resultaten van een bulk-e-mailzoekopdracht op.

Webhooks

Word automatisch op de hoogte gesteld wanneer een zoekopdracht is voltooid.

Authenticatie

Hoe je je API-sleutel meegeeft in de x-api-key-header.

Aan de slag

Email Finder

Email Verifier

Phone Finder

Account

Queryparameters

Response

200 — Zoekopdracht voltooid

202 — Zoekopdracht nog bezig

Foutreacties

Resultaten van een zoekopdracht op basis van een LinkedIn-profiel-URL

Volgende stappen

Een e-mail vinden

Bulkresultaten ophalen

Webhooks

Authenticatie

​Queryparameters

​Response

​200 — Zoekopdracht voltooid

​202 — Zoekopdracht nog bezig

​Foutreacties

​Resultaten van een zoekopdracht op basis van een LinkedIn-profiel-URL

​Volgende stappen

Een e-mail vinden

Bulkresultaten ophalen

Webhooks

Authenticatie

Queryparameters

Response

200 — Zoekopdracht voltooid

202 — Zoekopdracht nog bezig

Foutreacties

Resultaten van een zoekopdracht op basis van een LinkedIn-profiel-URL

Volgende stappen