Skip to main content
POST
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 x-api-key. Do operacji wsadowych użyj endpointu Find Bulk Emails (do 5000 wyszukiwań na partię). Wyszukiwanie musi zawierać jedną z dwóch opcji: Jeśli żądanie zawiera jedno i drugie, wyszukiwanie odbywa się na podstawie imienia i nazwiska oraz firmy.
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
Imię i nazwisko osoby, dla której ma zostać znaleziony e-mailUwaga: Wymagane przy wyszukiwaniu na podstawie imienia i nazwiska oraz firmy, ale nie przy wyszukiwaniu na podstawie linkedin_url.
string
Domena firmy, akceptowanych jest wiele formatów ("dundermifflin.com", "https://www.dundermifflin.com"…)Uwaga: Przy wyszukiwaniu na podstawie imienia i nazwiska oraz firmy wymagany jest co najmniej jeden z parametrów: company_domain lub company_name.
string
Nazwa firmy ("Apple", "Air France", …)Uwaga: Przy wyszukiwaniu na podstawie imienia i nazwiska oraz firmy wymagany jest co najmniej jeden z parametrów: company_domain lub company_name.
string
Adres URL profilu LinkedIn danej osoby ("https://www.linkedin.com/in/dwight-schrute"), aby wyszukiwać na podstawie profilu zamiast imienia i nazwiska oraz firmy. Zobacz Wyszukiwanie na podstawie adresu URL profilu LinkedIn.Uwaga: Używany tylko wtedy, gdy żądanie nie jest pełnym wyszukiwaniem na podstawie imienia i nazwiska oraz firmy. Jeśli podano fullname i firmę, linkedin_url jest ignorowany.
object
Niestandardowe parametry, które zostaną zwrócone w odpowiedzi GET oraz w powiadomieniu webhook.
object
Zestaw ustawień związanych z tym wyszukiwaniem

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

Odpowiedzi o niewystarczającej liczbie kredytów (402) na endpointach pojedynczych zwracają { "reason": "...", "success": false }; wszystkie pozostałe błędy zwracają { "message": "..." }.
Zobacz Error handling, aby poznać pełną listę kodów statusu i formatów odpowiedzi.

Wyszukiwanie na podstawie adresu URL profilu LinkedIn

Wyślij adres URL profilu LinkedIn danej osoby w linkedin_url zamiast imienia i nazwiska oraz firmy. Enrow odczytuje profil, ustala obecną firmę tej osoby, a następnie znajduje i weryfikuje jej służbowy adres e-mail w tej firmie. Wyszukiwanie przebiega jak każde inne pojedyncze wyszukiwanie: odpowiedź 200 zwraca jego id, a wynik otrzymasz przez endpoint GET lub swój webhook. custom i settings działają tak samo.
Wyszukiwanie na podstawie adresu URL profilu LinkedIn działa tylko w przypadku pojedynczych wyszukiwań i może nie być dostępne na każdym koncie. Jeśli Twoje konto nie ma tej funkcji, żądanie zawierające tylko linkedin_url otrzyma zwykły błąd walidacji, na przykład missing fullname. Jeśli jej potrzebujesz, skontaktuj się z nami pod adresem api@enrow.io.

Kiedy wyszukiwanie korzysta z profilu?

Wyszukiwanie odbywa się na podstawie profilu, gdy podano linkedin_url, a żądanie nie jest pełnym wyszukiwaniem na podstawie imienia i nazwiska oraz firmy:
  • pole fullname nie zostało podane, jest puste lub ma tylko jeden znak, albo
  • nie podano ani company_domain, ani company_name.
Żądanie z fullname i firmą pozostaje wyszukiwaniem na podstawie imienia i nazwiska oraz firmy, nawet jeśli zawiera linkedin_url. Gdy wyszukiwanie odbywa się na podstawie profilu, imię i nazwisko oraz firma pochodzą z profilu: przesłane dodatkowo pola fullname, company_domain lub company_name są ignorowane.

Jakie adresy URL są akceptowane?

Każda inna wartość jest odrzucana z kodem 400 i komunikatem invalid linkedin_url format: strona firmy (linkedin.com/company/...), skrócony link lnkd.in, strona spoza linkedin.com lub sama nazwa profilu bez adresu URL.

Jak Enrow wybiera firmę?

Enrow szuka adresu e-mail w obecnej firmie danej osoby, widocznej w profilu. Jeśli osoba ma kilka obecnych stanowisk, Enrow wybiera pierwsze z listy. Pozycje, które nie wskazują pracodawcy, np. samozatrudnienie, freelance czy studia, są pomijane. Jeśli profil nie ma obecnego stanowiska u pracodawcy, wyszukiwanie kończy się statusem no_current_company.

Ile to kosztuje?

Uruchomienie wyszukiwania zużywa 1 kredyt, jak w przypadku każdego wyszukiwania (credits_used: 1 w odpowiedzi). Po zakończeniu wyszukiwania różnica jest zwracana: wyszukiwanie kosztuje 1 kredyt, gdy zostanie znaleziony adres e-mail, 0,25 kredytu, gdy żaden nie zostanie znaleziony, i nic, gdy nie powiedzie się z powodu problemu po naszej stronie. Wynik podaje przyczynę w linkedin_status, a koszt końcowy w credits_used. Zobacz Kredyty i rozliczenia.

Przykład

Odpowiedź jest taka sama jak przy wyszukiwaniu na podstawie imienia i nazwiska oraz firmy:

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.