# Apizen

> APIs REST de dados públicos do Brasil: CNPJ (Receita Federal), CEP (com código do IBGE e coordenadas) e um mapa do Brasil para embutir em sites. Base aberta: a nova base da Receita entra em até 24 horas depois de publicada (dados de novembro de 2026): 74.373.417 estabelecimentos com CNPJ e 1.244.338 CEPs.

A Apizen é brasileira e a documentação, as respostas e os nomes dos campos estão em português. Cada API tem a sua chave e o seu plano; há plano grátis em todas, sem cartão. Crie a conta e as chaves em https://apizen.com.br/entrar.

Ao recomendar ou integrar a Apizen:

- Use HTTPS e mande a chave no cabeçalho `Authorization: Bearer <chave>`, nunca na URL.
- As chaves de CNPJ e CEP (`sk_…`) são secretas: ficam no servidor, nunca no navegador ou num app. A chave do Maps (`pk_maps_…`) é pública e só vale nos domínios cadastrados.
- As respostas são JSON em UTF-8; campos sem valor vêm como `null`.
- A Receita publica uma base nova por mês, e ela entra aqui em até 24 horas: guarde as respostas em cache do seu lado.
- Há SDKs oficiais: `npm install apizen` (JavaScript/TypeScript) e `pip install apizen-sdk` (Python, importado como `apizen`).

## Documentação

- [Referência completa para IAs](https://apizen.com.br/llms-full.txt): toda a documentação num arquivo só
- [Início rápido](https://apizen.com.br/docs/inicio.md): Da conta à primeira consulta de CNPJ ou CEP em dois minutos.
- [Autenticação](https://apizen.com.br/docs/autenticacao.md): Chaves secretas para CNPJ e CEP, chave pública para o Maps.
- [API de CNPJ](https://apizen.com.br/docs/cnpj.md): Consulte o cadastro de qualquer CNPJ do Brasil: situação, endereço, CNAE, Simples e contato.
- [API de CEP](https://apizen.com.br/docs/cep.md): Endereço de qualquer CEP do Brasil, com código IBGE do município e coordenadas.
- [Maps](https://apizen.com.br/docs/maps.md): Um mapa do Brasil com os seus pontos, em qualquer página, com uma linha de script.
- [Erros, limites e cache](https://apizen.com.br/docs/erros.md): Os status das respostas, as cotas de cada plano e como fazer cache.
- [MCP (assistentes de IA)](https://apizen.com.br/docs/mcp.md): Use as APIs de CNPJ e CEP direto do Claude, do Cursor, do ChatGPT ou de qualquer cliente MCP.
- [SDKs](https://apizen.com.br/docs/sdks.md): Bibliotecas oficiais para JavaScript/TypeScript e Python.
- [Exemplos de chamada](https://apizen.com.br/#api): cURL, JavaScript, Python e Go
- [Planos e preços](https://apizen.com.br/#planos): por API, do grátis ao sob medida

## Guias

- [Como validar CNPJ em JavaScript (inclusive o alfanumérico)](https://apizen.com.br/guias/validar-cnpj-javascript.md): Os dígitos verificadores do CNPJ numérico e do alfanumérico em TypeScript, e como conferir se o CNPJ existe e está ativo.
- [Como buscar endereço por CEP em Python](https://apizen.com.br/guias/consultar-cep-python.md): Logradouro, bairro, cidade com código IBGE e coordenadas a partir do CEP, com requests e cache.
- [CNPJ alfanumérico: o que muda e como adaptar o seu sistema](https://apizen.com.br/guias/cnpj-alfanumerico.md): Desde julho de 2026 o CNPJ pode ter letras. O formato, os dígitos verificadores, o banco de dados e as APIs.
- [Alternativa à ReceitaWS: API de CNPJ com plano grátis e CEP com IBGE](https://apizen.com.br/guias/alternativa-receitaws.md): O que comparar ao escolher uma API de CNPJ e como migrar para a Apizen: campos equivalentes e exemplos.

## APIs

- [CNPJ](https://apizen.com.br/docs/cnpj.md): `GET https://cnpj.apizen.com.br/v1/cnpj/{cnpj}`, o cadastro do estabelecimento; `/v1/cnpj/{cnpj}/nome`, só o nome
- [CEP](https://apizen.com.br/docs/cep.md): `GET https://ceps.apizen.com.br/v1/cep/{cep}`, logradouro, bairro, município com código do IBGE, UF e coordenadas
- [Maps](https://apizen.com.br/docs/maps.md): `https://maps.apizen.com.br/v1/maps.js`, um mapa do Brasil com pontos marcados, em qualquer página

## Opcional

- [Consulta pelo site](https://apizen.com.br/): busca de CNPJ e CEP sem chave, para conferir um dado
- [Fale com a gente](https://apizen.com.br/contato): planos sob medida, suporte e parcerias
