cnpj.ia.br vs BrasilAPI: qual escolher?
Fatos de setembro de 2026: BrasilAPI é gratuita e resolve o cadastro puro em volume baixo; o cnpj.ia.br cobra por crédito e traz contato, busca e MCP.
Resumo em tabela
| Atributo | cnpj.ia.br | BrasilAPI | Fonte |
|---|---|---|---|
| Cobertura de dados | Cadastro da Receita Federal (situação, endereço, natureza jurídica, porte, CNAE principal e secundários, Simples e MEI) no perfil basic; contatos, quadro societário, regime tributário, faixa de funcionários e faixa de faturamento no perfil full. | Cadastro da Receita Federal com código e descrição em campos separados (situacao_cadastral/descricao_situacao_cadastral, cnae_fiscal/cnae_fiscal_descricao, codigo_porte/porte), endereço com codigo_municipio e codigo_municipio_ibge, Simples, MEI e regime_tributario; resposta pública observada para o CNPJ 00.000.000/0001-91. | fonte consultado em 03/09/2026 |
| Contatos (telefone e e-mail) | telefones, email, site e contatos_extras no perfil full, quando disponíveis. | Campos ddd_telefone_1, ddd_telefone_2, ddd_fax e email do cadastro da Receita Federal na resposta pública; sem enriquecimento de contato. | fonte consultado em 03/09/2026 |
| Quadro societário | socios no perfil full, com qualificação, data de entrada, país, faixa etária e representante legal; nunca CPF de sócio ou de representante. | qsa[] com nome_socio, qualificacao_socio, data_entrada_sociedade, faixa_etaria, e os campos cnpj_cpf_do_socio e cpf_representante_legal na resposta pública. | fonte consultado em 03/09/2026 |
| Faixa de faturamento | faixa_faturamento, derivada do porte e nada mais (faixa_faturamento.origem é a constante porte), no perfil full. | Não verificado: a referência da API não é servida em HTML e o esquema de resposta não ficou legível ao acesso automatizado. | fonte consultado em 02/09/2026 |
| Frescor declarado por resposta | meta.data_as_of informa a data da base em toda resposta de consulta, busca e filtro; a base é atualizada mensalmente e GET /v1/status devolve a mesma data em data_as_of. | A resposta pública não traz campo de data da base nem de última atualização. | fonte consultado em 03/09/2026 |
| Free tier | Plano Free permanente, com franquia mensal de créditos e limite por minuto próprios; sem busca com filtros. | Gratuita, uso razoável, sem SLA. | fonte consultado em 01/09/2026 |
| Autenticação | Chave da conta em Authorization: Bearer (bearerAuth no OpenAPI), nunca em query string; a mesma chave vale para a API REST e para o servidor MCP. | O endpoint público api/cnpj/v1/{cnpj} respondeu sem chave de API. | fonte consultado em 03/09/2026 |
| Limite de requisições | Limite por minuto por conta, variável por plano, devolvido em X-RateLimit-Limit e X-RateLimit-Remaining; o 429 traz Retry-After. | Não verificado: nenhum número de requisições foi localizado; o registro disponível é qualitativo (uso razoável, sem SLA). | fonte consultado em 01/09/2026 |
| Busca com filtros | GET /v1/cnpjs com filtros por UF, município, CNAE, porte, situação, Simples, MEI, natureza jurídica, capital e data de abertura, com paginação por cursor; disponível nos planos pagos. | Não verificado: a referência da API não é servida em HTML e a lista de operações não ficou legível ao acesso automatizado. | fonte consultado em 02/09/2026 |
| MCP oficial | Servidor MCP oficial da própria API, com as ferramentas consultar_cnpj, buscar_empresas, gerar_filtro e ver_uso declaradas no OpenAPI (x-mcp-tool), autenticadas pela mesma chave. | Nenhum servidor MCP oficial localizado nos registries consultados; o que aparece é cnpj-br, publicado por terceiro sobre a API. | fonte consultado em 02/09/2026 |
| OpenAPI público baixável | OpenAPI 3.1 publicado como arquivo em /openapi/openapi.json, linkado no site e no llms.txt. | A especificação existe, embutida no JSON __NEXT_DATA__ da página; nenhum arquivo OpenAPI público baixável foi localizado. | fonte consultado em 02/09/2026 |
| Renderiza sem JavaScript | Site estático: conteúdo, tabelas e exemplos vêm no HTML; o JavaScript só acrescenta abas, cópia e tema. | A home vem no HTML; /docs devolve literalmente “Loading …” e monta a referência por JavaScript no navegador. | fonte consultado em 02/09/2026 |
| Acessível a bots de IA | robots.txt aberto, com Allow: / explícito para GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, Claude-User, PerplexityBot e outros, e Content-Signal: ai-train=yes, search=yes, ai-input=yes; llms.txt publicado e uma gêmea .md por página. | Rotas /robots.txt, /llms.txt, /llms-full.txt e /sitemap.xml do host testadas: robots.txt traz Allow: /* genérico, sem regra por bot de IA; llms.txt e llms-full.txt respondem 404 e não há gêmea .md. O sitemap lista 19 URLs, todas com lastmod igual à data da coleta. | fonte consultado em 02/09/2026 |
| Preço público | R$ 0,0020 por consulta basic e R$ 0,0119 pela full, no Pro | gratuito | fonte consultado em 01/09/2026 |
Se você só precisa do cadastro puro e o volume é baixo, BrasilAPI e Minha Receita são gratuitas e resolvem. O cnpj.ia.br custa R$ 0,0020 por consulta basic no plano Pro e traz, no full, contato, sócios sem CPF e faixa de faturamento derivada do porte, além de busca por filtros e servidor MCP oficial. A tabela acima traz os fatos verificados com fonte e data; abaixo, o que pesa em cada escolha e como migrar.
Cobertura de dados
O cadastro da Receita Federal vem nos dois, com CNAE, natureza jurídica, porte, capital, endereço, Simples e MEI. A BrasilAPI devolve também o quadro societário e os campos de telefone e e-mail do cadastro público, e inclui na resposta os campos cnpj_cpf_do_socio e cpf_representante_legal (fonte: resposta pública de brasilapi.com.br/api/cnpj/v1/{cnpj}, consultada em 03/09/2026; a mesma leitura alimenta a tabela acima). O cnpj.ia.br nunca retorna CPF, em nenhum perfil, e acrescenta no full o site e os contatos extras do enriquecimento da Oportunidados, a faixa de faturamento derivada do porte, a faixa de funcionários e o regime tributário. Toda resposta traz meta.data_as_of com a data da base.
Limites e preços
A BrasilAPI é gratuita, de uso razoável e sem SLA; o endpoint público respondeu sem chave de API em 03/09/2026 (fonte de preço e política: https://brasilapi.com.br/docs, consultado em 01/09/2026); o site não publica um limite numérico de requisições, e esta página não inventa um.
O cnpj.ia.br cobra por crédito com peso declarado: basic 1, full 6, busca 1 por empresa retornada, erros 0. O plano Free dá 60 créditos por mês; a busca entra nos planos pagos. O limite de requisições por minuto é por conta, publicado por plano, e a franquia tem hard cap. Números em /precos e /pricing.md.
MCP e IA
O cnpj.ia.br tem servidor MCP oficial, OpenAPI baixável em /openapi/openapi.json, versão em Markdown de toda página e llms.txt. Na auditoria de 02/09/2026 a BrasilAPI não tinha servidor MCP oficial (há um wrapper comunitário de terceiro), a especificação OpenAPI estava embutida nos dados da página em vez de um arquivo público, e a documentação em /docs exigia JavaScript para renderizar (fonte: brasilapi.com.br e /docs, consultadas em 02/09/2026). O robots.txt da BrasilAPI permite tudo, sem regra por bot de IA.
Quando escolher a BrasilAPI
- Cadastro puro, volume baixo, sem contrato: um formulário que valida CNPJ de vez em quando, um script pessoal, um protótipo.
- Você aceita uso razoável sem limite declarado e sem SLA, e não depende de saber a data da base.
- Projeto de código aberto que prefere uma API pública e gratuita.
Quando escolher o cnpj.ia.br
- Você precisa de site, contatos extras, sinais
has_*ou faixa de faturamento, ou de sócios sem CPF na resposta. - Você precisa descobrir empresas por filtro, não só consultar CNPJs conhecidos.
- Um agente vai consultar a base por MCP com a mesma chave da API.
- A integração é de produção e precisa de limite declarado, custo conhecido e a data da base em cada resposta de consulta ou busca.
Migração campo a campo
Nomes lidos das respostas públicas dos dois serviços para o CNPJ 00.000.000/0001-91 em 03/09/2026 (fontes: brasilapi.com.br/api/cnpj/v1/{cnpj} e o contrato OpenAPI do cnpj.ia.br). Os nomes são parecidos; a diferença é que o cnpj.ia.br agrupa código e descrição em objetos e separa o envelope meta.
| BrasilAPI | cnpj.ia.br | Observação |
|---|---|---|
razao_social, nome_fantasia | razao_social, nome_fantasia | iguais |
situacao_cadastral, descricao_situacao_cadastral, data_situacao_cadastral | situacao_cadastral.codigo, situacao_cadastral.descricao, data_situacao_cadastral | código como texto de dois dígitos |
motivo_situacao_cadastral, descricao_motivo_situacao_cadastral | motivo_situacao_cadastral.codigo, .descricao | |
identificador_matriz_filial, descricao_identificador_matriz_filial | matriz_filial.codigo, .descricao | |
cnae_fiscal, cnae_fiscal_descricao, cnaes_secundarios[] | cnae_fiscal.codigo, .descricao, cnaes_secundarios[] | |
codigo_natureza_juridica, natureza_juridica | natureza_juridica.codigo, .descricao | |
codigo_porte, porte | porte.codigo, .descricao | |
logradouro, numero, complemento, bairro, cep, municipio, uf, codigo_municipio, codigo_municipio_ibge | endereco.* | codigo_municipio (SIAFI) vira endereco.codigo_municipio_siafi |
opcao_pelo_simples, data_opcao_pelo_simples, data_exclusao_do_simples | simples.optante, simples.data_opcao, simples.data_exclusao | idem para mei.* |
ddd_telefone_1, ddd_telefone_2, email | telefones[] (ddd, numero), email | perfil full; mais site e contatos_extras[] |
qsa[].nome_socio, qsa[].qualificacao_socio, qsa[].data_entrada_sociedade, qsa[].faixa_etaria | socios[].nome, .qualificacao.descricao, .data_entrada, .faixa_etaria.descricao | perfil full |
qsa[].cnpj_cpf_do_socio, qsa[].cpf_representante_legal | sem equivalente | o cnpj.ia.br não retorna CPF |
regime_tributario | regime_tributario.regime, .ano | |
| sem equivalente | faixa_faturamento, faixa_funcionarios, has_phone, has_email, has_website, meta.data_as_of | derivados e envelope |
Quando usar cada um
BrasilAPI é a escolha para cadastro puro em volume baixo: gratuita, de uso razoável e sem SLA. Se é só isso que você precisa, ela e a Minha Receita resolvem.
cnpj.ia.br é a escolha quando entra enriquecimento de contato (site, contatos extras e os sinais has_*), busca por filtros, agentes por MCP, ou quando a integração precisa de limite declarado, custo conhecido antes de chamar e a data da base em cada resposta de consulta ou busca.
Perguntas frequentes
A BrasilAPI resolve o meu caso de graça?
Se você só precisa do cadastro puro por CNPJ, em volume baixo e sem contrato, sim: ela e a Minha Receita são gratuitas e resolvem. O cnpj.ia.br faz sentido quando entra contato, busca por filtros, agentes por MCP ou uma integração de produção com limite declarado.
O cnpj.ia.br tem plano gratuito?
Sim. O plano Free tem uma franquia mensal de créditos e inclui consulta e MCP; a busca por filtros está nos planos pagos. Os números estão em /precos.
Os nomes de campo são iguais?
Parecidos: os dois seguem o vocabulário dos dados abertos da Receita Federal. O cnpj.ia.br agrupa código e descrição em objetos (porte.codigo, porte.descricao), separa o envelope meta e nunca retorna CPF. A tabela de migração desta página mapeia cada campo, com os nomes lidos nas respostas públicas em setembro de 2026.
A BrasilAPI tem servidor MCP?
Na auditoria de setembro de 2026, não havia servidor MCP oficial; existe um wrapper comunitário de terceiro. O cnpj.ia.br tem MCP oficial com a mesma chave da API e as mesmas quatro operações.
Com que frequência esta comparação é revisada?
A cada trimestre, com a data de revisão visível no topo e a data de consulta em cada linha da tabela. Se um fato mudou antes disso, escreva para o contato do rodapé e corrigimos com a fonte.