Desenvolvedores
Consulte empresas brasileiras programaticamente: ficha, DataPJ Score, sócios, dívida (PGFN), sanções, grafo societário, panoramas, export e monitoramento. Tudo a partir de dados públicos, com proveniência. O CPF de sócios pessoa física é sempre mascarado (LGPD).
Gere uma chave em /conta/api e envie-a no cabeçalho Authorization: Bearer SUA_CHAVE (ou x-api-key: SUA_CHAVE). A chave é mostrada uma única vez — guarde com segurança. A cota diária segue o plano atual da conta e vem nos cabeçalhos X-RateLimit-Limit / X-RateLimit-Remaining de cada resposta.
Cota de raio-x: revelar sócios, dívida e sanções (endpoints /empresa/{cnpj}, /socios, /divida, /sancoes-intl) consome a mesma cota mensal de consultas do seu plano (a mesma do site) — a mesma empresa no mês não reconta. Esgotada, esses endpoints retornam 402. Score, grafo, busca e panorama não consomem essa cota.
Cada chave carrega escopos. Escolha-os ao gerar a chave:
read — consulta (todos os GET). Sempre presente.export — exportar em lote (POST /export).monitor — gerir empresas monitoradas (/monitor).Uma chave sem o escopo necessário recebe 403.
| Método | Rota | Descrição | Escopo |
|---|---|---|---|
| GET | /empresa/{cnpj} | Ficha: cadastro, situação, CNAE, porte, capital, score, sócios, sanções | read |
| GET | /empresa/{cnpj}/score | DataPJ Score explicável (0–1000 + fatores) | read |
| GET | /empresa/{cnpj}/socios | Quadro societário (CPF mascarado) | read |
| GET | /empresa/{cnpj}/divida | Dívida ativa da União (PGFN) | read |
| GET | /empresa/{cnpj}/sancoes-intl | Listas internacionais (OFAC/ONU/UE) | read |
| GET | /empresa/{cnpj}/grafo | Ego-grafo societário (rede imediata) | read |
| GET | /busca | Buscar por razão social e/ou filtros (uf, cnae, situação, porte) | read |
| GET | /panorama | Agregados por UF, cidade ou categoria | read |
| POST | /export | Export em lote (CSV) — teto por plano; contatos só em planos pagos | export |
| GET | /monitor | Listar empresas monitoradas | monitor |
| POST | /monitor | Adicionar/remover empresa do monitoramento | monitor |
Base: https://datapj.com.br/api/v1. CNPJ aceita 14 dígitos (com ou sem pontuação) ou os 8 da raiz.
# Ficha da empresa
curl -H "Authorization: Bearer SUA_CHAVE" https://datapj.com.br/api/v1/empresa/00360305000104
# Buscar empresas (mesmos filtros da busca)
curl -H "Authorization: Bearer SUA_CHAVE" "https://datapj.com.br/api/v1/busca?q=construtora&uf=SP&situacao=ativa"
# Export em lote → CSV (escopo "export")
curl -X POST -H "Authorization: Bearer SUA_CHAVE" \
"https://datapj.com.br/api/v1/export?q=construtora&uf=SP" -o empresas.csv
# Monitorar (escopo "monitor")
curl -X POST -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
-d '{"cnpj":"00360305000104","acao":"add"}' https://datapj.com.br/api/v1/monitorA mesma API é exposta como servidor MCP (Model Context Protocol) para Claude Desktop, Claude Code, Cursor e afins — o agente consulta CNPJ, busca empresas e lê score/sócios/dívida/grafo com a sua chave. Veja a configuração em services/mcp (stdio) e gere a chave em /conta/api.
/api/v1; mudanças que quebram contrato só em /v2.