Skip to main content
POST
Count database companies

Use Case:

Count matching cached companies before running a database company search.

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

Response

Matching company count

data
object
meta
object

Operation metadata returned in every data/meta response.