Contar las empresas que coinciden con su filtro

Envíanos una consulta y te devolveremos el número de empresas que coinciden con ella.

Útil para saber cuántas empresas hay en una industria, país o rango de tamaño específico.

No se cargan créditos para este endpoint.

Regístrate para acceder a todas las características de nuestra API

Obtén tus 500 créditos gratuitos y comienza a enriquecer y buscar empresas.

No se requiere tarjeta de crédito

Parámetros de consulta

querystring (requerido)

Un array de condiciones que las empresas deben cumplir.

Asegúrate de que este parámetro esté convertido a cadena y codificado.

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

El endpoint que define tus criterios de búsqueda.

searchstring (opcional)

Una consulta de búsqueda adicional aplicada al nombre de la empresa o al dominio.

/companies/count?search=amazon

searchFieldsarray (opcional)

Defina los campos para buscar.

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

Valores posibles

about.name

domain.domain

Esquema de respuesta

countnumber

El número de empresas que coinciden con las condiciones.

Ejemplos de código

Selecciona tu lenguaje favorito:

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