Reputação de Empresas por CNPJ - Reviews e Reclame Aqui - API

⭐ O que é a consulta de reputação por CNPJ?

Consulta notas, reclamações e marcas vinculadas de empresas brasileiras em uma chamada. Envie de 1 a 100 CNPJs por execução e receba notas unificadas (90 e 365 dias), totais de reclamação, taxas de resposta/resolução e métricas por marca (Reclame Aqui e outras fontes). Exporte em JSON, CSV ou Excel, ou integre via API REST.

1 CNPJ na entrada = 1 linha no Dataset na saída (só se houver reputação). CNPJ inválido é ignorado e não é cobrado. Este Actor entrega indicadores agregados, não o texto integral de reclamações.

Quais dados a consulta retorna?

🏷️ Identificação	cnpj, cnpjFormatado
📊 Notas unificadas	notaUnificada90Dias, notaUnificada365Dias (0–10) e classificação (OTIMO, BOM, REGULAR, RUIM, NAO RECOMENDADO, RA1000)
📅 Linha do tempo	primeiraAvaliacaoEm, ultimaAvaliacaoEm
🏆 Melhor nota	melhorNota, melhorNotaDescricao entre os perfis vinculados
🏬 Marcas	totalMarcas, marcas[] (nome, fonte, notas, totais e taxas)
📈 Histórico opcional	historicoAvaliacoes[] por marca se includeHistory for true

O que este Actor faz?

• ⭐ Reputação em uma chamada: notas + reclamações + marcas
• 📋 Lote: até 100 CNPJs por execução
• 📤 Exportação: JSON, CSV, Excel no Dataset
• ⚡ API em lote: uma chamada devolve todas as linhas
• 🔗 Pipeline: combine com KYC, sanções e enriquecimento

Pensado para homologação de fornecedores, qualificação de leads, sinais de KYB e monitoramento de marcas.

Docs: brasildados.org · Loja: apify.com/brasildados

---

Por que consultar reputação por CNPJ?

• Homologação de fornecedores: notas e taxas antes do contrato
• Qualificação de leads: priorize empresas com melhor sinal de consumidor
• KYC/KYB: reputação ao lado de PEP e sanções
• Inteligência competitiva: compare marcas e plataformas do mesmo CNPJ
• Monitoramento: resposta, resolução e “voltaria a negociar”

---

Como consultar reputação em lote?

1. Abra o Actor no Console Apify → aba Input.
2. Cole os CNPJs em cnpjs (qualquer formato). Ajuste maxBrands e includeHistory se quiser.
3. Clique em Start e aguarde.
4. Dataset → Export → JSON, CSV ou XLSX.

Exemplo de entrada:

{
  "cnpjs": ["18.236.120/0001-58"],
  "maxBrands": 30,
  "includeHistory": false
}

---

⬇️ Entrada

Clique na aba Input para o schema completo.

Campo	Obrigatório	Padrão	Descrição
cnpjs	Sim	amostra	Lista de CNPJs. Máx. 100. Qualquer formato. Inválidos ignorados (não cobrados).
maxBrands	Não	30	Teto de perfis de marca/plataforma por CNPJ (0–50). 0 = todos.
includeHistory	Não	false	true inclui snapshots históricos por marca (payload maior).

---

⬆️ Saída

Baixe na aba Dataset. Uma linha por CNPJ com reputação encontrada. As marcas ficam em marcas[] dentro da linha — a cobrança é por CNPJ, não por marca.

Amostra resumida. A linha completa inclui todas as marcas em marcas[] (até maxBrands). Lista de campos: aba Dataset schema no Console.

{
  "cnpj": "18236120000158",
  "cnpjFormatado": "18.236.120/0001-58",
  "notaUnificada90Dias": 8.06,
  "notaUnificada90DiasDescricao": "BOM",
  "notaUnificada365Dias": 7.65,
  "notaUnificada365DiasDescricao": "BOM",
  "primeiraAvaliacaoEm": "29/12/2020",
  "ultimaAvaliacaoEm": "04/03/2026",
  "melhorNota": 8.6,
  "melhorNotaDescricao": "OTIMO",
  "totalMarcas": 16,
  "marcas": [
    {
      "nome": "Magazine Luiza - Luizacred",
      "descricao": null,
      "categorias": null,
      "fonte": "Reclame Aqui",
      "notaFonte": 8.3,
      "notaFonteDescricao": "OTIMO",
      "notaConsumidor": 7.22,
      "notaConsumidorDescricao": "BOM",
      "totalReclamacoes": 30338,
      "totalRespondidas": 29976,
      "totalNaoRespondidas": 163,
      "percentualRespondido": 98.8,
      "percentualResolvido": 88.8,
      "percentualNaoResolvido": 11.2,
      "percentualVoltariaNegociar": 73.2,
      "tempoMedioRespostaHoras": 321.11,
      "categoriasReclamacoes": null
    }
  ]
}

Depois de várias execuções com resultado, avalie na aba Reviews da Store.

---

Quanto custa?

Cobrança por CNPJ com reputação encontrada (uma linha no Dataset). Sem reputação → sem cobrança.

Volume	Custo
1 CNPJ	$0,05
10 CNPJs	$0,50
100 CNPJs	$5,00

maxBrands e includeHistory não mudam a unidade cobrada; só o tamanho da linha.

---

🔌 Integração via API

curl -X POST "https://api.apify.com/v2/acts/brasildados~api-reputacao-empresas-cnpj/run-sync-get-dataset-items" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cnpjs":["18.236.120/0001-58"],"maxBrands":30,"includeHistory":false}'

---

Actors relacionados

Actor	Quando usar
KYC / PEP por CNPJ	PEP, sanções e doações em um registro
Sanções (CEIS, CNEP, CEPIM, CEAF)	Listas oficiais brasileiras
Enriquecimento CNPJ	Perfil cadastral e QSA
Processos por CNPJ	Exposição judicial

---

Perguntas frequentes

O que é cobrado?

Cada linha do Dataset = um CNPJ com pelo menos um perfil de marca. Inválidos e empresas sem reputação não são cobrados.

Vem o texto de cada reclamação?

Não. Vêm notas, totais e taxas agregados por marca/fonte.

O que maxBrands faz?

Limita quantos itens entram em marcas[]. totalMarcas continua sendo o total na origem.

Quando ligar includeHistory?

Só se precisar da série histórica por marca. O padrão false é mais rápido.

Quais formatos de CNPJ são aceitos?

Qualquer formato. Duplicatas entram uma vez. Máx. 100 por execução.