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

O que faz o API de Reputação de Empresas por CNPJ?

Consulte notas, reclamações, marcas vinculadas e indicadores de atendimento de empresas brasileiras em uma única execução. Informe uma lista de CNPJs e receba uma linha estruturada por empresa com reputação encontrada, incluindo médias de 90 e 365 dias, melhor nota, datas de avaliação e métricas detalhadas por marca ou plataforma.

O Actor é útil para homologação de fornecedores, qualificação de leads, análise KYB, due diligence comercial e monitoramento de sinais de experiência do consumidor. Os dados são agregados: o resultado não inclui o texto integral de reclamações. Valores sem resultado e empresas sem perfis de reputação ficam fora do Dataset e não geram linha de resultado. Duplicatas são consultadas uma única vez após a normalização.

O limite de processamento é de 100 CNPJs por execução. Se forem enviados mais itens, os primeiros 100 serão processados e o Actor continuará com sucesso, registrando um aviso. Cada linha entregue no Dataset representa um CNPJ com pelo menos uma marca ou plataforma encontrada.

Por que usar o API de Reputação de Empresas por CNPJ?

• ⭐ Visão rápida de reputação: compare notas recentes e anuais sem analisar fontes separadamente.
• 🏢 Homologação de fornecedores: identifique sinais de satisfação, resposta e resolução antes de contratar.
• 🎯 Qualificação de leads: combine reputação com dados cadastrais e priorize empresas com melhor contexto comercial.
• 🔎 Due diligence: veja marcas vinculadas, volume de reclamações e evolução histórica quando necessário.
• 📊 Indicadores por marca: avalie notas da plataforma, nota dos consumidores, taxa de resposta, taxa de resolução e intenção de voltar a negociar.
• 🔗 Fluxos combinados: use o resultado junto com KYC por CNPJ, sanções e dados cadastrais.

O retorno é JSON estruturado no Dataset padrão e pode ser exportado nos formatos disponíveis no Console, como JSON, CSV e Excel. A integração também pode ser feita por API para alimentar sistemas internos, pipelines de análise ou rotinas de enriquecimento.

Como usar o API de Reputação de Empresas por CNPJ

1. Abra o Actor no Console da Apify e acesse a aba Input.
2. Informe um ou mais valores no campo cnpjs. Cada valor passa apenas por trim() e remoção de . e -, sem validação local de formato ou dígito verificador.
3. Defina maxBrands para limitar a quantidade de perfis retornados por CNPJ. O padrão é 30. Valores inválidos ou sem reputação são ignorados com aviso, sem abortar a execução.
4. Ative includeHistory somente quando precisar dos snapshots históricos de cada marca.
5. Clique em Start e aguarde a conclusão.
6. Abra a aba Dataset para consultar ou exportar as linhas entregues.

Exemplo de entrada:

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

Para uma integração via API, use o endpoint de execução síncrona:

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

Input

A aba Input define os parâmetros da consulta. cnpjs é obrigatório. O Actor aplica apenas trim() e remove . e -, depois elimina duplicatas. Não há validação local de formato ou dígito verificador. Valores vazios, não textuais ou rejeitados pela consulta são ignorados com aviso, sem abortar a execução. Até 100 valores são processados por execução; quando a lista é maior, os itens excedentes não são consultados.

Campo	Obrigatório	Padrão	Limites	Descrição
cnpjs	Sim	Exemplo no formulário	1 a 100 processados	Lista de valores de CNPJ. Cada valor passa por trim() e remoção de . e -; duplicatas normalizadas são consultadas uma vez.
maxBrands	Não	30	0 a 50	Máximo de perfis de marca retornados por CNPJ. 0 mantém todos os perfis encontrados.
includeHistory	Não	false	Booleano	Inclui snapshots históricos de avaliações por marca. Pode aumentar o tamanho do resultado.

O valor de totalMarcas informa o total encontrado na fonte, enquanto marcas respeita o limite de maxBrands. Assim, é possível usar uma resposta compacta sem perder a indicação do total de perfis relacionados.

Output

A aba Output contém um link para o Dataset padrão. Cada item do Dataset é uma linha de reputação de um CNPJ que possui pelo menos um perfil encontrado. Empresas sem reputação não geram item. A cobrança, quando aplicável ao plano do Actor, considera apenas linhas entregues, não consultas sem resultado.

Exemplo de saída:

{
  "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",
  "reputationSummaryByDataSources": {
    "Reclame Aqui|Nubank": "8.5"
  },
  "totalMarcas": 1,
  "marcas": [
    {
      "nome": "Empresa exemplo",
      "descricao": null,
      "categorias": null,
      "fonte": "Plataforma de avaliações",
      "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
    }
  ]
}

Campos retornados

Campo	Tipo	Descrição
cnpj	string	Valor normalizado após trim e remoção de . e -.
cnpjFormatado	string	Mesmo valor normalizado usado na consulta.
notaUnificada90Dias	number ou null	Média unificada dos últimos 90 dias.
notaUnificada90DiasDescricao	string ou null	Classificação da média de 90 dias.
notaUnificada365Dias	number ou null	Média unificada dos últimos 365 dias.
notaUnificada365DiasDescricao	string ou null	Classificação da média de 365 dias.
primeiraAvaliacaoEm	string ou null	Data da primeira avaliação disponível, em dd/mm/aaaa.
ultimaAvaliacaoEm	string ou null	Data da avaliação mais recente, em dd/mm/aaaa.
melhorNota	number ou null	Maior nota entre os perfis vinculados.
melhorNotaDescricao	string ou null	Classificação da melhor nota.
reputationSummaryByDataSources	object	Resumo da reputação por fonte e perfil, com a chave original e a nota retornada.
totalMarcas	integer	Total de perfis de marca ou plataforma encontrados.
marcas	array	Perfis retornados, limitado por maxBrands.
marcas[].nome	string	Nome do perfil.
marcas[].descricao	string ou null	Descrição do perfil, quando disponível.
marcas[].categorias	string ou null	Categorias associadas ao perfil.
marcas[].fonte	string	Plataforma ou fonte do perfil.
marcas[].notaFonte	number ou null	Nota atribuída pela plataforma.
marcas[].notaFonteDescricao	string ou null	Classificação da nota da plataforma.
marcas[].notaConsumidor	number ou null	Nota atribuída pelos consumidores.
marcas[].notaConsumidorDescricao	string ou null	Classificação da nota dos consumidores.
marcas[].totalReclamacoes	integer	Total de reclamações registradas.
marcas[].totalRespondidas	integer	Reclamações respondidas.
marcas[].totalNaoRespondidas	integer	Reclamações não respondidas.
marcas[].percentualRespondido	number	Percentual respondido, de 0 a 100.
marcas[].percentualResolvido	number	Percentual resolvido, de 0 a 100.
marcas[].percentualNaoResolvido	number	Percentual não resolvido, de 0 a 100.
marcas[].percentualVoltariaNegociar	number	Percentual que voltaria a negociar, de 0 a 100.
marcas[].tempoMedioRespostaHoras	number ou null	Tempo médio de resposta em horas.
marcas[].categoriasReclamacoes	objeto ou null	Contagem de categorias da avaliação mais recente.
marcas[].historicoAvaliacoes	array opcional	Snapshots históricos quando includeHistory está ativo.
marcas[].historicoAvaliacoes[].data	string	Data do snapshot.
marcas[].historicoAvaliacoes[].categorias	objeto	Notas ou categorias registradas no snapshot.

Tips / Dicas

• 🚀 Para respostas menores e mais rápidas, mantenha includeHistory como false.
• 📦 Use maxBrands entre 5 e 30 quando precisar apenas dos principais perfis.
• 🧹 Envie CNPJs normalizados ou com máscara, mas remova duplicatas antes da chamada quando isso for possível.
• 🧾 Para processar mais de 100 empresas, divida a lista em execuções separadas e controle a consolidação pelo seu sistema.
• 🔍 Verifique totalMarcas antes de interpretar uma lista vazia: maxBrands igual a zero e uma resposta sem perfis têm significados diferentes.
• 📈 Use as notas de 90 dias para sinais recentes e as de 365 dias para uma leitura mais estável.
• ⚠️ Um CNPJ sem perfil não significa necessariamente que a empresa não exista. Significa apenas que não foi encontrada reputação compatível para a consulta.

FAQ, avisos e suporte

O que representa cada linha do Dataset?

Cada linha representa um valor consultado com pelo menos uma marca ou plataforma de reputação encontrada. Duplicatas normalizadas e empresas sem perfil não geram linha.

O texto das reclamações é retornado?

Não. O Actor retorna indicadores agregados, notas, totais, percentuais e, opcionalmente, snapshots históricos por marca.

Há validação local de CNPJ?

Não. O Actor apenas aplica trim() e remove . e -; letras, barras, zeros à esquerda e outros caracteres são preservados. Se a consulta rejeitar um valor, ele é ignorado com aviso e os demais continuam sendo processados.

Posso consultar uma lista maior que 100 CNPJs?

Sim, mas somente os primeiros 100 são processados em cada execução. Para listas maiores, divida a entrada em lotes.

Os dados podem ser usados para decisões automatizadas?

Use os indicadores como apoio à análise. Verifique contexto, atualidade e finalidade do uso antes de tomar decisões comerciais, de crédito, contratação ou relacionamento com consumidores. Você é responsável por cumprir a legislação aplicável e as regras de proteção de dados.

Onde pedir ajuda?

Use a aba Issues do Actor para relatar problemas com uma execução. Para projetos que exigem integração, campos adicionais ou fluxo sob medida, consulte a equipe BrasilDados em brasildados.org.

Outros Actors do BrasilDados

Actor	Quando usar
KYC Compliance PEP por CNPJ	Consultar PEP, sanções e indicadores de compliance.
Enriquecimento de empresas por CNPJ	Obter dados cadastrais, atividade e informações societárias.
Processos judiciais por CNPJ	Avaliar exposição judicial e processos associados à empresa.

🛒 Todos os Actors: apify.com/brasildados

📧 contato@brasildados.org · 🌐 brasildados.org · 🛒 BrasilDados na Apify Store