Przejdź do głównej treści
POST
/
email
/
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
    }
  }'

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}
POST 
https://api.enrow.io/email/find/bulk
Uruchom wiele wyszukiwań e-maili w jednym żądaniu. Do 5000 wyszukiwań na partię. Uwierzytelniaj każde żądanie za pomocą klucza API w nagłówku x-api-key. Aby znaleźć pojedynczy e-mail, użyj punktu końcowego Find Single Email.
Enrow przeprowadza deterministyczne weryfikacje, które weryfikują nawet adresy typu catch-all. Nie jest potrzebny żaden debouncer.

​
Request Body

​
searches
array of objects
wymagane
Dane wyszukiwań, dla których mają zostać znalezione odpowiadające e-maile.
​
custom
object
Niestandardowe parametry, które zostaną zwrócone w odpowiedzi GET oraz w powiadomieniu webhook.
​
settings
object
Ustawienia dotyczące całego wyszukiwania zbiorczego.

​
Response

​
201 — Wyszukiwanie zbiorcze rozpoczęte

​
message
string
Komunikat potwierdzający
​
id
string
Unikalny identyfikator tej partii. Użyj go, aby pobrać wyniki przez punkt końcowy GET.
​
credits_used
number
Łączna liczba zużytych kredytów. Zobacz Kredyty i rozliczenia, aby poznać koszty poszczególnych punktów końcowych.
​
estimated_duration
number
Szacowany czas przetwarzania w minutach (niegwarantowany)

​
Error Responses

CodeMessage
400Missing payload
400Missing searches payload
400Too many searches. Limit is currently at 5000 per batch.
400Error while parsing payload
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient credits
W przypadku niewystarczającej liczby kredytów punkt końcowy zbiorczy zwraca HTTP 402 z treścią w postaci { "message": "..." }. Zobacz Obsługa błędów, aby poznać pełną listę kodów statusu i formatów odpowiedzi.
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
    }
  }'

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

​
Następne kroki

Pobierz wyniki zbiorcze

Pobierz znalezione e-maile, używając id partii.

Znajdź pojedynczy e-mail

Uruchom pojedyncze wyszukiwanie e-maila na podstawie imienia, nazwiska i firmy.

Webhooki

Otrzymuj automatyczne powiadomienia, gdy partia zostanie ukończona.

Kredyty i rozliczenia

Zobacz, jak zużywane są kredyty dla każdego punktu końcowego.