API do Radar CNPJ

← Voltar à busca

API REST sobre a base completa do CNPJ (Dados Abertos da Receita Federal). Respostas em JSON, UTF-8. Base pública e gratuita — por ora restrita ao Brasil. URL base: https://cnpj.exponencialadm.net

Autenticação

Opcional. Sem chave, vale o limite por IP. Com uma chave de API você ganha cota diária maior e exportação ampliada. Crie e gerencie suas chaves em Minha conta. Envie no cabeçalho:

Authorization: Bearer radar_SUA_CHAVE

Também aceita o header x-api-key: radar_…. A chave aparece só uma vez na criação — guarde com cuidado.

Limites

Anônimo: limite por IP por minuto (busca, ficha, etc.); export até 1.000 linhas.
Com chave: cota diária por chave + rajada por minuto; export muito maior. Escopos por rota.
Respostas de erro trazem { ok:false, code, error }. Códigos: chave_invalida (401), escopo_negado (403), rate_limited/quota_excedida (429), geo_blocked (403).

Endpoints

GET/api/v1/busca

Busca empresas por nome, fantasia, sócio, endereço ou CNAE, com filtros.

q — termo (palavras, mín. 3 letras)
tipo — nome | fantasia | socio | endereco | cnae
uf, municipio, situacao, cnae, cep — filtros
page, pageSize — paginação (máx. 50/página)

curl "https://cnpj.exponencialadm.net/api/v1/busca?q=padaria&tipo=fantasia&uf=SP&situacao=2"

GET/api/v1/cnpj/{cnpj}

Ficha completa: empresa + estabelecimento + Simples/MEI + sócios.

cnpj — 14 dígitos, com ou sem máscara

curl "https://cnpj.exponencialadm.net/api/v1/cnpj/00000000000191"

GET/api/v1/autocomplete

Sugestões por prefixo de nome/fantasia (rápido).

q — prefixo
limit — 1–15 (padrão 8)

curl "https://cnpj.exponencialadm.net/api/v1/autocomplete?q=merc"

GET/api/v1/ref

Tabelas de referência (CNAE, município, natureza…) para seletores.

tipo — cnae | municipio | natureza | qualificacao | pais | motivo
q ou codigos — texto ou códigos (csv)

curl "https://cnpj.exponencialadm.net/api/v1/ref?tipo=cnae&q=padaria"

GET/api/v1/export

Exporta resultados em CSV ou JSON. Cap: 1.000 linhas anônimo; muito mais com chave.

format — csv | json
(mesmos filtros da busca)

curl -H "Authorization: Bearer radar_SUA_CHAVE" \
  "https://cnpj.exponencialadm.net/api/v1/export?q=padaria&uf=SP&format=csv" -o empresas.csv

POST/api/v1/ia

Converte um texto livre em filtros de busca.

texto — JSON no corpo: { "texto": "..." } (3–400 caracteres)

curl -X POST "https://cnpj.exponencialadm.net/api/v1/ia" \
  -H "content-type: application/json" \
  -d '{"texto":"padarias ativas em SP com e-mail"}'

GET/api/v1/health

Saúde do serviço e data do dump da base.

curl "https://cnpj.exponencialadm.net/api/v1/health"

Especificação OpenAPI

Spec no padrão OpenAPI 3.1 — importe no Swagger Editor, Insomnia, Postman ou gere um cliente:

Abrir /openapi.json ↗

# Postman/Insomnia: importar a URL
https://cnpj.exponencialadm.net/openapi.json

# Swagger Editor: cole a URL em File > Import URL