Prices and balance
Prices are set per account and per kind of result, so they are not listed here. Read your balance and your own prices fromGET /balance:
- Available credits: what your account has left. It is capped by the API key owner’s own credit limit, if their workspace sets one.
- Reserved credits: credits currently held by running requests and jobs. Available credits do not subtract them. Reserved credits cover the whole account while available credits can be capped by your own limit, so available minus reserved is an estimate of what you can spend right now.
- Prices: one price each for email, phone and LinkedIn enrichment, lookalike companies, company followers, maps discovery, and maps owner email and phone.
Free and paid operations
Monthly free allowance
Search, count and lookalike preview are free up to a monthly allowance, counted per account across all of its API keys and reset at the start of each calendar month (UTC). Each search page counts as one search request, including pages fetched with a cursor. Requests that fail, including rate-limited ones, do not count. Past the allowance, each successful call costs credits. If your balance does not cover it, the call fails with402 insufficient_credits, and while credit spending is paused it fails with 403 account_frozen. GET /balance does not report how much of the allowance is left.
Reservations
Operations that can spend a lot at once reserve credits before they start and settle when they finish:- The request reserves what it is expected to cost. If your available credits, minus what is already reserved, do not cover it, the request fails with
402 insufficient_creditsand nothing starts. - The operation runs.
- You are charged for what it actually returned, and the rest of the reservation is released.
The maps owner reservation is not an upper bound. Owners already found recently for the same places in your account, by this search or an earlier one, are reused and hold nothing, but their missing email or phone is still looked up and charged at the same prices, so a job can consume more than it reserved.
