curl --request GET \
--url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '3d4cb64e-i64d-41e8-a686-736751004a32';
const response = await fetch(`https://api.enrow.io/email/find/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "3d4cb64e-i64d-41e8-a686-736751004a32"
url = f"https://api.enrow.io/email/find/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "3d4cb64e-i64d-41e8-a686-736751004a32",
"status": "completed",
"custom": "campaign_q2"
},
"stats": {
"finished": 3,
"requested": 3,
"valid": 2,
"credits_cost": {
"initial": 3,
"refunded": 1,
"final": 2
}
},
"results": [
{
"index": "0",
"qualification": "valid",
"email": "dwight.schrute@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Dwight",
"lastname": "Schrute",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Dwight Schrute"
},
"custom": "lead_001"
},
{
"index": "1",
"qualification": "valid",
"email": "jim.halpert@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Jim",
"lastname": "Halpert",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Jim Halpert"
},
"custom": "lead_002"
},
{
"index": "2",
"qualification": "invalid",
"email": null,
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Ryan Howard"
},
"custom": "lead_003"
}
]
}
{
"message": "..."
}
Email Finder
Wyniki zbiorcze e-maili
Pobierz wyniki, statystyki i rozliczenie kredytów zbiorczego wyszukiwania e-maili na podstawie identyfikatora partii
GET
/
email
/
find
/
bulk
curl --request GET \
--url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '3d4cb64e-i64d-41e8-a686-736751004a32';
const response = await fetch(`https://api.enrow.io/email/find/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "3d4cb64e-i64d-41e8-a686-736751004a32"
url = f"https://api.enrow.io/email/find/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "3d4cb64e-i64d-41e8-a686-736751004a32",
"status": "completed",
"custom": "campaign_q2"
},
"stats": {
"finished": 3,
"requested": 3,
"valid": 2,
"credits_cost": {
"initial": 3,
"refunded": 1,
"final": 2
}
},
"results": [
{
"index": "0",
"qualification": "valid",
"email": "dwight.schrute@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Dwight",
"lastname": "Schrute",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Dwight Schrute"
},
"custom": "lead_001"
},
{
"index": "1",
"qualification": "valid",
"email": "jim.halpert@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Jim",
"lastname": "Halpert",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Jim Halpert"
},
"custom": "lead_002"
},
{
"index": "2",
"qualification": "invalid",
"email": null,
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Ryan Howard"
},
"custom": "lead_003"
}
]
}
{
"message": "..."
}
GET
Pobierz wszystkie wyniki ze zbiorczego wyszukiwania e-maili przy użyciu identyfikatora partii. Uwierzytelniaj każde żądanie swoim kluczem API w nagłówku
Zobacz Error handling, aby zapoznać się z pełną listą kodów statusu i formatów odpowiedzi.
https://api.enrow.io/email/find/bulk?id={id}
x-api-key. Identyfikator partii to id zwracany podczas uruchamiania zadania przez punkt końcowy Find Bulk Emails.
Użycie webhooka pozwala pominąć wywoływanie tego punktu końcowego GET. Zobacz How Webhooks Work.
Parametry zapytania
string
wymagane
id zwrócone z żądania POSTOdpowiedź
200 — Wyszukiwanie zakończone
object
object
Statystyki partii
Pokaż stats properties
Pokaż stats properties
number
Liczba ukończonych wyszukiwań
number
Łączna liczba zażądanych wyszukiwań
number
Liczba znalezionych prawidłowych e-maili
object
Rozliczenie kredytów. Kredyty są zwracane za nieprawidłowe lub nieznalezione wyniki — zobacz Credits & billing, aby dowiedzieć się, jak działają obciążenia i zwroty.
array
Tablica wyników wyszukiwania
Pokaż Result properties
Pokaż Result properties
string
Pozycja w pierwotnej tablicy wyszukiwania
string
valid (e-mail znaleziony) lub invalid (e-mail nieznaleziony). Dlaczego binarnie?string
Wykryty adres e-mail (gdy
valid)object
Dane kontaktowe:
domain, firstname, lastname, gender, companyInfo. Wartości firstname i lastname są zapisywane wielką literą. info jest obecne tylko dla prawidłowych wyników.object
Pierwotne wysłane parametry wyszukiwania
string | object
Dane niestandardowe przekazane w pierwotnym wyszukiwaniu
200 — Wyszukiwanie wciąż w toku
Gdy partia jest przetwarzana, punkt końcowy GET zwraca HTTP200 ze skróconym ciałem o kształcie { general: { id, status: "ongoing" }, stats: { finished, requested } }.
object
id oraz status: "ongoing"object
Liczniki
finished i requestedOdpowiedzi błędów
| Kod | Komunikat |
|---|---|
| 400 | Could not retrieve bulk search results |
curl --request GET \
--url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '3d4cb64e-i64d-41e8-a686-736751004a32';
const response = await fetch(`https://api.enrow.io/email/find/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "3d4cb64e-i64d-41e8-a686-736751004a32"
url = f"https://api.enrow.io/email/find/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "3d4cb64e-i64d-41e8-a686-736751004a32",
"status": "completed",
"custom": "campaign_q2"
},
"stats": {
"finished": 3,
"requested": 3,
"valid": 2,
"credits_cost": {
"initial": 3,
"refunded": 1,
"final": 2
}
},
"results": [
{
"index": "0",
"qualification": "valid",
"email": "dwight.schrute@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Dwight",
"lastname": "Schrute",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Dwight Schrute"
},
"custom": "lead_001"
},
{
"index": "1",
"qualification": "valid",
"email": "jim.halpert@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Jim",
"lastname": "Halpert",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Jim Halpert"
},
"custom": "lead_002"
},
{
"index": "2",
"qualification": "invalid",
"email": null,
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Ryan Howard"
},
"custom": "lead_003"
}
]
}
{
"message": "..."
}
Następne kroki
Wyszukiwanie zbiorcze e-maili
Rozpocznij nową partię do 5000 wyszukiwań e-maili.
Webhooki
Pomiń odpytywanie i otrzymuj powiadomienia o zakończeniu partii.
Kredyty i rozliczenia
Zobacz, jak kredyty są naliczane i zwracane za każdy wynik.
Weryfikacja zbiorcza e-maili
Zwaliduj listę adresów e-mail w jednej partii.
Czy ta strona była pomocna?

