# Documentacao da API CNPJ APICNPJ

A API REST da APICNPJ permite consultar CNPJ, buscar empresas brasileiras, obter dados cadastrais, socios, CNAE, endereco, telefone e email atraves de respostas em JSON.

## Quick start

```bash
curl "https://api.apicnpj.com/cnpj/05729230000100" \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "User-Agent: minha-integracao/1.0"
```

## Dados retornados

- CNPJ
- Razao social
- Nome fantasia
- Situacao cadastral
- Data de abertura
- CNAE principal
- CNAEs secundarios
- Natureza juridica
- Porte
- Capital social
- Endereco
- Municipio
- Estado
- CEP
- Telefones
- Emails
- Socios
- Empresas relacionadas quando disponiveis

## Endpoints comuns

| Endpoint | Funcao |
| --- | --- |
| GET /cnpj/{cnpj} | Consulta dados cadastrais completos de um CNPJ |
| GET /seek | Busca empresas por nome, UF, cidade, CNAE e contatos |
| GET /search | Busca empresarial com filtros comerciais |
| GET /health | Verifica disponibilidade da API |

## Rate limit

Sem token, a API publica usa limite por IP. Com token, API REST e MCP compartilham o consumo do plano. As respostas podem incluir:

- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Reset

## MCP

O MCP da APICNPJ permite que agentes de IA consultem empresas, encontrem socios, pesquisem CNAEs, gerem leads B2B e usem recursos estruturados via tools, resources e prompts.

Documentacao completa: https://apicnpj.com/api-docs/mcp