Pobierz wynik e-mail

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}

Pobierz wynik wcześniej uruchomionego wyszukiwania e-maila przy użyciu jego unikalnego ID. Uwierzytelniaj każde żądanie za pomocą klucza API w nagłówku x-api-key.

Użycie webhooka pozwala pominąć wywoływanie tego endpointu GET, ponieważ otrzymasz powiadomienie w momencie zakończenia wyszukiwania. Zobacz Jak działają webhooki.

Parametry zapytania

string

wymagane

Unikalny identyfikator zwrócony z żądania POST

Odpowiedź

200 — Wyszukiwanie zakończone

string

Znaleziony adres e-mail

string

valid (e-mail znaleziony) lub invalid (e-mail nieznaleziony). Dlaczego binarna?

number

Koszt końcowy wyszukiwania po zwrotach: 1 za znaleziony adres e-mail, 0 za nieznaleziony (0.25 dla wyszukiwania na podstawie adresu URL profilu LinkedIn lub dla konta z nienormalnie niskim wskaźnikiem skuteczności, zobacz Kredyty i rozliczenia). Wyszukiwanie na podstawie adresu URL profilu LinkedIn, które nie powiedzie się z powodu problemu po naszej stronie, kosztuje 0: zobacz Wyniki wyszukiwania na podstawie adresu URL profilu LinkedIn.

object

Informacje o kontakcie i firmie. W przypadku wyszukiwania na podstawie adresu URL profilu LinkedIn obecne tylko wtedy, gdy zostanie znaleziony adres e-mail.

Pokaż właściwości info

string

Domena firmy

string

Nazwa firmy

string

Pełne imię i nazwisko podane w żądaniu

string

Imię

string

Nazwisko

string

Płeć (male lub female) — tylko jeśli retrieve_gender zostało ustawione na true

object

Niestandardowe właściwości przekazane w pierwotnym żądaniu, zwrócone bez zmian

string

Tylko w przypadku wyszukiwania na podstawie adresu URL profilu LinkedIn. Informuje, jak zakończyło się wyszukiwanie: found, profile_not_found, no_current_company, email_not_found lub lookup_failed. Zobacz Wyniki wyszukiwania na podstawie adresu URL profilu LinkedIn.

string

Tylko w przypadku wyszukiwania na podstawie adresu URL profilu LinkedIn. Wysłany przez Ciebie linkedin_url.

202 — Wyszukiwanie wciąż w toku

string

ongoing — wyszukiwanie nie zostało jeszcze zakończone. Sprawdź ponownie za chwilę lub użyj webhooka, aby otrzymać powiadomienie automatycznie. Pobranie wyniku nie zużywa kredytów; zobacz Kredyty i rozliczenia.

Odpowiedzi błędów

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

Zobacz Obsługa błędów, aby zapoznać się z pełną listą kodów statusu i formatów odpowiedzi.

Wyniki wyszukiwania na podstawie adresu URL profilu LinkedIn

Wyszukiwanie uruchomione na podstawie adresu URL profilu LinkedIn zachowuje binarne pole qualification i dodaje dwa pola: linkedin_status, które informuje, jak zakończyło się wyszukiwanie, oraz linkedin_url, czyli wysłany przez Ciebie adres URL.

`linkedin_status`	Znaczenie	`qualification`	`credits_used`
`found`	Służbowy adres e-mail tej osoby został znaleziony i zweryfikowany	`valid`	`1`
`profile_not_found`	Pod tym adresem URL LinkedIn nie znaleziono żadnego profilu	`invalid`	`0.25`
`no_current_company`	Profil nie wskazuje obecnego stanowiska, na podstawie którego można wyszukiwać	`invalid`	`0.25`
`email_not_found`	Profil znaleziony, ale nie znaleziono adresu e-mail w obecnej firmie tej osoby	`invalid`	`0.25`
`lookup_failed`	Nie udało się ukończyć wyszukiwania z powodu problemu po naszej stronie. Koszt jest zwracany w całości: spróbuj ponownie za kilka minut	`invalid`	`0`

Gdy adres e-mail zostanie znaleziony, pole info podaje imię i nazwisko oraz firmę odczytane z profilu: firstname, lastname, company_name i company_domain, a także gender, gdy retrieve_gender ma wartość true. We wszystkich pozostałych przypadkach odpowiedź nie zawiera ani email, ani info: nigdy nie ujawnia, do kogo należy profil. Jeśli adres e-mail lub profil znajduje się na Twojej liście wykluczeń, znaleziony adres e-mail nie jest zwracany: wynik ma status email_not_found i kosztuje 1 kredyt, tak jak znaleziony adres e-mail. Dopóki wyszukiwanie trwa, endpoint zwraca standardową odpowiedź 202 z 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": "..."
}

Następne kroki

Znajdź e-mail

Uruchom pojedyncze wyszukiwanie e-maila, aby uzyskać id wyszukiwania.

Pobierz wyniki zbiorcze

Pobierz wyniki zbiorczego wyszukiwania e-maili.

Webhooki

Otrzymuj powiadomienia automatycznie po zakończeniu wyszukiwania.

Uwierzytelnianie

Jak przekazać klucz API w nagłówku x-api-key.

Pierwsze kroki

Email Finder

Email Verifier

Phone Finder

Konto

Parametry zapytania

Odpowiedź

200 — Wyszukiwanie zakończone

202 — Wyszukiwanie wciąż w toku

Odpowiedzi błędów

Wyniki wyszukiwania na podstawie adresu URL profilu LinkedIn

Następne kroki

Znajdź e-mail

Pobierz wyniki zbiorcze

Webhooki

Uwierzytelnianie

​Parametry zapytania

​Odpowiedź

​200 — Wyszukiwanie zakończone

​202 — Wyszukiwanie wciąż w toku

​Odpowiedzi błędów

​Wyniki wyszukiwania na podstawie adresu URL profilu LinkedIn

​Następne kroki

Znajdź e-mail

Pobierz wyniki zbiorcze

Webhooki

Uwierzytelnianie

Parametry zapytania

Odpowiedź

200 — Wyszukiwanie zakończone

202 — Wyszukiwanie wciąż w toku

Odpowiedzi błędów

Wyniki wyszukiwania na podstawie adresu URL profilu LinkedIn

Następne kroki