radar-cnpj

Índice da API, com operações, formatos, autenticação e limites.

{
  "type": "object",
  "properties": {}
}

Health da base. `import.dump_date` informa a data de referência e `import.counts` traz as contagens disponíveis. A consulta não confirma mudanças em tempo real.

{
  "type": "object",
  "properties": {}
}

Ficha de empresa por CNPJ (14 dígitos), com as sanções da empresa (CEIS, CNEP, CEPIM, leniência e TCU) em data.sancoes e o último CNIA conferido das monitoradas em data.cnia (o da hora é a consulta_cnpj) e a situação fiscal da empresa em data.dividaAtiva (dívida ativa da União, PGFN), data.parcelamentos, data.regimeTributario (ECF), data.beneficiosFiscais (SISEN, ECF, DIRBI e renúncias na importação) e data.obras (obras do CNO), e o risco socioambiental em data.ambiental (autos e embargos do Ibama) e data.trabalhoEscravo (lista suja do MTE), e os contratos com o governo no PNCP em data.governo, os sócios na lista de pessoas expostas politicamente (CGU) em data.pep, os registros em órgãos reguladores (CVM, Banco Central, ANS, ANTT, ANP, ANEEL, Anatel, Anvisa, CNES, Cadastur e Ibama) em data.registros os financiamentos do BNDES em data.bndes, os pagamentos do governo federal em data.pagamentos, as vendas a órgãos federais por nota fiscal em data.notasFederais, os contratos federais desde 2013 em data.contratosFederais e as campanhas eleitorais que contrataram a empresa em data.campanhas. Sócio pessoa, telefones e e-mail vêm mascarados; o completo é reveal_cnpj. Nome de sócio pessoa física (`LUIS F. R. P.`), telefones e e-mail vêm mascarados, com `data.mascarado: true`; sócio empresa vem inteiro. O dado completo sai por `POST /api/revelar/:cnpj`. A resposta pode ser reutilizada por até 6 horas; confira a data de referência dos registros.

{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": "string",
      "description": "14 dígitos"
    }
  },
  "required": [
    "cnpj"
  ]
}

Revela sócios, telefones e e-mail sem máscara de um CNPJ. Pago: US$ 0,10 por empresa, do crédito (Authorization: Bearer cred_…) ou x402; com crédito, a mesma empresa no mesmo dia não cobra de novo. Custa US$ 0,10 por empresa: desconta do crédito pré-pago (`Authorization: Bearer cred_…`) ou paga só esta revelação com x402 (`X-PAYMENT`). O mesmo código de crédito revendo a mesma empresa no mesmo dia (horário de Brasília) não paga de novo; o x402 avulso cobra cada revelação. CNPJ inexistente ou consulta que falha não cobra nada. A resposta não vai para cache.

{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": "string",
      "description": "14 dígitos"
    }
  },
  "required": [
    "cnpj"
  ]
}

Dossiê da empresa por CNPJ: a ficha completa sem máscara (sócios, telefones e e-mail), a improbidade (CNIA) conferida na hora e o semáforo de risco (vermelho, amarelo ou verde, com os alertas, os pontos de atenção e o que não foi conferido). Pago: R$ 29,90 por empresa, do crédito (Authorization: Bearer cred_…) ou x402; com crédito, a mesma empresa no mesmo dia não cobra de novo. Custa R$ 29,90 por empresa (`PRECO_DOSSIE_BRL`; no x402, o equivalente em dólares de seis casas no câmbio do Pix): desconta do crédito pré-pago (`Authorization: Bearer cred_…` ou `X-Credito`) ou paga só este dossiê com x402 (`X-PAYMENT`). Traz tudo o que `GET /api/cnpj/:cnpj` traz, com sócios, telefones e e-mail inteiros, o CNIA conferido na hora e `semaforo`: `cor` (`vermelho`, `amarelo` ou `verde`), `alertas` e `atencao` (cada um `{ id, n?, valor?, saldo?, situacao? }`) e `sem_conferencia` (os blocos que não responderam agora; a cor não fica verde por falta de dado). O mesmo código de crédito pedindo a mesma empresa no mesmo dia (horário de Brasília) não paga de novo. CNPJ inexistente ou consulta que falha não cobra nada. A resposta não vai para cache.

{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": "string",
      "description": "14 dígitos"
    }
  },
  "required": [
    "cnpj"
  ]
}

Busca empresas (q e/ou filtros f=JSON). tipo: nome, fantasia, socio, telefone (com DDD), endereco ou cnae. Exige termo OU pelo menos um filtro — varrer 71 milhões de estabelecimentos sem recorte não é uma busca, é um dump.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Termo de busca, entre 2 e 120 caracteres."
    },
    "tipo": {
      "type": "string",
      "description": "nome|fantasia|socio|telefone|endereco|cnae"
    },
    "f": {
      "type": "string",
      "description": "JSON string de filtros"
    },
    "page": {
      "type": "number",
      "description": "Página, começando em 0.",
      "default": 0
    },
    "pageSize": {
      "type": "number",
      "description": "Resultados por página, de 1 a 50.",
      "default": 20
    },
    "uf": {
      "type": "string",
      "description": "Restringe a uma unidade da federação."
    }
  }
}

Autocomplete. Não conta como visita nas métricas — senão o painel mediria tecla, não gente.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "O que já foi digitado."
    }
  },
  "required": [
    "q"
  ]
}

Ref CNAE/município/natureza. Ou você busca por texto (`q`) ou resolve códigos que já tem (`codigos`) — `codigos` ganha quando os dois vêm.

{
  "type": "object",
  "properties": {
    "tipo": {
      "type": "string",
      "description": "cnae|municipio|natureza|…",
      "enum": [
        "cnae",
        "municipio",
        "natureza"
      ]
    },
    "q": {
      "type": "string",
      "description": "Texto a procurar no vocabulário, até 60 caracteres."
    }
  },
  "required": [
    "tipo"
  ]
}

Avalia uma ideia de negócio pela quantidade de empresas cadastradas (CNAE + lugar → contagem de ativas). Não estima busca no Google. POST /api/avaliar. É o primeiro produto da home. Devolve o CNAE a que a ideia foi mapeada, quantas empresas ativas, abertas e baixadas existem no recorte, como elas se formalizam e uma leitura honesta disso. **Não inventa volume de busca** e não promete demanda: `ficha.limites` diz o que os números não dizem. Renda passiva isto não é.

{
  "type": "object",
  "properties": {
    "texto": {
      "type": "string",
      "description": "Ideia em português, 3–400 caracteres."
    },
    "uf": {
      "type": "string",
      "description": "Hint de UF se a frase não tiver cidade."
    },
    "municipio": {
      "type": "number",
      "description": "Hint de código de município da Receita."
    }
  },
  "required": [
    "texto"
  ]
}

Texto natural → filtros (POST /api/ia). Caminho síncrono: leva de 18 a 20 segundos. Quando estoura o tempo, use `POST /api/ia/jobs`.

{
  "type": "object",
  "properties": {
    "texto": {
      "type": "string",
      "description": "A descrição em linguagem natural do que você procura."
    }
  },
  "required": [
    "texto"
  ]
}

Geo de borda do visitante (cidade/UF). Nunca é cacheada: cache aqui entregaria o lugar de outra pessoa.

{
  "type": "object",
  "properties": {}
}

Fale com quem faz o produto: dúvida, ou proposta de patrocínio/parceria/anúncio. Grátis, sem captcha nem pagamento; uma mensagem a cada 10 s por rede (a que chega antes espera a vez). Uma rota para dúvida e para proposta de patrocínio, parceria ou anúncio (`tipo`, com os espaços de `GET /api/partners`). Sem captcha, sem conta, sem pagamento. Uma mensagem a cada 10 segundos por rede: a que chega antes espera a vez e sai — sem erro. A mensagem chega à equipe por e-mail, com o `email` como endereço de resposta.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Como chamar quem escreve (alias `nome`)."
    },
    "email": {
      "type": "string",
      "description": "Para onde responder."
    },
    "message": {
      "type": "string",
      "description": "O que você quer dizer (alias `mensagem`)."
    },
    "tipo": {
      "type": "string",
      "enum": [
        "patrocinio",
        "parceria",
        "anuncio"
      ],
      "description": "Proposta: `patrocinio`, `parceria` ou `anuncio`. Liga os campos abaixo."
    },
    "empresa": {
      "type": "string",
      "description": "Quem propõe, quando é empresa."
    },
    "site": {
      "type": "string",
      "description": "Site de quem propõe."
    },
    "orcamento": {
      "type": "string",
      "enum": [
        "ate_100",
        "100_500",
        "500_2000",
        "2000_mais",
        "a_combinar"
      ],
      "description": "`ate_100`, `100_500`, `500_2000`, `2000_mais` ou `a_combinar`."
    },
    "espaco": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ids de placement de `GET /api/partners`, até 6."
    },
    "duracao": {
      "type": "string",
      "enum": [
        "30",
        "90",
        "365"
      ],
      "description": "Dias de exposição: `30`, `90` ou `365`."
    },
    "pagamento": {
      "type": "string",
      "enum": [
        "usdc",
        "deposito",
        "a_combinar"
      ],
      "description": "`usdc`, `deposito` ou `a_combinar`."
    }
  },
  "required": [
    "name",
    "email",
    "message"
  ]
}

Lista os CNPJs que a sua carteira de crédito monitora, com a cota (10 grátis + vagas compradas). Quem confere a cota é a origem (`api.radar-cnpj.com`), dentro da transação; o Worker calcula quanto você tem (10 grátis + as vagas em vigor) e manda junto. Watch além da cota vem com `suspensa: true` e não gera e-mail.

{
  "type": "object",
  "properties": {
    "credito": {
      "type": "string",
      "description": "Token do crédito global (cred_…), de POST /api/credito."
    }
  },
  "required": [
    "credito"
  ]
}

Passa a monitorar um CNPJ com a sua carteira de crédito. Os 10 primeiros são grátis; cada vaga a mais debita US$ 0,50 do saldo (30 dias). Estourou a cota: **402 com `accepts[]`** (x402) — ou, com token de crédito, o débito direto do saldo. Pague e repita a mesma chamada com `X-PAYMENT`; a vaga fica no `direito` global e a watch entra.

{
  "type": "object",
  "properties": {
    "credito": {
      "type": "string",
      "description": "Token do crédito global (cred_…), de POST /api/credito."
    },
    "cnpj": {
      "type": "string",
      "description": "CNPJ a monitorar, 14 dígitos."
    }
  },
  "required": [
    "credito",
    "cnpj"
  ]
}

Ficha de empresa pelo CNPJ (Receita), com a situação especial quando há (falência, recuperação judicial, liquidação), as sanções dela (CEIS, CNEP, CEPIM, leniência, TCU e o CNIA do CNJ, conferido na hora), os sócios na lista de pessoas expostas politicamente (CGU), a situação fiscal (dívida ativa da União, parcelamentos, benefícios e obras), o risco socioambiental (lista suja do trabalho escravo, embargos e autos do Ibama), os contratos com o governo (PNCP, o federal desde 2013 e as vendas a prefeituras paulistas do TCE-SP) e os financiamentos do BNDES, os registros em órgãos reguladores e cadastros oficiais (CVM, Banco Central, ANS, ANTT, ANP, ANEEL, Anatel, Anvisa, CNES, Cadastur, Ibama, ANAC e SICAF), os fundos de investimento da CVM e o endereço no mapa (CNEFE/IBGE). 10 grátis por dia; depois, do saldo (plano ou pacote) da conta ou do crédito. Uma consulta: sai da franquia grátis do dia (10 por rede) e, depois dela, do saldo da conta ou do crédito (plano ou pacote). Sem franquia nem saldo, 402 com as ofertas. Aceita o CNPJ numérico e o alfanumérico. Não encontrado, fonte fora do ar ou limite por minuto não são cobrados. O dado pessoal da ficha vem mascarado. Em `sancoes`, o que os cadastros públicos registram contra a empresa inteira (a raiz do CNPJ): CEIS, CNEP, CEPIM e acordos de leniência da CGU e licitantes inidôneos do TCU, atualizados todo dia — serve para checar fornecedor em lote.

{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": "string",
      "description": "CNPJ, com ou sem pontuação"
    }
  },
  "required": [
    "cnpj"
  ],
  "additionalProperties": false
}

Endereços de um CEP com coordenada (CNEFE/IBGE) e as empresas registradas nele. 10 grátis por dia; depois, do saldo. Uma consulta, paga como a do CNPJ: franquia grátis do dia, depois o saldo. Devolve até 20 endereços e até 20 empresas; o total de endereços vem em `pontos_total`.

{
  "type": "object",
  "properties": {
    "cep": {
      "type": "string",
      "description": "CEP com 8 dígitos"
    }
  },
  "required": [
    "cep"
  ],
  "additionalProperties": false
}

A franquia grátis de hoje, o pacote avulso e os três planos da consulta de CNPJ e endereço, e o saldo de quem pede. Não cobra. Sem credencial mostra a franquia e as ofertas; com a conta (cookie ou `X-Api-Key: mmk_…`) ou o crédito (`X-Credito`), também o saldo, que vale em todos os portais da casa (Radar CNPJ, PontoFato, EditalMD).

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Compra o pacote avulso ou um plano da consulta de CNPJ e endereço. Exige pagamento explícito: sem ele, devolve o 402 com o preço (crédito pré-pago ou x402). O saldo fica com a conta (cookie da sessão ou `X-Api-Key: mmk_…`) ou, sem conta, com a carteira do crédito que pagou (`X-Credito`). Sem pagamento, 402 com o preço e as portas: crédito pré-pago (comprado também por Pix) ou x402. Plano soma 30 dias e a quota dele ao que já existe; o pacote vale 90 dias. Sem renovação automática.

{
  "type": "object",
  "properties": {
    "oferta": {
      "type": "string",
      "description": "pacote, basico, profissional ou empresa"
    },
    "compra": {
      "type": "string",
      "description": "Marca desta compra (8 a 64 caracteres A-Za-z0-9_-)"
    },
    "credit_token": {
      "type": "string",
      "description": "Token do crédito pré-pago (cred_…)"
    },
    "payment": {
      "type": "string",
      "description": "Pagamento x402 assinado, a partir da cotação"
    }
  },
  "required": [
    "oferta"
  ],
  "additionalProperties": false
}

Relatório de uma lista de CNPJs de fornecedores ou clientes (até 100 por chamada): por empresa, a situação cadastral e a especial (falência, recuperação judicial, liquidação), as sanções, os sócios na lista de pessoas expostas politicamente (CGU), a dívida ativa da União, os parcelamentos, os benefícios, as obras, a lista suja do trabalho escravo, os embargos e autos do Ibama, os contratos com o governo (PNCP), os registros em órgãos reguladores (CVM, Banco Central, ANS, ANTT, ANP, ANEEL, Anatel, Anvisa, CNES, Cadastur e Ibama) e os financiamentos do BNDES. Cada CNPJ válido é uma consulta do saldo (plano ou pacote); o que não está na base não é cobrado. Até 200 CNPJs por pedido; cada CNPJ válido é uma consulta do saldo da conta ou do crédito (a franquia grátis é da consulta de um CNPJ). O lote se desconta de uma vez e nunca passa do saldo; o CNPJ que não está na base volta ao saldo, e o inválido ou repetido não se cobra. `?formato=csv` devolve a planilha (`;` e vírgula decimal em português, BOM, fórmula desarmada). A mesma `Idempotency-Key` com a mesma lista não cobra de novo.

{
  "type": "object",
  "properties": {
    "cnpjs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "description": "CNPJs com ou sem pontuação"
    },
    "credit_token": {
      "type": "string",
      "description": "Token do crédito pré-pago (cred_…) com o saldo"
    }
  },
  "required": [
    "cnpjs"
  ],
  "additionalProperties": false
}

Monthly data package and private purchase status, without charging.

{
  "type": "object",
  "properties": {
    "api_pass": {
      "type": "string",
      "description": "Private pass: api_<32 random hex>_<64 random hex>. Save before buying."
    }
  },
  "additionalProperties": false
}

Buy 1,000 basic data reads for US$1, valid for 30 days. Requires explicit payment. Same pass in retries recovers the same purchase. No automatic renewal. OCR, AI, documents and delivery keep their own tariffs. Send X-API-Pass on eligible data reads; remaining credits come in X-API-Credits-Remaining.

{
  "type": "object",
  "properties": {
    "api_pass": {
      "type": "string",
      "description": "Private pass: api_<32 random hex>_<64 random hex>. Save before buying."
    },
    "credit_token": {
      "type": "string",
      "description": "Existing prepaid credit token."
    },
    "payment": {
      "type": "string",
      "description": "Signed x402 payload, after authorizing the quote."
    },
    "transaction": {
      "type": "string",
      "description": "Base transaction hash to reconcile an uncertain payment with the same pass and original payload."
    }
  },
  "required": [
    "api_pass"
  ],
  "additionalProperties": false
}

Current public prices and free allowances; no charge.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Payment discovery and billing summary; does not create a charge.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}