E-mail vinden

curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/single', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    fullname: 'Dwight Schrute',
    company_domain: 'dundermifflin.com',
    settings: {
      retrieve_gender: true
    }
  })
});

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

import requests
import os

url = "https://api.enrow.io/email/find/single"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
        "retrieve_gender": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

{
  "message": "..."
}

POST

find

single

curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/single', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    fullname: 'Dwight Schrute',
    company_domain: 'dundermifflin.com',
    settings: {
      retrieve_gender: true
    }
  })
});

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

import requests
import os

url = "https://api.enrow.io/email/find/single"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
        "retrieve_gender": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

{
  "message": "..."
}

POST

https://api.enrow.io/email/find/single

Voer één e-mailzoekopdracht uit om een professioneel e-mailadres te vinden. Authenticeer elk verzoek met je API-sleutel in de x-api-key-header. Gebruik voor batchbewerkingen het Find Bulk Emails-endpoint (tot 5.000 zoekopdrachten per batch). De zoekopdracht heeft een van de volgende gegevens nodig:

Een volledige naam en een bedrijf: fullname + (company_domain of company_name)
De URL van het LinkedIn-profiel van een persoon in linkedin_url (zie Zoeken op basis van een LinkedIn-profiel-URL)

Zijn beide aanwezig, dan wordt er gezocht op de naam en het bedrijf.

Enrow voert deterministische verificaties uit die zelfs catch-all-e-mails verifiëren. Dit betekent dat het achteraf door een debouncer halen van de gevonden e-mails niet nodig is.

Request Body

string

De volledige naam van de persoon voor wie het e-mailadres moet worden gevondenOpmerking: Verplicht bij een zoekopdracht op naam en bedrijf, niet bij een zoekopdracht op basis van linkedin_url.

string

Het domein van het bedrijf, meerdere formaten worden geaccepteerd ("dundermifflin.com", "https://www.dundermifflin.com"…)Opmerking: Ofwel company_domain ofwel company_name is vereist voor een zoekopdracht op naam en bedrijf.

string

De naam van het bedrijf ("Apple", "Air France", …)Opmerking: Ofwel company_domain ofwel company_name is vereist voor een zoekopdracht op naam en bedrijf.

string

De LinkedIn-profiel-URL van de persoon ("https://www.linkedin.com/in/dwight-schrute"), om te zoeken op basis van het profiel in plaats van een naam en een bedrijf. Zie Zoeken op basis van een LinkedIn-profiel-URL.Opmerking: Wordt alleen gebruikt als het verzoek geen volledige zoekopdracht op naam en bedrijf is. Met een fullname en een bedrijf wordt linkedin_url genegeerd.

object

Aangepaste parameters die worden teruggegeven in de GET-respons en in de webhook-notificatie.

Tonen custom object

string

standaard:"your_custom_property"

Uw eigen aangepaste gegevens

object

Een set instellingen die betrekking heeft op deze zoekopdracht

Tonen settings properties

string

Een URL die via een HTTP POST-verzoek wordt genotificeerd zodra de enkele zoekopdracht is voltooid. Zie How Webhooks Work.

string

standaard:"US"

De ISO 3166 Alpha-2-code van het land dat betrekking heeft op de zoekopdracht. Relevant bij gebruik van een bedrijfsnaam — helpt om naamgenoten te onderscheiden door te zoeken op gelokaliseerde Google.

boolean

standaard:"false"

Hiermee kunt u het geslacht (male/female) van de persoon verkrijgen.

Response

200 — Zoekopdracht gestart

string

Bevestigingsbericht

string

Unieke identificator voor deze zoekopdracht. Gebruik deze om resultaten op te halen via het GET endpoint.

number

Aantal verbruikte credits. Zie Credits & billing voor de kosten per endpoint.

Foutresponsen

Code	Message
400	`invalid JSON input`
400	`both company_domain and company_name are absent, input payload needs at least one of them`
400	`missing fullname`
400	`invalid linkedin_url format`
400	`LinkedIn email search is suspended for this account`
401	`No apikey found in the x-api-key headers`
401	`This apikey is not valid`
402	`Insufficient credits`

Responsen met onvoldoende credits (402) op enkele endpoints geven { "reason": "...", "success": false } terug; alle andere fouten geven { "message": "..." } terug.

Zie Error handling voor de volledige lijst met statuscodes en responsformaten.

Zoeken op basis van een LinkedIn-profiel-URL

Stuur de LinkedIn-profiel-URL van een persoon mee in linkedin_url in plaats van een volledige naam en een bedrijf. Enrow leest het profiel, bepaalt het huidige bedrijf van de persoon en vindt en verifieert daar vervolgens het professionele e-mailadres. De zoekopdracht verloopt zoals elke andere enkele zoekopdracht: de 200-response geeft je de id, en het resultaat komt binnen via het GET-endpoint of je webhook. custom en settings werken op dezelfde manier.

Zoeken op basis van een LinkedIn-profiel-URL werkt alleen voor enkele zoekopdrachten en is mogelijk niet op elk account beschikbaar. Heeft je account er geen toegang toe, dan krijgt een verzoek met alleen een linkedin_url de gebruikelijke validatiefout, zoals missing fullname. Neem contact met ons op via api@enrow.io als je het nodig hebt.

Wanneer gebruikt de zoekopdracht het profiel?

De zoekopdracht gaat uit van het profiel als linkedin_url is opgegeven en het verzoek geen volledige zoekopdracht op naam en bedrijf is:

fullname ontbreekt, is leeg of bestaat uit één teken, of
company_domain en company_name ontbreken allebei.

Een verzoek met een fullname en een bedrijf blijft een zoekopdracht op naam en bedrijf, ook met een linkedin_url. Gaat de zoekopdracht uit van het profiel, dan komen de naam en het bedrijf uit het profiel: een meegestuurde fullname, company_domain of company_name wordt genegeerd.

Welke URL’s worden geaccepteerd?

Formaat	Voorbeeld
Openbare profiel-URL	`https://www.linkedin.com/in/dwight-schrute`
Zonder `https://` of `www.`, met een slash aan het eind of een querystring	`linkedin.com/in/dwight-schrute/?trk=people-guest`
Landspecifiek subdomein	`https://fr.linkedin.com/in/dwight-schrute`
Profiel-URL met een lid-ID	`https://www.linkedin.com/in/ACoAAB2xY3ZaBcD`
Sales Navigator-URL (lead of people)	`https://www.linkedin.com/sales/lead/ACwAAB2xY3ZaBcD,NAME_SEARCH,a1b2`

Elke andere waarde wordt geweigerd met een 400 en de melding invalid linkedin_url format: een bedrijfspagina (linkedin.com/company/...), een verkorte lnkd.in-link, een pagina buiten linkedin.com, of alleen een profielnaam zonder URL.

Hoe kiest Enrow het bedrijf?

Enrow zoekt het e-mailadres bij het huidige bedrijf van de persoon, zoals dat op het profiel staat. Heeft de persoon meerdere huidige functies, dan neemt Enrow de eerste in de lijst. Vermeldingen die geen werkgever zijn, zoals zelfstandige, freelancer of student, worden overgeslagen. Heeft het profiel geen huidige functie bij een werkgever, dan eindigt de zoekopdracht met no_current_company.

Wat kost het?

Het starten van de zoekopdracht kost 1 credit, net als bij elke zoekopdracht (credits_used: 1 in de response). Zodra de zoekopdracht klaar is, wordt het verschil terugbetaald: de zoekopdracht kost 1 credit als er een e-mailadres wordt gevonden, 0,25 credit als er geen wordt gevonden, en niets als die mislukt door een probleem aan onze kant. Het resultaat geeft de reden in linkedin_status en de uiteindelijke kosten in credits_used. Zie Credits en facturering.

Voorbeeld

curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
    "custom": {
      "crm_id": "lead_001"
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/single', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    linkedin_url: 'https://www.linkedin.com/in/dwight-schrute',
    custom: {
      crm_id: 'lead_001'
    }
  })
});

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

import requests
import os

url = "https://api.enrow.io/email/find/single"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
    "custom": {
        "crm_id": "lead_001"
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

De response is dezelfde als bij een zoekopdracht op naam en bedrijf:

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/single', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    fullname: 'Dwight Schrute',
    company_domain: 'dundermifflin.com',
    settings: {
      retrieve_gender: true
    }
  })
});

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

import requests
import os

url = "https://api.enrow.io/email/find/single"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "fullname": "Dwight Schrute",
    "company_domain": "dundermifflin.com",
    "settings": {
        "retrieve_gender": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

{
  "message": "..."
}

Volgende stappen

Het resultaat ophalen

Haal de gevonden e-mail op met de id van de zoekopdracht.

E-mails in bulk vinden

Voer tot 5.000 e-mailzoekopdrachten uit in één verzoek.

Authenticatie

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

Webhooks

Word automatisch genotificeerd wanneer een zoekopdracht is voltooid.

Aan de slag

Email Finder

Email Verifier

Phone Finder

Account

Request Body

Response

200 — Zoekopdracht gestart

Foutresponsen

Zoeken op basis van een LinkedIn-profiel-URL

Wanneer gebruikt de zoekopdracht het profiel?

Welke URL’s worden geaccepteerd?

Hoe kiest Enrow het bedrijf?

Wat kost het?

Voorbeeld

Volgende stappen

Het resultaat ophalen

E-mails in bulk vinden

Authenticatie

Webhooks

​Request Body

​Response

​200 — Zoekopdracht gestart

​Foutresponsen

​Zoeken op basis van een LinkedIn-profiel-URL

​Wanneer gebruikt de zoekopdracht het profiel?

​Welke URL’s worden geaccepteerd?

​Hoe kiest Enrow het bedrijf?

​Wat kost het?

​Voorbeeld

​Volgende stappen

Het resultaat ophalen

E-mails in bulk vinden

Authenticatie

Webhooks

Request Body

Response

200 — Zoekopdracht gestart

Foutresponsen

Zoeken op basis van een LinkedIn-profiel-URL

Wanneer gebruikt de zoekopdracht het profiel?

Welke URL’s worden geaccepteerd?

Hoe kiest Enrow het bedrijf?

Wat kost het?

Voorbeeld

Volgende stappen