Email finder

Find emails for a list

A background job for up to 10,000 people. Send rows (first_name and last_name, or name, plus domain and an optional ref of your own) or csv text with a header row. Same prices per row as a single lookup; maximum_charge is the most the list can cost. Set max_credits to cap the spend: the job pauses at that limit. It also pauses when credits run out, at the daily limit (it goes on after midnight UTC) or when most lookups find nothing. Repeated rows and rows without a usable name or domain are skipped for free.

CostWhat it doesKey scopes
Same as a single lookup, per row; capped by max_creditsSpends creditsargorant:unlock_contacts
post/api/v1/email-finder/jobs

Request

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

Headers

Idempotency-Keystring

Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.

X-Request-Idstring

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Request body

csvstring

CSV text with a header row, instead of rows. Columns like first_name, last_name, name, domain, company_domain, website and id are recognised.

namestring

A label for the list.

max_creditsnumber

Spending limit for this list in credits.

Example request

{
  "name": "Q4 accounts",
  "max_credits": 100
}

Response

Queued

okboolean

Changes

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