POST
/
preview
/
leads
/
count
Count preview leads
curl --request POST \
  --url https://api.generect.com/api/v1/preview/leads/count/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_search_criteria": {
    "industries": [
      "Software"
    ],
    "locations": [
      "United States"
    ]
  },
  "lead_search_criteria": {
    "job_titles": [
      "CEO"
    ],
    "locations": [
      "San Francisco, CA"
    ]
  }
}
'
{
  "data": {
    "count": 1240
  },
  "meta": {
    "amount_charged": 0
  }
}

Use Case:

Estimate the number of matching Preview leads before displaying or revealing results.

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 Preview leads).

lead_search_criteria
object

Lead filters (same as Preview leads).

Response

Matching lead count

data
object
meta
object

Operation metadata returned in every data/meta response.