---
title: "Maiores e mais recentes"
method: GET
path: "/api/v1/brazilian_companies/top"
tags: ["Empresas Brasileiras"]
---

# Maiores e mais recentes

`GET /api/v1/brazilian_companies/top`

## Request

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

Ranking das empresas brasileiras por `cnae_fiscal` e/ou `cod_municipio` (ao menos um dos dois). As três chaves `filter`, `maiores_capital_social` e `abertas_recentes` estão sempre presentes. `filter` ecoa só as chaves enviadas (inclusive `opc_mei` e `limit`, quando enviados). `opc_mei=0` exclui optantes do MEI das duas listas; qualquer outro valor é 400. `limit` define o tamanho das duas listas: padrão 10, teto 12; zero ou valor que não seja inteiro decimal sem sinal volta a 10. Cada lista é hidratada no PostgreSQL na ordem do ClickHouse. Cada item tem `cnpj`, `razao_social`, `nome_fantasia`, `capital_social`, `data_inicio_atividade`, `cnae_fiscal` (subclasse da própria empresa, nulo quando vazia na fonte) e `opc_mei` (booleano).

Autenticação: `Authorization: Bearer <token_digest>` (preferida) ou query `api_token` (legado). Recusas 400/401/403/429/503 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
- `cnae_fiscal` string
- `cod_municipio` string
- `opc_mei` string
- `limit` integer

## Response `200`

sucesso

- object
  - `filter` object, required
    - `cod_municipio` string
    - `cnae_fiscal` string
    - `opc_mei` '0'
    - `limit` integer
  - `maiores_capital_social` object[], required
    - `cnpj` string, required
    - `razao_social` string, nullable, required
    - `nome_fantasia` string, nullable, required
    - `capital_social` number, required
    - `data_inicio_atividade` string, date, nullable, required
    - `cnae_fiscal` string, nullable, required
    - `opc_mei` boolean, required
  - `abertas_recentes` object[], required
    - `cnpj` string, required
    - `razao_social` string, nullable, required
    - `nome_fantasia` string, nullable, required
    - `capital_social` number, required
    - `data_inicio_atividade` string, date, nullable, required
    - `cnae_fiscal` string, nullable, required
    - `opc_mei` boolean, required

## Other responses

- `400`: filtro ausente
- `401`: não autorizado
- `403`: proibido
- `429`: muitas requisições
- `503`: timeout

---

[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)