🚀 CNPJ Scraper API

API robusta para raspagem de dados de CNPJ com autenticação, cache e rate limiting.

100
Req/15min por IP
60min
Cache TTL
3
Fontes de Dados

📋 Endpoints Disponíveis

GET /api/status

Retorna informações detalhadas sobre o status da API, cache e rate limiting.

GET /api/health

Health check simples para monitoramento.

GET /api/cnpj/:cnpj AUTH

Busca dados completos de uma empresa pelo CNPJ.

Parâmetros: cnpj - CNPJ com ou sem formatação

POST /api/cnpj/batch AUTH

Busca dados de múltiplos CNPJs (máximo 10 por requisição).

Body: { "cnpjs": ["11111111000181", "22222222000182"] }

GET /api/cache/stats AUTH

Estatísticas detalhadas do cache.

DELETE /api/cache AUTH

Limpa todo o cache da aplicação.

🔐 Autenticação

Para endpoints que requerem autenticação, inclua o header:

Authorization: Bearer SEU_TOKEN_AQUI

📊 Rate Limiting

Máximo de 100 requisições por 15 minutos por IP.

💾 Cache

Os dados são armazenados em cache por 60 minutos para otimizar performance.

📖 Exemplo de Uso

Buscar CNPJ individual:

curl -H "Authorization: Bearer SEU_TOKEN" \
     "http://localhost:3003/api/cnpj/11222333000181"

Buscar múltiplos CNPJs:

curl -X POST \
     -H "Authorization: Bearer SEU_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"cnpjs":["11222333000181","44555666000199"]}' \
     "http://localhost:3003/api/cnpj/batch"

📝 Dados Retornados

Desenvolvido com ❤️ usando Bun.js | Versão 1.0.0