Skip to main content
POST
Preview leads

Use Case:

Show masked lead results in SaaS products without exposing paid data such as email, phone, LinkedIn URL, or company domain.

Pricing

$0.002 per returned result — one charge per masked row this endpoint returns, and a search that matches nothing costs $0. Preview is never discounted by volume: the price is the same on every Spend & Save tier.
Free above $2,000 a month. Once your account’s total spend within the current calendar month reaches $2,000, this endpoint costs nothing for the rest of that month. The counter covers every charge on the account, not only Preview, and it restarts on the 1st (UTC) — requests are billable again from then. The preview_tier flag on GET /accounts/me/ tells you which side of the threshold you are on.
Always free, whatever your spend: POST /preview/leads/count/, and Preview inside the Generect web app — $0.002 is the API price.

Authorizations

Authorization
string
header
required

Use the required Token prefix. Example: Authorization: Token xxxxxxxxx

Body

application/json
company_search_criteria
object

Company filters (same as /search/database/companies/).

lead_search_criteria
object

Lead filters (same as /search/database/leads/).

Response

Masked lead preview results

data
object
meta
object

Operation metadata returned in every data/meta response.