Skip to main content
Paid Leadsforge API operations consume credits from your account balance, the same balance you use in the Leadsforge app. Enrichment and the other paid operations charge for results, not for attempts: a lookup that finds nothing costs nothing. Search, count and lookalike preview are the exception: past their monthly free allowance, each successful call costs credits, whatever it returns.

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 from GET /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 with 402 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:
  1. 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_credits and nothing starts.
  2. The operation runs.
  3. 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.

Values your account already obtained

When your account obtained an email, phone number or LinkedIn URL for a person in the last 30 days, through the API or the app, enrichment returns it again for free and does not reserve credits for it. An older value is looked up again and charged if it is found. Getting such a value again does not extend the 30 days.