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
default:100

Maximum number of companies to return, from 1 to 10000. Without it, a search returns 100 rows: results_count is the whole match, and offset_by reaches the rest.

offset_by
integer

Number of companies to skip (0-9999, 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.

include_companies_without_website
boolean
default:false

Also return companies that have a LinkedIn page but no website, such as many hospitals, clinics and local businesses. Off by default: the company search endpoints drop every company without a website, in both database and realtime mode. Such a company has no website and no domain, so there are no corporate emails to find for its people and lead matching by domain does not work for it; an exclude_domains entry cannot remove it (use exclude_ids). Each one is returned and billed as a result like any other, and many of them have few or no leads on LinkedIn. The other quality rules stay: a company with zero employees on LinkedIn is still dropped, and the blocked-domain list still applies to companies that have a website. In database search these companies are counted in results_count; the realtime count comes from LinkedIn and always included them. The company-leads endpoints do not read it.

detail
enum<string>
default:full

Row shape. full (the default) returns full rows, billed per row. thin returns the company's name, industry, size and location at no charge, up to a daily quota per account (currently 2,000 rows per UTC day); a thin row has no domain, website, LinkedIn URL or contacts. A spent quota is refused with 429 until 00:00 UTC, never billed. Accounts on a custom API contract get 400 unless their contract includes thin search. The count endpoints ignore this field: counts are always free.

Available options:
full,
thin
founded_year

Founding year of the company — the "company age" filter. Accepts either an explicit list of years, or a {"min", "max"} range of founding years; both bounds are inclusive and either may be omitted (an omitted max means "up to the current year").

Database mode only. Realtime company search has no founded-year facet upstream, so it rejects this field rather than accepting it and returning a wider result set than you asked for.

Coverage matters here: the founding year is known for roughly 57% of companies, and a company without one never matches. Filtering by company age therefore also drops records that simply lack the data, not only those outside your range.

Example:

Response

Matching company count

data
object
meta
object

Operation metadata returned in every data/meta response.