Spring til hovedindhold
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
Kør flere e-mailsøgninger i én enkelt forespørgsel. Op til 5.000 søgninger pr. batch. Autentificer hver forespørgsel med din API-nøgle i x-api-key-headeren. For at finde en enkelt e-mail i stedet kan du bruge endpointet Find Single Email.
Enrow udfører deterministiske verifikationer, der verificerer selv catch-all-e-mails. Ingen debouncer nødvendig.

Request Body

searches
array of objects
påkrævet
Søge-payloads, som der skal findes tilsvarende e-mails for.
custom
object
Brugerdefinerede parametre, der returneres i GET-svaret og i webhook-notifikationen.
settings
object
Indstillinger, der gælder for hele bulk-søgningen.

Response

201 — Bulk-søgning startet

message
string
Bekræftelsesmeddelelse
id
string
Unik identifikator for dette batch. Brug denne til at hente resultater via GET-endpointet.
credits_used
number
Samlet antal forbrugte credits. Se Credits og fakturering for omkostninger pr. endpoint.
estimated_duration
number
Estimeret behandlingstid i minutter (ikke garanteret)

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
Ved utilstrækkelige credits returnerer bulk-endpointet HTTP 402 med et body på formen { "message": "..." }. Se Fejlhåndtering for den fulde liste over statuskoder og svarformater.
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
}

Næste skridt

Hent bulk-resultater

Hent de fundne e-mails ved hjælp af batchets id.

Find en enkelt e-mail

Kør en enkelt e-mailsøgning ud fra et navn og en virksomhed.

Webhooks

Bliv notificeret automatisk, når et batch er færdigt.

Credits og fakturering

Se, hvordan credits forbruges for hvert endpoint.