Count realtime leads

curl --request POST \
  --url https://api.generect.com/api/v1/search/realtime/leads/count/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_titles": [
    "CEO",
    "Founder"
  ],
  "seniorities": [
    "c_suite"
  ],
  "locations": [
    "United States"
  ],
  "company_industries": [
    "Software Development"
  ],
  "company_headcounts": [
    "51-200"
  ],
  "limit_by": 50
}
'

import requests

url = "https://api.generect.com/api/v1/search/realtime/leads/count/"

payload = {
    "job_titles": ["CEO", "Founder"],
    "seniorities": ["c_suite"],
    "locations": ["United States"],
    "company_industries": ["Software Development"],
    "company_headcounts": ["51-200"],
    "limit_by": 50
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_titles: ['CEO', 'Founder'],
    seniorities: ['c_suite'],
    locations: ['United States'],
    company_industries: ['Software Development'],
    company_headcounts: ['51-200'],
    limit_by: 50
  })
};

fetch('https://api.generect.com/api/v1/search/realtime/leads/count/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.generect.com/api/v1/search/realtime/leads/count/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'job_titles' => [
        'CEO',
        'Founder'
    ],
    'seniorities' => [
        'c_suite'
    ],
    'locations' => [
        'United States'
    ],
    'company_industries' => [
        'Software Development'
    ],
    'company_headcounts' => [
        '51-200'
    ],
    'limit_by' => 50
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.generect.com/api/v1/search/realtime/leads/count/"

	payload := strings.NewReader("{\n  \"job_titles\": [\n    \"CEO\",\n    \"Founder\"\n  ],\n  \"seniorities\": [\n    \"c_suite\"\n  ],\n  \"locations\": [\n    \"United States\"\n  ],\n  \"company_industries\": [\n    \"Software Development\"\n  ],\n  \"company_headcounts\": [\n    \"51-200\"\n  ],\n  \"limit_by\": 50\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.generect.com/api/v1/search/realtime/leads/count/")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_titles\": [\n    \"CEO\",\n    \"Founder\"\n  ],\n  \"seniorities\": [\n    \"c_suite\"\n  ],\n  \"locations\": [\n    \"United States\"\n  ],\n  \"company_industries\": [\n    \"Software Development\"\n  ],\n  \"company_headcounts\": [\n    \"51-200\"\n  ],\n  \"limit_by\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.generect.com/api/v1/search/realtime/leads/count/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_titles\": [\n    \"CEO\",\n    \"Founder\"\n  ],\n  \"seniorities\": [\n    \"c_suite\"\n  ],\n  \"locations\": [\n    \"United States\"\n  ],\n  \"company_industries\": [\n    \"Software Development\"\n  ],\n  \"company_headcounts\": [\n    \"51-200\"\n  ],\n  \"limit_by\": 50\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "results_count": 1240
  },
  "meta": {
    "amount_charged": 0.04
  }
}

POST

api

realtime

leads

count

Count realtime leads

curl --request POST \
  --url https://api.generect.com/api/v1/search/realtime/leads/count/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_titles": [
    "CEO",
    "Founder"
  ],
  "seniorities": [
    "c_suite"
  ],
  "locations": [
    "United States"
  ],
  "company_industries": [
    "Software Development"
  ],
  "company_headcounts": [
    "51-200"
  ],
  "limit_by": 50
}
'

import requests

url = "https://api.generect.com/api/v1/search/realtime/leads/count/"

payload = {
    "job_titles": ["CEO", "Founder"],
    "seniorities": ["c_suite"],
    "locations": ["United States"],
    "company_industries": ["Software Development"],
    "company_headcounts": ["51-200"],
    "limit_by": 50
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_titles: ['CEO', 'Founder'],
    seniorities: ['c_suite'],
    locations: ['United States'],
    company_industries: ['Software Development'],
    company_headcounts: ['51-200'],
    limit_by: 50
  })
};

fetch('https://api.generect.com/api/v1/search/realtime/leads/count/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.generect.com/api/v1/search/realtime/leads/count/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'job_titles' => [
        'CEO',
        'Founder'
    ],
    'seniorities' => [
        'c_suite'
    ],
    'locations' => [
        'United States'
    ],
    'company_industries' => [
        'Software Development'
    ],
    'company_headcounts' => [
        '51-200'
    ],
    'limit_by' => 50
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.generect.com/api/v1/search/realtime/leads/count/"

	payload := strings.NewReader("{\n  \"job_titles\": [\n    \"CEO\",\n    \"Founder\"\n  ],\n  \"seniorities\": [\n    \"c_suite\"\n  ],\n  \"locations\": [\n    \"United States\"\n  ],\n  \"company_industries\": [\n    \"Software Development\"\n  ],\n  \"company_headcounts\": [\n    \"51-200\"\n  ],\n  \"limit_by\": 50\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.generect.com/api/v1/search/realtime/leads/count/")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_titles\": [\n    \"CEO\",\n    \"Founder\"\n  ],\n  \"seniorities\": [\n    \"c_suite\"\n  ],\n  \"locations\": [\n    \"United States\"\n  ],\n  \"company_industries\": [\n    \"Software Development\"\n  ],\n  \"company_headcounts\": [\n    \"51-200\"\n  ],\n  \"limit_by\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.generect.com/api/v1/search/realtime/leads/count/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_titles\": [\n    \"CEO\",\n    \"Founder\"\n  ],\n  \"seniorities\": [\n    \"c_suite\"\n  ],\n  \"locations\": [\n    \"United States\"\n  ],\n  \"company_industries\": [\n    \"Software Development\"\n  ],\n  \"company_headcounts\": [\n    \"51-200\"\n  ],\n  \"limit_by\": 50\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "results_count": 1240
  },
  "meta": {
    "amount_charged": 0.04
  }
}

Use Case:

Count matching realtime leads before running a fresh lead search.

Pricing

This is a billable endpoint — you are charged per count request.

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

job_titles

string[]

Job titles held by the people you want to find. A lead only needs to match one of the titles you provide — adding more expands your search. Results may also include similar titles (e.g. "marketing manager" can return "content marketing manager"). Combine with seniorities to target both function and level. Examples: "sales development representative", "marketing manager", "software engineer".

seniorities

string[]

Job seniority levels at the lead's current employer (current position only, not previous roles). A lead needs to match at least one; adding more values expands your search. Allowed values: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. Combine with job_titles to narrow targeting.

locations

string[]

Geographic locations where leads currently live — matches across cities, states/regions and countries. A lead needs to match at least one. To filter by the employer's HQ location, use company_locations. Examples: "San Francisco, California, United States", "Germany", "London".

exclude_locations

string[]

Locations to exclude from results.

company_locations

string[]

Headquarters location of the lead's current employer; a lead is included if their company's HQ matches at least one. Filters by where the company is based — distinct from locations, which is where the lead personally lives.

exclude_company_locations

string[]

Company locations to exclude.

company_industries

string[]

Industries of the lead's current employer; a lead is included if their company matches at least one. Values follow LinkedIn's industry taxonomy. Examples: "Software Development", "Financial Services", "Information Technology".

exclude_company_industries

string[]

Company industries to exclude.

company_headcounts

string[]

Size of the lead's current employer, as employee-count ranges; a lead is included if their company falls into at least one. Allowed values: "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10 000+".

exclude_company_headcounts

string[]

Company size ranges to exclude.

company_types

string[]

Company types: "Public Company", "Privately Held", "Non Profit", "Government Agency", "Educational", "Self Employed", "Partnership", "Self Owned".

company_name

string

Target company name (mutually exclusive with company_link and company_id).

company_link

string

LinkedIn company URL (mutually exclusive with company_name and company_id).

company_id

integer

LinkedIn company numeric ID (mutually exclusive with company_name and company_link).

exclude_names

string[]

Skip leads by full name.

exclude_ids

string[]

Skip leads by Sales Navigator ID.

filter_empty_vars

string[]

Skip leads where these fields are empty. Options: job_started_on, profile_photo, started_at_position, company_website.

limit_by

integer

Maximum number of leads to return. For filter-only searches (no company_id/company_link/company_name) the maximum is 2400.

offset_by

integer

Number of leads to skip (for pagination). For filter-only searches the maximum is 2399.

strict

string[]

Fields to apply strict matching on (e.g. "company_locations").

skip_truncated_names

boolean

default:false

Drop leads whose first or last name is a single character or empty. LinkedIn abbreviates surnames for members who restrict their profile, so these rows carry a name that cannot be personalised. Applies to both database and realtime search.

personas

array[]

List of persona tuples. Each persona: [name, functions, seniorities, prohibits, priority?].

first_name

string[]

Exact first names to match; a lead is included if their first name matches at least one.

last_name

string[]

Exact last names to match; a lead is included if their last name matches at least one.

lead_industries

string[]

Industries of the lead themselves (their own profile industry), as opposed to company_industries, which filters by the employer's industry.

exclude_lead_industries

string[]

Lead industries to exclude.

past_job_titles

string[]

Titles the lead held in a previous role; a lead is included if their history matches at least one.

exclude_functions

string[]

Job functions to exclude — same value set as functions.

past_company_ids

string[]

LinkedIn company IDs the lead previously worked at; ID-based counterpart of past_company_names.

exclude_past_company_ids

string[]

Skip leads who previously worked at these LinkedIn company IDs.

exclude_current_company_ids

string[]

Skip leads currently working at these LinkedIn company IDs.

groups_keywords

string[]

Resolve LinkedIn groups by name instead of by numeric ID — each keyword is matched against group names and the matches are added to groups.

years_of_experience

integer[]

Total years of work experience: 1 = under 1y, 2 = 1-2y, 3 = 3-5y, 4 = 6-10y, 5 = 10y+.

num_of_connections

object

Connection-count range applied to the lead's profile. Leads outside the range are dropped from the results.

Show child attributes

Example:

{ "min": 500 }

mentioned_in_news

boolean

default:false

Filter for leads recently mentioned in the news.

keywords

string[]

Free-text keywords searched across lead profiles (headline, current job description, skills, summary); a lead is included if their profile contains at least one. Realtime mode only — database mode does not support free-text search. Examples: "machine learning", "growth marketing", "kubernetes".

functions

string[]

Job functions — categorize roles by business area, independent of seniority or title; a lead is included if their function matches at least one. Common values: Sales, Marketing, Engineering, Operations, Finance, HR, Product, Customer Success, Legal, Data. Combine with seniorities for function-by-seniority targeting.

past_company_names

string[]

Filter by companies where the lead previously worked; a lead is included if their work history contains at least one. Useful for alumni outreach (e.g. ex-Google engineers) or targeting people who left a competitor. Examples: "Google", "Meta", "Stripe".

schools

integer[]

School IDs to filter by.

groups

integer[]

LinkedIn group IDs to filter by.

years_in_position

integer[]

Time in current position: 1 = under 1y, 2 = 1-2y, 3 = 3-5y, 4 = 6-10y, 5 = 10y+.

years_in_company

integer[]

Time at current company: 1 = under 1y, 2 = 1-2y, 3 = 3-5y, 4 = 6-10y, 5 = 10y+.

changed_jobs

boolean

default:false

Filter for leads who recently changed jobs.

posted_on_linkedin

boolean

default:false

Filter for leads who recently posted on LinkedIn.

linkedin_filter_link

string

Pre-built LinkedIn or Sales Navigator search URL to extract filters from.

include_full_profile

boolean

default:false

Return the complete lead profile instead of the standard field set — roughly thirty extra fields, including skills, industry and social links. Priced as one lead enrichment per returned lead, charged on top of the search itself, so a request that returns N leads is billed twice: once for the search and once for the profiles. Each returned lead carries is_full_data so you can confirm what you received.

find_by_emails

string<email>[]

Find the people behind these known addresses, up to 500 per request. Every address must share one domain: that domain is used as the company anchor, so the request resolves to leads at that company and cannot be combined with an unanchored search. Realtime only.

include_total_count

boolean

default:false

Include results_count in the response; without it the response carries only the page itself. The figure is an estimate, not an exact total. For a search anchored to one company it may come back as the string "within limit" rather than a number, meaning the whole match set fits inside the page you asked for — handle both types. A filter-only search reports results_count anyway, without this flag.

max_profiles_scanned

integer

Hard ceiling on how many profiles the search opens while assembling results. Bounds the time and cost of a broad query; a limit_by above this value is lowered to it. Unset means no ceiling.

Response

Matching realtime lead count

data

object

Show child attributes

API Reference

Auth

Enrich

Search

Contacts

Account

Webhooks

Count realtime leads

Use Case:

Pricing

Authorizations

Body

Response

​Use Case:

​Pricing

Authorizations

Body

Response

Use Case:

Pricing