Create a batch of email address lookups
/v1/lookup/email/batchconst answer = await bird.lookup.emailBatch({
emails: ["aisha.khan@example.com", "not-an-email"],
});
for (const item of answer.data) console.log(item.email, item.result);answer = client.lookup.email_batch(emails=["aisha.khan@example.com", "not-an-email"])
for item in answer.data:
print(item.email, item.result)answer, err := client.Lookup.EmailBatch(context.Background(), bird.LookupEmailBatchParams{
Emails: []string{"aisha.khan@example.com", "not-an-email"},
})
if err != nil {
log.Fatal(err)
}
for _, item := range *answer.Data {
fmt.Println(*item.Email, *item.Result)
}$answer = $bird->lookup->emailBatch(
(new EmailLookupBatchRequest())->setEmails(['aisha.khan@example.com', 'not-an-email']),
);
foreach ($answer->getData() ?? [] as $item) {
echo $item->getEmail(), ' ', $item->getResult();
}bird lookup email-batch \
--emails aisha.khan@example.com \
--emails not-an-emailcurl -X POST "https://us1.platform.bird.com/v1/lookup/email/batch" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"emails": [
"aisha.khan@example.com",
"not-an-email"
]
}'{
"data": [
{
"email": "aisha.khan@example.com",
"valid": true,
"result": "risky",
"delivery_confidence": 42,
"flags": [
"role",
"free_provider"
]
}
]
}
Assesses up to 1,000 email addresses synchronously and returns one result per input in submission order. Malformed addresses receive individual assessments. Duplicate addresses remain separate entries and each answered entry is billed at the email lookup rate. Use Create an email address lookup for a single address. A batch consumes one request allowance under the shared lookup rate limit, regardless of its number of addresses.
Requests must fit within 128 KiB. Split larger lists into separate requests.
Reuse an Idempotency-Key for retries of the same batch. Successful responses
up to 256 KiB can be retained for replay; larger responses are returned but
are not retained, so retrying can perform and charge for another batch.
An unavailable lookup returns 503 without charging for the batch.
请求载荷
emailsAddresses to assess in submission order. Surrounding whitespace is trimmed and case is preserved. Malformed addresses receive individual assessments. Duplicates are assessed and billed at each position. The request must also fit within the 128 KiB request-body limit.
响应载荷
dataOne assessment per submitted address, in submission order, including duplicates.