POST
/
preview
/
leads
Preview leads
curl --request POST \
  --url https://api.generect.com/api/v1/preview/leads/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_search_criteria": {
    "industries": [
      "Software"
    ],
    "headcounts": [
      "51-200"
    ],
    "locations": [
      "United States"
    ]
  },
  "lead_search_criteria": {
    "job_titles": [
      "CEO",
      "Founder"
    ],
    "seniorities": [
      "CXO"
    ],
    "locations": [
      "San Francisco, CA"
    ],
    "limit_by": 25
  }
}
'
{
  "data": {
    "leads": [
      {
        "id": "lead_abc123xyz",
        "first_name": "John",
        "last_name": "Doe",
        "title": "CEO",
        "company_name": "Acme Tech",
        "location": "San Francisco, CA",
        "industry": "Software",
        "seniority": "CXO",
        "headcount_range": "51-200"
      },
      {
        "id": "lead_def456xyz",
        "first_name": "Jane",
        "last_name": "Smith",
        "title": "VP Sales",
        "company_name": "Example Corp",
        "location": "New York, NY",
        "industry": "Software",
        "seniority": "VP",
        "headcount_range": "201-500"
      }
    ]
  },
  "meta": {
    "amount_charged": 0
  }
}

Use Case:

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

Pricing

This endpoint is free — it does not incur any charges.

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.