Skip to main content
POST
/
api
/
v1
/
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 Development"
    ],
    "headcounts": [
      "51-200"
    ],
    "locations": [
      "United States"
    ]
  },
  "lead_search_criteria": {
    "job_titles": [
      "CEO",
      "Founder"
    ],
    "seniorities": [
      "c_suite"
    ],
    "locations": [
      "United States"
    ],
    "limit_by": 25
  }
}
'
{
  "data": {
    "leads": [
      {
        "id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
        "first_name": "Jordan",
        "last_name": "Ellis",
        "title": "CEO",
        "company_name": "Microsoft",
        "location": "San Francisco, CA",
        "industry": "Software Development",
        "seniority": "CXO",
        "headcount_range": "51-200"
      },
      {
        "id": "ACwAAAFp2r4Bd1eF3gH5iJ7kL9mN0pQ2rS4tU6v",
        "first_name": "Morgan",
        "last_name": "Lee",
        "title": "VP Sales",
        "company_name": "Salesforce",
        "location": "New York, NY",
        "industry": "Software Development",
        "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.