---
title: "cnpj.ia.br vs ReceitaWS: qual escolher?"
description: "Fatos e preços públicos de setembro de 2026: dados, contatos, frescor, autenticação, busca, MCP e OpenAPI. Quando usar cada um e como migrar campo a campo."
canonical: "https://cnpj.ia.br/comparar/receitaws"
date_modified: 2026-09-03
source: "cnpj.ia.br"
---

# cnpj.ia.br vs ReceitaWS: qual escolher?

Fatos e preços públicos de setembro de 2026: dados, contatos, frescor, autenticação, busca, MCP e OpenAPI. Quando usar cada um e como migrar campo a campo.

Atualizado em 03/09/2026 Revisar em 01/12/2026

## Resumo em tabela

*Fatos consultados nas datas indicadas por linha; revisão em 01/12/2026.*

| Atributo | cnpj.ia.br | ReceitaWS | 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: `nome`, `fantasia`, `situacao`, `abertura`, `atividade_principal`, `atividades_secundarias`, `natureza_juridica`, `porte`, `capital_social`, endereço, `simples`, `simei`; resposta pública observada para o CNPJ 00.000.000/0001-91. | [fonte](https://receitaws.com.br/v1/cnpj/00000000000191) consultado em 03/09/2026 |
| Contatos (telefone e e-mail) | `telefones`, `email`, `site` e `contatos_extras` no perfil `full`, quando disponíveis. | Campos `telefone` e `email` do cadastro da Receita Federal na resposta pública; sem enriquecimento de contato na oferta observada. | [fonte](https://receitaws.com.br/v1/cnpj/00000000000191) 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` e `qual` de cada sócio na resposta pública. | [fonte](https://receitaws.com.br/v1/cnpj/00000000000191) 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: nenhuma rota testada expõe a lista de campos da resposta ao acesso automatizado. | [fonte](https://receitaws.com.br/api) 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`. | Campo `ultima_atualizacao` por registro na resposta pública. | [fonte](https://receitaws.com.br/v1/cnpj/00000000000191) 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. | Plano gratuito existe e responde do cache público da ReceitaWS, com limite de 3 consultas por minuto; CNPJ fora do cache só nos planos pagos, segundo o texto da própria aplicação. | [fonte](https://receitaws.com.br/api) consultado em 03/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 `v1/cnpj/{cnpj}` respondeu sem chave de API; planos pagos usam chave própria (esquema não legível ao acesso automatizado em 02/09/2026). | [fonte](https://receitaws.com.br/v1/cnpj/00000000000191) 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`. | 3 consultas por minuto no plano gratuito; cada plano pago publica limite por minuto e franquia mensal próprios na página de planos (valores carregados pela aplicação, não pelo HTML servido). | [fonte](https://receitaws.com.br/api) consultado em 03/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: nenhuma rota testada expõe a referência da API ao acesso automatizado. | [fonte](https://receitaws.com.br/api) 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 é `receitas-mcp-server`, publicado por terceiro. | [fonte](https://glama.ai/mcp/servers) 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`. | Não localizado: nenhum arquivo OpenAPI ou Swagger público foi encontrado nas rotas testadas. | [fonte](https://receitaws.com.br/docs) 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. | Não: as rotas testadas devolvem o mesmo shell HTML de 4.372 bytes, sem conteúdo servido pelo servidor. | [fonte](https://receitaws.com.br) 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` responde HTTP 404, então nenhuma diretiva bloqueia rastreador; em compensação `llms.txt`, `llms-full.txt` e `sitemap.xml` também devolvem o shell HTML, e não há gêmea `.md` nem negociação por `Accept: text/markdown`. | [fonte](https://receitaws.com.br/robots.txt) consultado em 02/09/2026 |
| Preço público | R$ 0,0020 por consulta `basic` e R$ 0,0119 pela `full`, no Pro | plano de entrada R$ 149/mês; por consulta não público | [fonte](https://receitaws.com.br/api) consultado em 01/09/2026 |

As duas APIs consultam empresas brasileiras por CNPJ a partir dos dados da Receita Federal. A ReceitaWS oferece o cadastro, com quadro societário, em plano gratuito limitado por minuto e em planos mensais; o cnpj.ia.br acrescenta enriquecimento de contato (site e contatos extras), sinais `has_*`, quadro societário sem CPF, faixa de faturamento derivada do porte, busca por filtros e um servidor MCP oficial, cobrando por crédito. A tabela acima traz os fatos verificados, com fonte e data em cada linha; abaixo, o que pesa em cada escolha e como migrar.

## Cobertura de dados

O cadastro (razão social, situação, endereço, CNAE, natureza jurídica, porte, capital, Simples e MEI) vem nos dois. A diferença está no que vem junto. Telefone e e-mail do cadastro da Receita Federal aparecem nos dois quando constam. No cnpj.ia.br, o perfil `full` acrescenta o site e os contatos extras do enriquecimento da Oportunidados, os sinais `has_phone`, `has_email` e `has_website` já no `basic`, sócios com qualificação e faixa etária (sem CPF), regime tributário, faixa de faturamento derivada do porte e faixa de funcionários. Na ReceitaWS, o quadro societário vem com nome e qualificação de cada sócio já na resposta pública (fonte: resposta pública de `receitaws.com.br/v1/cnpj/{cnpj}`, consultada em 03/09/2026; a mesma leitura alimenta a tabela acima).

Toda resposta de consulta, busca e filtro do cnpj.ia.br diz a data da base em `meta.data_as_of`. A ReceitaWS informa `ultima_atualizacao` por registro.

## Limites e preços

A ReceitaWS tem plano gratuito, limitado a 3 consultas por minuto sobre o cache público, e publica um plano de entrada de R$ 149 por mês; os planos pagos têm limite por minuto e franquia mensal próprios, e não há preço por consulta declarado (fonte: https://receitaws.com.br/api, consultado em 01/09/2026 e em 03/09/2026).

No cnpj.ia.br o preço é por crédito, declarado antes da chamada: a consulta `basic` custa 1 crédito e a `full` 6; no plano Pro isso dá R$ 0,0020 por `basic` e R$ 0,0119 por `full`. Erros custam 0. A franquia tem hard cap: quando acaba, a API para e nada é cobrado sem uma ação sua. O limite de requisições por minuto é por conta e cresce com o plano. Todos os números em [`/precos`](https://cnpj.ia.br/precos) e em [`/pricing.md`](https://cnpj.ia.br/pricing.md).

## MCP e IA

O cnpj.ia.br tem servidor MCP oficial em `mcp.cnpj.ia.br` com quatro ferramentas, contrato OpenAPI baixável, versão em Markdown de toda página e `llms.txt`. Na auditoria de 02/09/2026 a ReceitaWS não tinha servidor MCP oficial (há um wrapper comunitário não oficial), não tinha OpenAPI público localizável, e o HTML bruto das rotas testadas não traz o conteúdo sem JavaScript (fonte: `receitaws.com.br` e rotas `/docs`, `/planos`, `/api`, consultadas em 02/09/2026).

## Quando escolher a ReceitaWS

- A integração já existe, funciona e você só consulta cadastro por CNPJ.
- O volume cabe no plano gratuito ou no de entrada, e o custo por consulta não é uma variável para o seu caso.
- Você não precisa de contato, busca por filtros nem de agentes consultando a base.

## Quando escolher o cnpj.ia.br

- Você precisa do enriquecimento de contato (site, contatos extras, sinais `has_*`), de sócios sem CPF ou de faixa de faturamento para segmentar.
- Você precisa descobrir empresas por CNAE, cidade, porte, situação ou data de abertura, não só consultar CNPJs conhecidos.
- Um agente (Claude, Cursor, OpenAI) vai consultar a base por MCP com a mesma chave.
- Você quer saber o custo antes de chamar e a data da base em cada resposta.

## 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: `receitaws.com.br/v1/cnpj/{cnpj}` e o [contrato OpenAPI](https://cnpj.ia.br/openapi/openapi.json) do cnpj.ia.br). No cnpj.ia.br, os códigos vêm junto da descrição em objetos `{ codigo, descricao }`.

| ReceitaWS | cnpj.ia.br | Observação |
| --- | --- | --- |
| `nome` | `razao_social` |  |
| `fantasia` | `nome_fantasia` | `null` quando não declarado |
| `situacao`, `data_situacao`, `motivo_situacao` | `situacao_cadastral.descricao`, `data_situacao_cadastral`, `motivo_situacao_cadastral.descricao` | código em `.codigo` |
| `abertura` | `data_inicio_atividade` | ISO 8601 (`AAAA-MM-DD`) |
| `tipo` | `matriz_filial.descricao` |  |
| `atividade_principal[].code` / `.text` | `cnae_fiscal.codigo` / `.descricao` | código sem pontuação |
| `atividades_secundarias[]` | `cnaes_secundarios[]` | mesma forma `{ codigo, descricao }` |
| `natureza_juridica` | `natureza_juridica.descricao` | código em `.codigo` |
| `porte` | `porte.descricao` | código em `.codigo` |
| `capital_social` | `capital_social` | número |
| `logradouro`, `numero`, `complemento`, `bairro`, `cep`, `municipio`, `uf` | `endereco.*` | mais `codigo_municipio_ibge` e `codigo_municipio_siafi` |
| `simples.optante`, `simei.optante` | `simples.optante`, `mei.optante` | com `data_opcao` e `data_exclusao` |
| `telefone`, `email` | `telefones[]` (`ddd`, `numero`), `email` | perfil `full`; `site` e `contatos_extras[]` além disso |
| `qsa[].nome`, `qsa[].qual` | `socios[].nome`, `socios[].qualificacao.descricao` | perfil `full`; mais tipo, data de entrada, país, faixa etária; nunca CPF |
| `ultima_atualizacao` | `meta.data_as_of` | data da base mensal, em consulta, busca e filtro |
| `status` | status HTTP + `error.code` | erros custam 0 |

## Quando usar cada um

**ReceitaWS** é a escolha de quem já tem uma integração funcionando com ela, precisa só do cadastro por CNPJ e prefere não mudar de fornecedor: plano gratuito sobre o cache público, plano de entrada mensal público e quadro societário na resposta.

**cnpj.ia.br** é a escolha de quem precisa de enriquecimento de contato (site e contatos extras além do cadastro, com os sinais `has_*` para saber onde vale pedir o `full`), de faixa de faturamento, de busca por filtros, de um servidor MCP oficial para agentes, ou de um contrato legível por máquina: OpenAPI baixável, gêmeas em Markdown e a data da base em toda resposta. Cobra por crédito, com peso declarado antes de chamar.

## Perguntas frequentes

**Posso migrar da ReceitaWS sem reescrever a integração?**

A chamada continua sendo um GET por CNPJ com JSON de resposta, mas os nomes de campo mudam e a autenticação passa a ser por header `Authorization: Bearer`. A tabela de migração desta página mapeia campo a campo, com os nomes lidos nas respostas públicas em setembro de 2026; a maior diferença é que códigos e descrições vêm juntos em objetos.

**A ReceitaWS é mais barata?**

Depende do volume e do que você precisa. A ReceitaWS publica um plano de entrada mensal, e o custo por consulta não é público no site; o cnpj.ia.br publica o peso de cada operação e o preço de cada plano, então dá para calcular o custo antes de contratar. A tabela desta página traz os dois com fonte e data.

**Os dados são os mesmos nos dois?**

O cadastro vem da mesma origem, os dados abertos da Receita Federal, e os dois trazem telefone e e-mail quando constam nele. O cnpj.ia.br acrescenta enriquecimento da Oportunidados (site e contatos extras), os sinais `has_*`, a faixa de faturamento derivada do porte e a data da base em toda resposta de consulta e busca; a ReceitaWS traz o quadro societário com nome e qualificação e `ultima_atualizacao` por registro.

**Quero usar com um agente. Qual escolher?**

O cnpj.ia.br tem servidor MCP oficial com a mesma chave da API, contrato OpenAPI baixável e páginas em Markdown. Na auditoria de setembro de 2026 a ReceitaWS não tinha MCP oficial; existe um wrapper comunitário não oficial.

**Com que frequência esta comparação é revisada?**

A cada trimestre, com a data de revisão visível no topo da página 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.

## Para continuar

- [cnpj.ia.br vs BrasilAPI: qual escolher?](https://cnpj.ia.br/comparar/brasilapi)
- [API de CNPJ para onboarding de PJ](https://cnpj.ia.br/api-cnpj-para-onboarding)
- [Consulta por CNPJ](https://cnpj.ia.br/docs/consulta-cnpj)
- [Preços, créditos e pacotes do cnpj.ia.br](https://cnpj.ia.br/precos)

[Criar chave grátis](https://app.cnpj.ia.br/signup)