POST
/
search
/
realtime
/
company-leads
Search realtime company leads
curl --request POST \
  --url https://api.generect.com/api/v1/search/realtime/company-leads/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_search_criteria": {
    "industries": [
      "Software"
    ],
    "headcounts": [
      "51-200"
    ],
    "locations": [
      "United States"
    ],
    "limit_by": 50
  },
  "lead_search_criteria": {
    "job_titles": [
      "CEO",
      "Founder"
    ],
    "seniorities": [
      "CXO"
    ],
    "locations": [
      "San Francisco, CA"
    ],
    "company_industries": [
      "Software"
    ],
    "company_headcounts": [
      "51-200"
    ],
    "limit_by": 50
  }
}
'
{
  "data": {
    "leads": [
      {
        "lead_id": "lead_abc123xyz",
        "first_name": "John",
        "last_name": "Doe"
      }
    ],
    "results_count": 320
  },
  "meta": {
    "amount_charged": 12.8
  }
}

Use Case:

Find fresh leads at matching companies.

Pricing

This is a billable endpoint — you are charged for each result returned. If no results are found, the request is free.
Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →

Authorizations

Authorization
string
header
required

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

Body

application/json
company_search_criteria
object
Example:
{
"industries": ["Software"],
"headcounts": ["51-200"],
"locations": ["United States"],
"limit_by": 50
}
lead_search_criteria
object
Example:
{
"job_titles": ["CEO", "Founder"],
"seniorities": ["CXO"],
"locations": ["San Francisco, CA"],
"company_industries": ["Software"],
"company_headcounts": ["51-200"],
"limit_by": 50
}

Response

Full realtime company-lead search results

data
object

Search results. Either leads or companies is populated depending on whether lead_search_criteria was provided.

meta
object

Operation metadata returned in every data/meta response.