Skip to main content
POST
Count realtime companies

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.

sub_industries
boolean
default:false

Controls how the industries filter maps onto LinkedIn's industry taxonomy. By default (false), a selected industry also matches companies in its sub-industries. Set to true to match only the industries you specify and exclude their sub-industries, for finer sub-category targeting — for example, "Manufacturing" without "Chemicals".

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", "10 000+".

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.

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").

apply_domain_blocklist
boolean
default:true

Apply Generect's blocked-domain list, which removes staffing agencies, directories and similar low-signal records that match broad industry filters. Set to false to receive them. On by default on the company search endpoints, in both database and realtime mode; the company-leads endpoints do not apply it. In database search the exclusion happens before results_count, so the count always matches what the pages can deliver; in realtime the records are dropped after retrieval, so a page may hold fewer companies than results_count implies.

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.

num_of_followers
string[]

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

company_names
string[]

Search by specific company names or domains.

recent_activities
enum<string>[]

Recent company events to filter on.

Available options:
Funding events in past 12 months,
Senior leadership changes in last 3 months
department_headcount_growth
object

Filter by growth of a single department (e.g. {"name": "engineering", "min": 5, "max": 50}).

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.

include_total_count
boolean
default:false

Include results_count — how many companies match the filters in total, beyond the page you asked for — in the response. Without it the response carries only the page itself. The companies counterpart of the lead-search flag of the same name, and likewise an estimate rather than an exact total.

Response

Matching realtime company count

data
object
meta
object

Operation metadata returned in every data/meta response.