# Autenticação Source: https://docs.cnpj-api.com/pt/autenticacao Como autenticar suas requisições na API # Autenticação Todas as requisições à API requerem um token de autenticação. Oferecemos tokens gratuitos e pagos. ## Tokens gratuitos Tokens gratuitos estão disponíveis para todos os usuários com limite de **5 consultas por minuto** e acesso a todos os endpoints. Para necessidades maiores, tokens pagos oferecem limites superiores e suporte dedicado. Veja [Limites de Uso](/pt/limites-de-uso) para mais detalhes. ## Criando uma conta Veja a página [Criar Conta](/pt/criar-conta) para instruções de como obter seu token. ## Métodos de autenticação ### Via parâmetro na URL (recomendado) A forma preferida de autenticação é enviar o token como parâmetro `token` na URL: ```bash cURL theme={null} curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN" ``` ```javascript JavaScript theme={null} const response = await fetch( 'https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN' ); const data = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://api.cnpj-api.com/v1/cnpj/12345678000195', params={'token': 'SEU_TOKEN'} ) data = response.json() ``` ### Via header HTTP **Alternativamente**, envie o token no header `Authorization`: ```bash cURL theme={null} curl -H "Authorization: Bearer SEU_TOKEN" \ "https://api.cnpj-api.com/v1/cnpj/12345678000195" ``` ```javascript JavaScript theme={null} const response = await fetch( 'https://api.cnpj-api.com/v1/cnpj/12345678000195', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ); const data = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://api.cnpj-api.com/v1/cnpj/12345678000195', headers={'Authorization': 'Bearer SEU_TOKEN'} ) data = response.json() ``` ## Respostas de erro | Código | Descrição | | ------ | ------------------------------ | | `401` | Token inválido ou ausente | | `429` | Limite de requisições excedido | Ao receber `429`, aguarde 1 minuto antes de tentar novamente. Tokens pagos possuem limites superiores. # Criar Conta Source: https://docs.cnpj-api.com/pt/criar-conta Como criar uma conta e obter seu token de autenticação # Criar Conta ## 1. Cadastre-se Acesse [cnpj-api.com/sign-up](https://cnpj-api.com/sign-up) e crie sua conta utilizando uma das opções: * **Google** — clique no botão Google para entrar com sua conta Google * **Email** — insira seu email e receba um link de acesso (magic link) Página de cadastro Se optar pelo email, verifique sua caixa de entrada (e spam) e clique no link recebido para completar o cadastro. ## 2. Crie um token de API Após o login, você será redirecionado para a página [Minha Conta](https://cnpj-api.com/my-account). Para criar seu token: 1. Clique em **Criar novo token** 2. Escolha um nome para identificar o token (ex: `meu-app-producao`) 3. Clique em **Criar** O token é exibido **apenas uma vez**. Copie e guarde em local seguro antes de fechar a página. ## 3. Use o token Adicione o token às suas requisições via parâmetro na URL ou header HTTP: ```bash theme={null} curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN" ``` Veja [Autenticação](/pt/autenticacao) para todos os métodos disponíveis. ## Gerenciando tokens Página Minha Conta com gerenciamento de tokens Na página [Minha Conta](https://cnpj-api.com/my-account) você pode: * **Criar** novos tokens * **Rotacionar** um token ativo (gera um novo, mantendo o antigo até ser revogado) * **Revogar** um token para desativá-lo imediatamente ## Próximos passos * [Início Rápido](/pt/inicio-rapido) — faça sua primeira consulta * [Limites de Uso](/pt/limites-de-uso) — entenda os planos e limites * [Uso e Limites](/pt/endpoint-uso-e-limites) — consulte seu plano e limites via API # Consulta em Lote Source: https://docs.cnpj-api.com/pt/endpoint-bulk-cnpj POST /v1/bulk-cnpj Consulta de dados cadastrais de ate 20 CNPJs em uma unica requisicao Lista de CNPJs sem pontuacao (14 digitos cada). Maximo de 20 CNPJs por requisicao. Token de autenticacao. Forma preferida de autenticacao. ## Requisitos * **Plano Pro**: Este endpoint esta disponivel apenas para usuarios do plano Pro. * **Limite**: Maximo de 20 CNPJs por requisicao. * Cada chamada consome 1 credito do limite de requisicoes, independente da quantidade de CNPJs. ## Fontes de dados * [Receita Federal](https://solucoes.receita.fazenda.gov.br/Servicos/cnpjreva/cnpjreva_solicitacao.asp) * [Simples Nacional](https://www8.receita.fazenda.gov.br/SimplesNacional/aplicacoes.aspx?id=21) Dados atualizados mensalmente com base nos arquivos publicos da Receita Federal. Veja [Limites de Uso](/pt/limites-de-uso). ```bash cURL theme={null} curl -X POST "https://api.cnpj-api.com/v1/bulk-cnpj?token=SEU_TOKEN" \ -H "Content-Type: application/json" \ -d '{"cnpjs": ["12345678000195", "98765432000100"]}' ``` # Cidades Source: https://docs.cnpj-api.com/pt/endpoint-cidades GET /v1/cidades/{id} Dados agregados de um município Código SIAFI/TOM do município (Tabela de Órgãos e Municípios), utilizado pela Receita Federal. Exemplo: `7107` Token de autenticação. Forma preferida de autenticação. ## O que está incluso * **100 maiores empresas** por capital social * **30 empresas mais recentes** por data de abertura * **30 principais sócios** vinculados às empresas de maior capital ## Fontes de dados * [Receita Federal](https://solucoes.receita.fazenda.gov.br/Servicos/cnpjreva/cnpjreva_solicitacao.asp) Limitado a 5 consultas por minuto para tokens gratuitos. Veja [Limites de Uso](/pt/limites-de-uso). ```bash cURL theme={null} curl "https://api.cnpj-api.com/v1/cidades/7107?token=SEU_TOKEN" ``` # Consultar CNPJ Source: https://docs.cnpj-api.com/pt/endpoint-cnpj GET /v1/cnpj/{cnpj} Dados cadastrais completos de um estabelecimento pelo CNPJ Número do CNPJ sem pontuação (14 dígitos). Exemplo: `12345678000195` Token de autenticação. Forma preferida de autenticação. Formato de resposta para compatibilidade com outras APIs: * `default`: Formato nativo desta API (padrão) * `receitaws`: Compatível com a ReceitaWS * `cnpja`: Compatível com a CNPJa ## Fontes de dados * [Receita Federal](https://solucoes.receita.fazenda.gov.br/Servicos/cnpjreva/cnpjreva_solicitacao.asp) * [Simples Nacional](https://www8.receita.fazenda.gov.br/SimplesNacional/aplicacoes.aspx?id=21) Dados atualizados mensalmente com base nos arquivos públicos da Receita Federal. Limitado a 5 consultas por minuto para tokens gratuitos. Veja [Limites de Uso](/pt/limites-de-uso). ```bash cURL theme={null} curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN" ``` ```bash cURL (formato ReceitaWS) theme={null} curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN&formato=receitaws" ``` # Logos e Sites Source: https://docs.cnpj-api.com/pt/endpoint-logos GET /v1/logos/{cnpj} Logotipo, favicon e websites associados a um CNPJ Número do CNPJ sem pontuação (14 dígitos). Exemplo: `90400888000142` Token de autenticação. Forma preferida de autenticação. ## O que está incluso Retorna o logotipo, ícone (favicon) e websites associados a um CNPJ. As imagens são servidas via CDN própria. Nem todos os CNPJs possuem logos ou websites associados. Limitado a 5 consultas por minuto para tokens gratuitos. Veja [Limites de Uso](/pt/limites-de-uso). ```bash cURL theme={null} curl "https://api.cnpj-api.com/v1/logos/90400888000142?token=SEU_TOKEN" ``` # Simples Nacional Source: https://docs.cnpj-api.com/pt/endpoint-simples GET /v1/simples/{cnpj} Opção pelo Simples Nacional e enquadramento no MEI Número do CNPJ sem pontuação (14 dígitos). Exemplo: `12345678000195` Token de autenticação. Forma preferida de autenticação. ## Fontes de dados * [Simples Nacional](https://www8.receita.fazenda.gov.br/SimplesNacional/aplicacoes.aspx?id=21) Limitado a 5 consultas por minuto para tokens gratuitos. Veja [Limites de Uso](/pt/limites-de-uso). ```bash cURL theme={null} curl "https://api.cnpj-api.com/v1/simples/12345678000195?token=SEU_TOKEN" ``` # Uso e Limites Source: https://docs.cnpj-api.com/pt/endpoint-uso-e-limites GET /v1/usage Plano atual e uso em tempo real do rate limit do token Token de autenticacao. Forma preferida de autenticacao. ## Observacoes * Este endpoint **nao consome creditos** do limite de requisicoes. * Utilize para verificar seu plano, uso atual e horario de reset antes de fazer consultas. * Os limites de requisicoes restantes sao retornados nos headers `x-ratelimit-remaining` e `x-ratelimit-reset` dos demais endpoints `/v1/*`. Veja [Limites de Uso](/pt/limites-de-uso) para mais detalhes sobre os planos. ```bash cURL theme={null} curl "https://api.cnpj-api.com/v1/usage?token=SEU_TOKEN" ``` ```json 200 theme={null} { "plan": "basic", "rate_limit": { "limit": 10, "window": "1 minute", "used": 3, "remaining": 7, "reset_at": "2026-04-20T22:31:00.000Z" } } ``` # Início Rápido Source: https://docs.cnpj-api.com/pt/inicio-rapido Faça sua primeira consulta em menos de 5 minutos # Início Rápido ## 1. Obtenha seu token Crie uma conta gratuita para receber seu token de autenticação. Veja [Criar Conta](/pt/criar-conta). ## 2. Faça sua primeira consulta ```bash theme={null} curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN" ``` ## 3. Receba a resposta ```json theme={null} { "cnpj": "12345678000195", "razao_social": "ALFA COMERCIO DIGITAL LTDA", "nome_fantasia": "ALFA DIGITAL", "data_abertura": "2020-06-05", "matriz": true, "situacao": { "codigo": 2, "descricao": "Ativa" }, "atividade_principal": { "codigo": 6311900, "descricao": "Tratamento de dados, provedores de servicos de aplicacao e servicos de hospedagem na internet" }, "endereco": { "logradouro": "Avenida Brigadeiro Faria Lima", "numero": "2369", "bairro": "Jardim Paulistano", "municipio": "Sao Paulo", "uf": "SP", "cep": "01452922" }, "empresa": { "capital_social": 1000, "natureza_juridica": { "codigo": 2062, "descricao": "Sociedade Empresaria Limitada" }, "socios": [] } } ``` ## Próximos passos * [Autenticação](/pt/autenticacao) - Entenda os métodos de autenticação e limites * [Consulta CNPJ](/pt/endpoint-cnpj) - Veja todos os campos disponíveis * [Logos e Sites](/pt/endpoint-logos) - Obtenha a identidade visual da empresa # Introdução Source: https://docs.cnpj-api.com/pt/introducao API para consulta de dados cadastrais de empresas brasileiras por CNPJ # API de Consulta CNPJ API completa para consulta de dados cadastrais de empresas brasileiras, com dados da Receita Federal, Simples Nacional e identidade visual. ## Autenticação Todas as requisições requerem um token. Tokens gratuitos estão disponíveis com limites de uso. Veja a página de [Autenticação](/pt/autenticacao) para detalhes. ```bash theme={null} curl "https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN" ``` ## Parâmetro `formato` O endpoint `/cnpj/{cnpj}` aceita um parâmetro `formato` que permite receber a resposta em formatos compatíveis com outras APIs: | Valor | Descrição | | ----------- | ----------------------------------- | | `default` | Formato nativo desta API (padrão) | | `receitaws` | Resposta compatível com a ReceitaWS | | `cnpja` | Resposta compatível com a CNPJa | Isso facilita a migração de clientes que já utilizam ReceitaWS ou CNPJa. Basta alterar a URL base e adicionar `?formato=receitaws` ou `?formato=cnpja` para manter a compatibilidade com o código existente. Veja as páginas de [Migração da ReceitaWS](/pt/migrar-receitaws) e [Migração da CNPJa](/pt/migrar-cnpja) para guias completos. ## Principais Endpoints Dados cadastrais completos: razão social, endereço, atividades econômicas, situação cadastral, sócios e mais. Logotipo, favicon e websites associados a um CNPJ. Opção pelo Simples Nacional e enquadramento no MEI (Microempreendedor Individual). Dados agregados por município: maiores empresas, empresas recentes e principais sócios. # Limites de Uso Source: https://docs.cnpj-api.com/pt/limites-de-uso Entenda os limites de requisições da API # Limites de Uso Todos os endpoints da API possuem limites de requisições por token. Os limites variam de acordo com o tipo de token utilizado. ## Limites por plano | Plano | Limite | Reset | Volume mensal estimado | | ----- | ------------------------- | -------- | ---------------------- | | Free | 5 requisições por minuto | 1 minuto | \~216.000 | | Basic | 10 requisições por minuto | 1 minuto | \~432.000 | | Pro | 90 requisições por minuto | 1 minuto | \~3.888.000 | O volume mensal é uma estimativa baseada em uso contínuo: `limite × 60 × 24 × 30`. Não há limite mensal — apenas o rate limit por minuto é aplicado. ## Comportamento ao atingir o limite Quando o limite de requisições é atingido, a API retorna o status HTTP `429 Too Many Requests`: ```json theme={null} { "error": "Limite de requisições excedido." } ``` Aguarde o período de reset antes de fazer novas requisições. ## Limites por endpoint Todos os endpoints possuem o mesmo limite de **5 consultas por minuto** para tokens gratuitos: | Endpoint | Limite (gratuito) | | ------------------------ | ----------------- | | `GET /v1/cnpj/{cnpj}` | 5 req/min | | `GET /v1/logos/{cnpj}` | 5 req/min | | `GET /v1/simples/{cnpj}` | 5 req/min | | `GET /v1/cidades/{id}` | 5 req/min | ## Upgrade Para aumentar seus limites, faça upgrade do seu plano em [Minha Conta](https://cnpj-api.com/my-account). Para necessidades enterprise, entre em contato pelo email **[suporte@cnpj-api.com](mailto:suporte@cnpj-api.com)**. # Migrar da CNPJa Source: https://docs.cnpj-api.com/pt/migrar-cnpja Como migrar sua integração da CNPJa para a API de Consulta CNPJ # Migrando da CNPJa A migração da CNPJa é simples. O endpoint `/cnpj/{cnpj}` suporta o parâmetro `formato=cnpja`, que retorna a resposta no mesmo formato que a API da CNPJa. ## Passo 1: Altere a URL base ```diff theme={null} - https://api.cnpja.com/office/12345678000195 + https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN&formato=cnpja ``` ## Passo 2: Adicione autenticação Adicione o parâmetro `token` na URL ou o header `Authorization: Bearer {token}`. ## Passo 3: Teste A resposta terá o mesmo formato que a CNPJa. Nenhuma alteração no parsing é necessária. ## Diferenças | Aspecto | CNPJa | Esta API | | -------------- | ------------------ | ----------------------------- | | Autenticação | API Key via header | Token via URL ou header | | Rate limit | Conforme plano | 5 req/min (gratuito) | | Dados extras | Cadastro + sócios | Cadastro + logos + Simples | | Formato nativo | Próprio | Próprio (com compatibilidade) | ## Quando remover o parâmetro `formato` Recomendamos que, após validar a migração, você remova o parâmetro `formato=cnpja` e adapte seu código ao formato nativo desta API. O formato nativo oferece mais campos e dados estruturados. # Migrar da ReceitaWS Source: https://docs.cnpj-api.com/pt/migrar-receitaws Como migrar sua integração da ReceitaWS para a API de Consulta CNPJ # Migrando da ReceitaWS A migração da ReceitaWS é simples. O endpoint `/cnpj/{cnpj}` suporta o parâmetro `formato=receitaws`, que retorna a resposta no mesmo formato que a API da ReceitaWS. ## Passo 1: Altere a URL base ```diff theme={null} - https://receitaws.com.br/v1/cnpj/12345678000195 + https://api.cnpj-api.com/v1/cnpj/12345678000195?token=SEU_TOKEN&formato=receitaws ``` ## Passo 2: Adicione autenticação Adicione o parâmetro `token` na URL ou o header `Authorization: Bearer {token}`. ## Passo 3: Teste A resposta terá o mesmo formato que a ReceitaWS. Nenhuma alteração no parsing é necessária. ## Diferenças | Aspecto | ReceitaWS | Esta API | | -------------- | --------------- | ----------------------------- | | Autenticação | Varia por plano | Token via URL ou header | | Rate limit | Varia por plano | 5 req/min (gratuito) | | Dados extras | Apenas cadastro | Cadastro + logos + Simples | | Formato nativo | Próprio | Próprio (com compatibilidade) | ## Quando remover o parâmetro `formato` Recomendamos que, após validar a migração, você remova o parâmetro `formato=receitaws` e adapte seu código ao formato nativo desta API. O formato nativo oferece mais campos e dados estruturados. # Skill CNPJ Source: https://docs.cnpj-api.com/pt/skill-cnpj Ensine seu agente de IA a consultar dados de empresas brasileiras com um único comando **Agent Skill** oficial da cnpj-api.com para agentes de codificação com IA (Claude Code, Cursor, Codex, Windsurf, OpenCode e +40 outros). Instala um pacote de conhecimento que o agente já sabe usar: autenticação, endpoints, tratamento de erros e formatação de CNPJ já vêm configurados. Instalação com um comando e agente usando a skill ## Instalação rápida Para a maioria dos agentes (Claude Code, Cursor, Codex, Windsurf, etc.), rode no diretório do seu projeto: ```bash theme={null} npx skills add cnpj-api/skills ``` O CLI coloca os arquivos no diretório correto do seu agente (`.claude/skills/`, `.cursor/skills/`, etc.) automaticamente. Usando **Claude.ai na web ou no desktop**? A interface web não roda `npx`. Siga o guia [Instalar no Claude manualmente](/pt/skill-cnpj-claude-manual) para fazer o upload do ZIP diretamente. ## Configuração 1. Crie uma conta grátis em [cnpj-api.com](https://cnpj-api.com) e gere um token. 2. Exporte o token como variável de ambiente: ```bash theme={null} export CNPJ_API_TOKEN="seu-token-aqui" ``` O agente lê essa variável sempre que a skill for acionada. Nunca armazena ou loga o valor. ## O que está incluído Cobertura completa da cnpj-api via 8 endpoints: | Endpoint | Plano | Descrição | | --------------------------- | ------- | --------------------------------- | | `GET /v1/cnpj/{cnpj}` | free+ | Dados completos da empresa | | `POST /v1/bulk-cnpj` | **pro** | Consulta em lote (até 20) | | `GET /v1/simples/{cnpj}` | free+ | Status Simples Nacional e SIMEI | | `GET /v1/socios/{pessoaId}` | free+ | Perfil do sócio e participações | | `GET /v1/cidades/{id}` | free+ | Agregados por município (IBGE) | | `GET /v1/cnae/{cnae}` | free+ | Agregados por atividade econômica | | `GET /v1/usage` | free+ | Plano atual e rate limit | Além de scripts auxiliares (`validate-cnpj.ts` e `bulk-lookup.ts`). ## Como usar Depois de instalada, peça ao agente em linguagem natural: *"Consulte o CNPJ 82.845.322/0001-04"* *"Essa empresa é Simples Nacional?"* *"Me dá os sócios dessa empresa"* *"Enriquece essa lista de 50 CNPJs"* O agente escolhe o endpoint correto, trata erros, respeita o rate limit e monta as chamadas com `api-token` automaticamente. ## Compatibilidade Funciona com qualquer agente que suporte o formato [Agent Skills](https://agentskills.io): ## Limites e planos Veja planos e preços em [cnpj-api.com/precos](https://cnpj-api.com/precos). Consulta em lote (`/v1/bulk-cnpj`) requer o plano **Pro**. ## Código aberto A skill é **MIT** e pública: * **Repositório:** [github.com/cnpj-api/skills](https://github.com/cnpj-api/skills) * **Especificação Agent Skills:** [agentskills.io](https://agentskills.io) Issues e PRs são bem-vindos. ## Próximos passos Guia passo a passo para Claude.ai (web e desktop) com upload de ZIP. Ver o código da skill, SKILL.md, referências e scripts. # Instalar no Claude manualmente Source: https://docs.cnpj-api.com/pt/skill-cnpj-claude-manual Como fazer o upload da Skill CNPJ no Claude.ai (web e desktop) via ZIP