# Início rápido

> Da conta à primeira consulta de CNPJ ou CEP em dois minutos.

A Apizen tem três APIs de dados públicos do Brasil, cada uma com a sua chave e o seu plano, todas com plano grátis:

- **[CNPJ](https://apizen.com.br/docs/cnpj.md)**: o cadastro de qualquer estabelecimento, com os dados abertos da Receita Federal (base de novembro de 2026, 74.373.417 estabelecimentos).
- **[CEP](https://apizen.com.br/docs/cep.md)**: logradouro, bairro, município com código do IBGE, UF e coordenadas (1.244.338 CEPs).
- **[Maps](https://apizen.com.br/docs/maps.md)**: um mapa do Brasil com os seus pontos, para colar em qualquer página.

## 1. Crie a conta e uma chave

Entre em [https://apizen.com.br/entrar](https://apizen.com.br/entrar) com o seu e-mail (sem senha: você recebe um link). Crie uma organização e, na aba **Chaves**, uma chave da API que vai usar. A chave inteira aparece uma vez só: guarde-a numa variável de ambiente.

## 2. Faça a primeira chamada

**cURL**

```bash
curl https://cnpj.apizen.com.br/v1/cnpj/33000167000101 \
  -H "Authorization: Bearer $CNPJ_API_KEY"
```

**JavaScript**

```javascript
const res = await fetch("https://cnpj.apizen.com.br/v1/cnpj/33000167000101", {
  headers: { Authorization: `Bearer ${process.env.CNPJ_API_KEY}` },
});
const dados = await res.json();
```

**Python**

```python
import os, requests

res = requests.get(
    "https://cnpj.apizen.com.br/v1/cnpj/33000167000101",
    headers={"Authorization": f"Bearer {os.environ['CNPJ_API_KEY']}"},
)
dados = res.json()
```

**Go**

```go
req, _ := http.NewRequest("GET", "https://cnpj.apizen.com.br/v1/cnpj/33000167000101", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("CNPJ_API_KEY"))
res, err := http.DefaultClient.Do(req)
```

## 3. Leia a resposta

```json
{
  "cnpj": "33000167000101",
  "razao_social": "Petroleo Brasileiro S A Petrobras",
  "nome_fantasia": "Petrobras - Edise",
  "matriz": true,
  "ativa": true,
  "situacao": { "codigo": "02", "descricao": "Ativa" },
  "data_situacao": "2005-11-03",
  "data_inicio_atividade": "1966-09-28",
  "simples": null,
  "mei": null,
  "cnae": { "codigo": "0600001", "descricao": "Extração de petróleo e gás natural" },
  "endereco": {
    "logradouro": "Avenida Republica do Chile",
    "numero": "65",
    "complemento": null,
    "bairro": "Centro",
    "cep": "20031170",
    "municipio": { "codigo_ibge": "3304557", "nome": "Rio de Janeiro" },
    "uf": "RJ"
  },
  "telefone": "2121660000",
  "email": "cc-rfisc@petrobras.com.br"
}
```

Os campos estão em português e os valores ausentes vêm como `null`. Veja todos na [referência da API de CNPJ](https://apizen.com.br/docs/cnpj.md).

## Próximos passos

- [Autenticação](https://apizen.com.br/docs/autenticacao.md): chaves secretas e públicas, onde guardar cada uma.
- [Erros e limites](https://apizen.com.br/docs/erros.md): os status, as cotas e o cache.
- [MCP](https://apizen.com.br/docs/mcp.md): use a Apizen direto de um assistente de IA (Claude, Cursor, ChatGPT).
- [SDKs](https://apizen.com.br/docs/sdks.md): JavaScript/TypeScript e Python.
