Maiores e mais recentes

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.