Skip to main content
Each recipe is a complete script. Set 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 on 429, 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

Run validity 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.
Rank on work, never on name, photo or location. Little public activity isn’t evidence of little experience; see use it fairly.

Prospect target accounts

Find the companies first, then the decision makers at exactly those companies by passing their domains to people search.
Never fall back to searching all people when the company list is empty: that buys records outside your target accounts.

Page through a search within a budget

Keep the same filters, follow next_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.
Changing 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 or 503 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.