ENRICHO_API_KEY to a key from the API keys page and run it. All of them spend credits; start with a small input to see the cost.
A small client
The recipes share this helper. It sends JSON, unwraps the response envelope, waits and retries on429, and raises on every other error without retrying, because a paid request that timed out may already have been charged.
Clean a list before a campaign
Runvalidity and compliance on every address, then split the list into send, hold and remove. A request takes up to 100 checks (addresses × checks), so two checks means 50 addresses per request.
hold collects risky mailboxes (catch-all, shared inboxes), unknown answers and consent_required verdicts for a person to review. Running the script again on the same list is free for the addresses already checked.
Screen developer candidates
Look up to 10 GitHub profiles per request and rank candidates by pull requests merged into other people’s projects, then by stars.Prospect target accounts
Find the companies first, then the decision makers at exactly those companies by passing their domains to people search.Page through a search within a budget
Keep the same filters, follownext_cursor until has_more is false, and stop before you pass a credit budget. Check the balance first so the run doesn’t stop halfway on 402.
limit between pages is fine; changing any filter needs a new search without a cursor. See pagination.
If a paid request fails midway
A timeout or503 on a paid request doesn’t prove nothing was charged. Before retrying, call GET /api/billing/usage or open Usage. Retrying the same request is safe for your balance either way: anything already bought comes back free and is counted in already_purchased.