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": "..."
}
Email Finder
Znajdź adres e-mail
Znajdź pojedynczy służbowy adres e-mail na podstawie imienia i nazwiska oraz domeny lub nazwy firmy
POST
/
email
/
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
Uruchom pojedyncze wyszukiwanie e-maila, aby znaleźć służbowy adres e-mail. Uwierzytelniaj każde żądanie za pomocą swojego klucza API w nagłówku
Zobacz Error handling, aby poznać pełną listę kodów statusu i formatów odpowiedzi.
https://api.enrow.io/email/find/single
x-api-key. Do operacji wsadowych użyj endpointu Find Bulk Emails (do 5000 wyszukiwań na partię).
Enrow przeprowadza deterministyczne weryfikacje, które weryfikują nawet adresy catch-all. Oznacza to, że nie trzeba później przepuszczać znalezionych adresów przez debouncer.
Request Body
string
wymagane
Imię i nazwisko osoby, dla której ma zostać znaleziony e-mail
string
Domena firmy, akceptowanych jest wiele formatów (
"dundermifflin.com", "https://www.dundermifflin.com"…)Uwaga: Wymagany jest co najmniej jeden z parametrów: company_domain lub company_name.string
Nazwa firmy (
"Apple", "Air France", …)Uwaga: Wymagany jest co najmniej jeden z parametrów: company_domain lub company_name.object
Niestandardowe parametry, które zostaną zwrócone w odpowiedzi GET oraz w powiadomieniu webhook.
Pokaż custom object
Pokaż custom object
string
domyślnie:"your_custom_property"
Twoje niestandardowe dane
object
Zestaw ustawień związanych z tym wyszukiwaniem
Pokaż settings properties
Pokaż settings properties
string
Adres URL, który zostanie powiadomiony za pomocą żądania HTTP POST po zakończeniu pojedynczego wyszukiwania. Zobacz How Webhooks Work.
string
domyślnie:"US"
Kod kraju ISO 3166 Alpha-2 powiązany z wyszukiwaniem. Istotny przy korzystaniu z nazwy firmy — pomaga rozróżnić homonimy poprzez wyszukiwanie w zlokalizowanej wersji Google.
boolean
domyślnie:"false"
Pozwala uzyskać płeć (
male/female) osoby.boolean
domyślnie:"false"
Zwraca dodatkowe informacje o firmie w wyniku. Obecnie działa tylko wtedy, gdy
country_code ma wartość FR.Response
200 — Wyszukiwanie zainicjowane
string
Komunikat potwierdzający
string
Unikalny identyfikator tego wyszukiwania. Użyj go, aby pobrać wyniki za pomocą endpointu GET.
number
Liczba zużytych kredytów. Zobacz Credits & billing, aby poznać koszty poszczególnych endpointów.
Error Responses
| 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 |
| 401 | No apikey found in the x-api-key headers |
| 401 | This apikey is not valid |
| 402 | Insufficient credits |
Odpowiedzi o niewystarczającej liczbie kredytów (
402) na endpointach pojedynczych zwracają { "reason": "...", "success": false }; wszystkie pozostałe błędy zwracają { "message": "..." }.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": "..."
}
Następne kroki
Pobierz wynik
Pobierz znaleziony e-mail przy użyciu
id wyszukiwania.Znajdź adresy e-mail zbiorczo
Uruchom do 5000 wyszukiwań e-maili w jednym żądaniu.
Uwierzytelnianie
Jak przekazać klucz API w nagłówku x-api-key.
Webhooki
Otrzymuj automatyczne powiadomienia po zakończeniu wyszukiwania.
Czy ta strona była pomocna?

