Count companies matching your query

Send us a query and we'll return the number of companies that match it.

Useful to know how many companies are in a specific industry, country, or size range.

No credits are charged for this endpoint.

Signup to access all our API features

Get your 500 free credits and start enriching and searching companies.

No credit card required

Query parameters

querystring (required)

An array of conditions the companies must match.

Make sure this parameter is stringified and encoded.

GET

https://api.thecompaniesapi.com/v2/companies/count?query=%5B%7B%22attribute%22%3A%22about.industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%2C%22internet%22%2C%22services%22%5D%7D%2C%7B%22attribute%22%3A%22locations.headquarters.country.code%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22us%22%2C%22fr%22%2C%22gb%22%5D%7D%5D&token=XXXXXX

The endpoint that defines your search criteria.

searchstring (optional)

An additional search query applied to the company name or domain.

/companies/count?search=amazon

searchFieldsarray (optional)

Define the fields to search.

/companies/count?searchFields[]=domain&searchFields[]=name

Possible values

about.name

domain.domain

Response schema

countnumber

The number of companies matching the conditions.

Code examples

Select your favorite language:

Java

JavaScript

SDK

PHP

Python

Ruby

Rust

import createClient from '@thecompaniesapi/sdk'

const tca = createClient({ apiToken: 'YOUR_API_TOKEN' })

const response = await tca.countCompanies({
  query: [
    {
      attribute: 'about.industries',
      operator: 'or',
      sign: 'equals',
      values: ['computer-software']
    }
  ]
})

const count = response.data // Number of companies that match the query