---
title: "Contar empresas"
method: GET
path: "/api/v1/brazilian_companies/count"
tags: ["Empresas Brasileiras"]
---

# Contar empresas

`GET /api/v1/brazilian_companies/count`

## Request

- Base URL: `https://app.oportunidados.com.br`
- URL: `https://app.oportunidados.com.br/api/v1/brazilian_companies/count`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_token`

Contagem de empresas brasileiras pelos filtros do `permit`. Sem `group_by`, `data` é inteiro; com `group_by` da whitelist, `data` é o objeto valor→contagem (contagens inteiras). As três chaves `filter`, `group_by` e `data` estão sempre presentes. `group_by` é null quando o cliente não envia o parâmetro. `filter` ecoa `filter_attributes` (chaves vazias omitidas).

Autenticação: `Authorization: Bearer <token_digest>` (preferida) ou query `api_token` (legado). Recusas 400/401/403/429 usam o JSON literal do controller e dos concerns.

Disponível conforme o plano (`api_search_enabled`). Cada chamada conta 1 na quota mensal. Limite de 30 chamadas por minuto por conta neste grupo de endpoints; `eligible` devolve até 1.000 CNPJs por página.

## Query parameters

- `api_token` string
- `name` string
- `nome` string
- `razao` string
- `cnpj` string
- `include_cnae_secundario` string
- `cnae_fiscal` string[]
- `mun` string[]
- `natureza_juridica` string[]
- `opcao_mei` string[]
- `opcao_simples` string[]
- `porte` string[]
- `situacao_cadastral` string[]
- `situacao_especial` string[]
- `uf` string[]
- `categoria_natureza_juridica` string[]
- `contact_fields` string[]
- `matriz_filial` string[]
- `motivo_situacao` string[]
- `mun_exclude` string[]
- `numero_filiais_range` string[]
- `regime_tributario` string[]
- `data_inicio_interval[]` string[]
- `data_situacao_interval[]` string[]
- `bairro[]` string[]
- `cep[]` string[]
- `capital_social_range[]` string[]
- `group_by` 'uf' | 'cod_municipio' | 'cnae_fiscal' | 'cnae_divisao' | 'cnae_grupo' | 'cnae_classe' | 'porte' | 'situacao_cadastral' | 'opc_simples' | 'opc_mei' | 'cod_nat_juridica' | 'data_inicio_atividade' | 'matriz_filial' | 'bairro'
- `group_by[]` string[]

## Response `200`

sucesso

- object
  - `filter` object, required
    - `nome` string
    - `razao` string
    - `cnpj` string[]
    - `cnae_fiscal` string[]
    - `include_cnae_secundario` boolean
    - `mun` string[]
    - `mun_exclude` string[]
    - `cep` string[]
    - `natureza_juridica` string[]
    - `opcao_mei` string[]
    - `opcao_simples` string[]
    - `porte` string[]
    - `situacao_cadastral` string[]
    - `situacao_especial` string[]
    - `matriz_filial` string[]
    - `motivo_situacao` string[]
    - `uf` string[]
    - `data_inicio_interval` string[]
    - `data_situacao_interval` string[]
    - `contact_fields` string[]
    - `capital_social_range` string[]
    - `bairro` string[]
    - `regime_tributario` string[]
    - `categoria_natureza_juridica` string[]
    - `numero_filiais_range` string[]
  - `group_by` union, required
    - string, nullable
    - string[]
  - `data` union, required
    - integer
    - object

## Other responses

- `400`: group_by inválido
- `401`: não autorizado
- `403`: proibido
- `429`: muitas requisições

---

[API](https://skmtc.dev/oportunidados/apis/api-de-dados-oportunidados-v1.md) · [All operations](https://skmtc.dev/oportunidados/apis/api-de-dados-oportunidados-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/oportunidados/apis/api-de-dados-oportunidados-v1/revisions/0af33d72cdb4?raw)