Przejdź do głównej treści
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'
{
  "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"
    }
  ]
}
GET
https://api.enrow.io/email/find/bulk?id={id}
Pobierz wszystkie wyniki ze zbiorczego wyszukiwania e-maili przy użyciu identyfikatora partii. Uwierzytelniaj każde żądanie swoim kluczem API w nagłówku 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

id
string
wymagane
id zwrócone z żądania POST

Odpowiedź

200 — Wyszukiwanie zakończone

general
object
Metadane partii
stats
object
Statystyki partii
results
array
Tablica wyników wyszukiwania

200 — Wyszukiwanie wciąż w toku

Gdy partia jest przetwarzana, punkt końcowy GET zwraca HTTP 200 ze skróconym ciałem o kształcie { general: { id, status: "ongoing" }, stats: { finished, requested } }.
general
object
id oraz status: "ongoing"
stats
object
Liczniki finished i requested

Odpowiedzi błędów

KodKomunikat
400Could not retrieve bulk search results
Zobacz Error handling, aby zapoznać się z pełną listą kodów statusu i formatów odpowiedzi.
curl --request GET \
  --url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
  --header 'x-api-key: YOUR_API_KEY'
{
  "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"
    }
  ]
}

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.