POST
/
search
/
realtime
/
companies
/
count
Count realtime companies
curl --request POST \
  --url https://api.generect.com/api/v1/search/realtime/companies/count/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "industries": [
    "Software"
  ],
  "headcounts": [
    "51-200"
  ],
  "locations": [
    "United States"
  ],
  "limit_by": 50
}
'
{
  "data": {
    "results_count": 530
  },
  "meta": {
    "amount_charged": 0.04
  }
}

Use Case:

Count matching realtime companies before running a fresh company 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
industries
string[]

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

exclude_industries
string[]

Industries to exclude.

headcounts
string[]

Company size, as employee-count ranges; a company is included if it falls into at least one. Allowed values: "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+".

locations
string[]

Company headquarters locations — matches across cities, states/regions and countries; a company is included if its HQ matches at least one. Examples: "United States", "San Francisco, California, United States", "Germany".

exclude_locations
string[]

Locations to exclude.

company_types
string[]

Company types: "Public Company", "Privately Held", "Non Profit", "Government Agency", "Educational", etc.

num_of_followers
string[]

Follower count ranges: "1-50", "51-100", "101-1000", "1001-5000", "5001+".

keywords
string[]

Free-text keywords matched across company profiles (name, description, specialties); a company is included if it contains at least one. OR logic, max 10 keywords, up to 40 characters each. Examples: "platform", "marketplace", "developer tools".

technologies
string[]

Technologies used by the company.

company_names
string[]

Search by specific company names.

exclude_ids
string[]

Exclude companies by LinkedIn ID or URN.

exclude_domains
string[]

Exclude companies by domain.

limit_by
integer

Maximum number of companies to return (1-1600).

offset_by
integer

Number of companies to skip (0-1599, for pagination).

strict
string[]

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

revenues_range
object

Revenue filter with min/max (e.g. {"min": 1000000, "max": 50000000}).

department_headcount
object

Filter by department size (e.g. {"name": "engineering", "min": 10, "max": 100}).

headcount_growth
object

Filter by headcount growth percentage (e.g. {"min": 5, "max": 50}).

hiring_on_linkedin
boolean
default:false

Filter for companies actively hiring on LinkedIn.

Filter by specific LinkedIn company URLs.

Response

Matching realtime company count

data
object
meta
object

Operation metadata returned in every data/meta response.