Find e-mails (bulk)

curl --request POST \
  --url https://api.enrow.io/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/bulk', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    searches: [
      { fullname: 'Dwight Schrute', company_domain: 'dundermifflin.com', custom: 'lead_001' },
      { fullname: 'Jim Halpert', company_domain: 'dundermifflin.com', custom: 'lead_002' },
      { fullname: 'Ryan Howard', company_domain: 'dundermifflin.com', custom: 'lead_003' }
    ],
    settings: {
      webhook: 'https://your-app.com/webhooks/enrow',
      retrieve_gender: true
    }
  })
});

const data = await response.json();
console.log(`Batch ID: ${data.id}`);

import requests
import os

url = "https://api.enrow.io/email/find/bulk"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "searches": [
        {"fullname": "Dwight Schrute", "company_domain": "dundermifflin.com", "custom": "lead_001"},
        {"fullname": "Jim Halpert", "company_domain": "dundermifflin.com", "custom": "lead_002"},
        {"fullname": "Ryan Howard", "company_domain": "dundermifflin.com", "custom": "lead_003"}
    ],
    "settings": {
        "webhook": "https://your-app.com/webhooks/enrow",
        "retrieve_gender": True
    }
}

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

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

{
  "message": "..."
}

POST

find

bulk

curl --request POST \
  --url https://api.enrow.io/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/bulk', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    searches: [
      { fullname: 'Dwight Schrute', company_domain: 'dundermifflin.com', custom: 'lead_001' },
      { fullname: 'Jim Halpert', company_domain: 'dundermifflin.com', custom: 'lead_002' },
      { fullname: 'Ryan Howard', company_domain: 'dundermifflin.com', custom: 'lead_003' }
    ],
    settings: {
      webhook: 'https://your-app.com/webhooks/enrow',
      retrieve_gender: true
    }
  })
});

const data = await response.json();
console.log(`Batch ID: ${data.id}`);

import requests
import os

url = "https://api.enrow.io/email/find/bulk"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "searches": [
        {"fullname": "Dwight Schrute", "company_domain": "dundermifflin.com", "custom": "lead_001"},
        {"fullname": "Jim Halpert", "company_domain": "dundermifflin.com", "custom": "lead_002"},
        {"fullname": "Ryan Howard", "company_domain": "dundermifflin.com", "custom": "lead_003"}
    ],
    "settings": {
        "webhook": "https://your-app.com/webhooks/enrow",
        "retrieve_gender": True
    }
}

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

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

{
  "message": "..."
}

POST

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

Kør flere e-mailsøgninger i én enkelt forespørgsel. Op til 5.000 søgninger pr. batch. Autentificer hver forespørgsel med din API-nøgle i x-api-key-headeren. For at finde en enkelt e-mail i stedet kan du bruge endpointet Find Single Email.

Enrow udfører deterministiske verifikationer, der verificerer selv catch-all-e-mails. Ingen debouncer nødvendig.

Request Body

array of objects

påkrævet

Søge-payloads, som der skal findes tilsvarende e-mails for.

Vis search-objektets egenskaber

string

påkrævet

Brugerens fulde navn

string

Virksomhedens domæne eller website-URL. Enten company_domain eller company_name er påkrævet.

string

Navnet på brugerens virksomhed. Enten company_domain eller company_name er påkrævet.

string | object

En brugerdefineret værdi, du kan bruge til at referere til et internt ID (for eksempel). Den vil være til stede i resultaterne.

object

Brugerdefinerede parametre, der returneres i GET-svaret og i webhook-notifikationen.

Vis custom-objekt

string

standard:"your_custom_property"

Dine egne brugerdefinerede data

object

Indstillinger, der gælder for hele bulk-søgningen.

Vis settings-egenskaber

string

standard:"US"

En 2-tegns kode, der repræsenterer landet for søgningerne (ISO 3166 Alpha-2-kode). Relevant ved brug af company_name.

string

En URL, der notificeres via en HTTP POST-forespørgsel, når bulk-søgningen er færdig. Se Sådan fungerer webhooks.

boolean

standard:"false"

Hent det tilknyttede køn, når en e-mail findes.

boolean

standard:"false"

Hent de tilknyttede virksomhedsoplysninger. Kun effektivt, når country_code er FR.

Response

201 — Bulk-søgning startet

string

Bekræftelsesmeddelelse

string

Unik identifikator for dette batch. Brug denne til at hente resultater via GET-endpointet.

number

Samlet antal forbrugte credits. Se Credits og fakturering for omkostninger pr. endpoint.

number

Estimeret behandlingstid i minutter (ikke garanteret)

Error Responses

Code	Message
400	`Missing payload`
400	`Missing searches payload`
400	`Too many searches. Limit is currently at 5000 per batch.`
400	`Error while parsing payload`
401	`No apikey found in the x-api-key headers`
401	`This apikey is not valid`
402	`Insufficient credits`

Ved utilstrækkelige credits returnerer bulk-endpointet HTTP 402 med et body på formen { "message": "..." }. Se Fejlhåndtering for den fulde liste over statuskoder og svarformater.

curl --request POST \
  --url https://api.enrow.io/email/find/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "fullname": "Dwight Schrute",
        "company_domain": "dundermifflin.com",
        "custom": "lead_001"
      },
      {
        "fullname": "Jim Halpert",
        "company_domain": "dundermifflin.com",
        "custom": "lead_002"
      },
      {
        "fullname": "Ryan Howard",
        "company_domain": "dundermifflin.com",
        "custom": "lead_003"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow",
      "retrieve_gender": true
    }
  }'

const response = await fetch('https://api.enrow.io/email/find/bulk', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ENROW_API_KEY
  },
  body: JSON.stringify({
    searches: [
      { fullname: 'Dwight Schrute', company_domain: 'dundermifflin.com', custom: 'lead_001' },
      { fullname: 'Jim Halpert', company_domain: 'dundermifflin.com', custom: 'lead_002' },
      { fullname: 'Ryan Howard', company_domain: 'dundermifflin.com', custom: 'lead_003' }
    ],
    settings: {
      webhook: 'https://your-app.com/webhooks/enrow',
      retrieve_gender: true
    }
  })
});

const data = await response.json();
console.log(`Batch ID: ${data.id}`);

import requests
import os

url = "https://api.enrow.io/email/find/bulk"
headers = {
    "Content-Type": "application/json",
    "x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
    "searches": [
        {"fullname": "Dwight Schrute", "company_domain": "dundermifflin.com", "custom": "lead_001"},
        {"fullname": "Jim Halpert", "company_domain": "dundermifflin.com", "custom": "lead_002"},
        {"fullname": "Ryan Howard", "company_domain": "dundermifflin.com", "custom": "lead_003"}
    ],
    "settings": {
        "webhook": "https://your-app.com/webhooks/enrow",
        "retrieve_gender": True
    }
}

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

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

{
  "message": "..."
}

Næste skridt

Hent bulk-resultater

Hent de fundne e-mails ved hjælp af batchets id.

Find en enkelt e-mail

Kør en enkelt e-mailsøgning ud fra et navn og en virksomhed.

Webhooks

Bliv notificeret automatisk, når et batch er færdigt.

Credits og fakturering

Se, hvordan credits forbruges for hvert endpoint.

Kom godt i gang

Email Finder

Email Verifier

Phone Finder

Konto

Request Body

Response

201 — Bulk-søgning startet

Error Responses

Næste skridt

Hent bulk-resultater

Find en enkelt e-mail

Webhooks

Credits og fakturering

​Request Body

​Response

​201 — Bulk-søgning startet

​Error Responses

​Næste skridt

Hent bulk-resultater

Find en enkelt e-mail

Webhooks

Credits og fakturering

Request Body

Response

201 — Bulk-søgning startet

Error Responses

Næste skridt