Email Finder

Find emails in bulk

Create a job that finds email addresses for a list of prospects. Each prospect needs a first name, a last name, and a company name or company domain — sending the domain as well improves accuracy.

The lookups run in the background, so the call returns straight away with 202 and a job_id. Poll GET /v1/email-finder/{job_id}/ for progress and results: it answers 202 while the job is still running and 200 once every prospect is done.

Webhook support: include a webhook_url and we POST the finished job to it instead, with the same payload as the retrieve endpoint, so you do not have to poll.

Cost: 1 credit per deliverable email found. Prospects with no email, or an email that fails verification, are not charged. Credits are taken when the job finishes.

post/v1/email-finder/

Request

  • Base URL: https://api.evaboot.com
  • URL: https://api.evaboot.com/v1/email-finder/
  • Auth: HTTP bearer

Request body

job_namestring

Your own label for the job, so you can recognize it later. Optional.

webhook_urlstring

Optional HTTPS URL to notify when the job finishes. We send a POST carrying the same payload as GET /v1/email-finder/{job_id}/, so you can skip polling.

write_backboolean

Write each result back onto the record its prospect's source_ref points to, once the job is paid for. Fills empty fields only and never creates a record.

Example request

{
  "job_name": "Tech Startup Email Hunt",
  "webhook_url": "https://myapp.com/webhook/email-finder",
  "prospects": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "company_name": "Example Corp",
      "company_domain": "example.com"
    }
  ],
  "source": {
    "source_id": "all",
    "max_leads": 2500
  }
}

Response

Accepted

successboolean

Always true; failures come back as an error response.

job_idstring required

Identifier of the queued job. Use it with GET /v1/email-finder/{job_id}/ to collect the results.

messagestring

Human-readable confirmation that the job was queued.

Example response

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Email finder job created and processing has begun"
}

Changes

No recorded changes to this operation across all 1 revision of this API.