POST
/
search
/
database
/
companies
/
count
Count database companies
curl --request POST \
  --url https://api.generect.com/api/v1/search/database/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
  }
}

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.

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

Response

Matching company count

data
object
meta
object

Operation metadata returned in every data/meta response.