Use the bulk endpoint for enrichment runs. The single lookup is rate limited for interactive use.
How it works
- Submit a batch to Bulk work email lookup. You get back a
batch_id and a status_check_url.
- Poll Bulk work email lookup status and results until
status is completed. Until then results is empty.
- When complete,
results holds one result per submitted lookup, in the order you submitted them.
Polling is free. Items already answered by Forager’s cache are resolved immediately. Duplicates in the request collapse into one lookup. Your credit balance must cover the whole batch, otherwise the batch is rejected and nothing is charged.
Submit a batch
Each item identifies a person in one of two ways:
first_name, last_name and domain (a company domain such as acme.com), orlinkedin_public_identifier alone.
Sending a domain and a LinkedIn identifier in the same item is refused.
Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID in your shell first, as in the quickstart. See Authentication.
Poll the batch
Set BATCH_ID to the batch_id from the submit response, then poll:
Skip polling with a webhook
Add an optional webhook_url (https) to the request body and Forager POSTs the results there when the batch completes. Put any secret used to authenticate the callback in the URL query string; it is never returned by the poll endpoints or written to logs.
Single lookups
For one person, use Single work email lookup and poll Single work email lookup result. A work email lookup, single or in a batch, costs 5 credits, charged only when an address is found. See API credits and pricing.
See also Errors and rate limits. Last modified on October 28, 2026
