Brazil Company Reputation Checker / Verificador de Reputação de Empresas Brasileiras

🇧🇷 Versão em Português abaixo 🇧🇷

---

What does this actor do?

This actor retrieves company reputation data from Reclame Aqui and other Brazilian review platforms using only a CNPJ (Brazilian company registration number). No need to know the company's Reclame Aqui profile slug or URL.

For each CNPJ, you get:

• Unified reputation scores (overall, last 90 days, last 365 days) on a 0-10 scale
• Rating classifications: OTIMO, BOM, REGULAR, RUIM, NAO RECOMENDADO, or RA1000
• Complaint volume with time breakdowns (30, 90, 180, 365 days)
• Brand-level details: every brand profile linked to the CNPJ, with individual scores, response rates, resolution rates, average response time, and complaint category breakdowns
• Consumer sentiment: percentage of consumers who would do business again

Use cases

• Due diligence: Evaluate supplier or partner reputation before signing contracts
• Competitive intelligence: Monitor competitors' customer satisfaction trends
• Lead qualification: Score leads by their public reputation before outreach
• Risk assessment: Flag companies with declining reputation scores
• Market research: Compare reputation across companies in a sector
• Compliance: Automated reputation monitoring for regulated industries

Input

Field	Type	Required	Description
cnpjs	string[]	Yes	List of CNPJs to check. Accepts formatted (07.526.557/0001-00) or digits only (07526557000100). Max 100 per run.
maxBrands	integer	No	Limit brand profiles per CNPJ. Default 0 = all brands. Large companies like Ambev may have 10+ brands.

Example input

{
  "cnpjs": [
    "07526557000100",
    "47.960.950/0001-21"
  ],
  "maxBrands": 5
}

Output

Each CNPJ produces one record in the dataset. Here's a real example (Ambev S.A.):

{
  "cnpj": "07526557000100",
  "cnpjFormatado": "07.526.557/0001-00",
  "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": "Budweiser",
      "descricao": "Budweiser e a cerveja mais iconica do mundo...",
      "categorias": "Alimentos, Bebidas",
      "fonte": "Reclame Aqui",
      "notaFonte": 8.6,
      "notaFonteDescricao": "OTIMO",
      "notaConsumidor": 3.52,
      "notaConsumidorDescricao": "REGULAR",
      "totalReclamacoes": 1247,
      "totalRespondidas": 1198,
      "totalNaoRespondidas": 49,
      "percentualRespondido": 96.07,
      "percentualResolvido": 83.4,
      "percentualNaoResolvido": 16.6,
      "percentualVoltariaNegociar": 66.19,
      "tempoMedioRespostaHoras": 47.52,
      "categoriasReclamacoes": {
        "Produto com problema": 312,
        "Propaganda Enganosa": 186,
        "Demora na entrega": 98
      }
    }
  ]
}

When a CNPJ has no reputation data

{
  "cnpj": "00000000000191",
  "cnpjFormatado": "00.000.000/0001-91",
  "notaUnificada90Dias": null,
  "notaUnificada90DiasDescricao": null,
  "notaUnificada365Dias": null,
  "notaUnificada365DiasDescricao": null,
  "primeiraAvaliacaoEm": null,
  "ultimaAvaliacaoEm": null,
  "melhorNota": null,
  "melhorNotaDescricao": null,
  "totalMarcas": 0,
  "marcas": []
}

Output fields reference

Field	Type	Description
cnpj	string	CNPJ digits only
cnpjFormatado	string	CNPJ with mask XX.XXX.XXX/XXXX-XX
notaUnificada90Dias	number|null	Unified reputation score last 90 days (0-10)
notaUnificada90DiasDescricao	string|null	Rating: OTIMO, BOM, REGULAR, RUIM, NAO RECOMENDADO, RA1000
notaUnificada365Dias	number|null	Unified reputation score last 365 days (0-10)
notaUnificada365DiasDescricao	string|null	Rating label last 365 days
primeiraAvaliacaoEm	string|null	First review date (dd/mm/yyyy)
ultimaAvaliacaoEm	string|null	Last review date (dd/mm/yyyy)
melhorNota	number|null	Best score across all brand profiles
melhorNotaDescricao	string|null	Rating label for the best score
totalMarcas	integer	Number of brand profiles linked to this CNPJ
marcas	array	Brand-level details (see below)

Brand fields (marcas[]):

Field	Type	Description
nome	string	Brand name
descricao	string|null	Description
categorias	string|null	Business categories
fonte	string	Data source (e.g. "Reclame Aqui")
notaFonte	number|null	Platform score (0-10)
notaFonteDescricao	string|null	Platform rating label
notaConsumidor	number|null	Consumer score (0-10)
notaConsumidorDescricao	string|null	Consumer rating label
totalReclamacoes	integer	Total complaints
totalRespondidas	integer	Answered complaints
totalNaoRespondidas	integer	Unanswered complaints
percentualRespondido	number	Answer rate %
percentualResolvido	number	Resolution rate %
percentualNaoResolvido	number	Unresolved rate %
percentualVoltariaNegociar	number	Would do business again %
tempoMedioRespostaHoras	number|null	Avg response time in hours
categoriasReclamacoes	object|null	Complaint categories breakdown

Pricing

This actor uses pay-per-event pricing. You are charged per CNPJ queried:

Event	Price
cnpj-reputation	$0.10 per CNPJ

For example, querying 100 CNPJs costs $10.00. If your budget limit is reached mid-run, the actor stops gracefully and returns the results collected so far.

How it works

1. Validates each CNPJ (format and check digits)
2. Queries a professional data provider API for reputation and review data
3. Transforms raw data into a clean, structured format with Portuguese field names
4. Translates rating descriptions to Portuguese (GREAT -> OTIMO, GOOD -> BOM, etc.)
5. Returns one record per CNPJ in the dataset

Invalid CNPJs are skipped with a warning. If a CNPJ query fails after retries, an error entry is pushed to the dataset so you know exactly which ones failed.

Tips

• Large companies (e.g. Ambev, Petrobras) may have 10-20+ brand profiles linked to a single CNPJ. Use maxBrands to limit output size if you only need the top brands.
• New or small companies may have possuiDados: false if they have no Reclame Aqui presence.
• Batch processing: You can query up to 100 CNPJs per run. For larger volumes, schedule multiple runs.
• Integrations: Export results as JSON, CSV, or Excel from the Apify dataset, or use the Apify API to integrate directly with your systems.

FAQ

Q: Do I need a Reclame Aqui account? No. This actor uses an aggregated data source. You only need the company's CNPJ.

Q: How fresh is the data? Data is updated regularly by the data provider. The ultimaAvaliacaoEm field shows the date of the most recent review.

Q: What if a CNPJ has no reputation data? The actor returns a record with possuiDados: false and all scores set to null. You are still charged for the query.

Q: Can I use CPF instead of CNPJ? No. This actor only supports CNPJ (14-digit company registration numbers).

---

Versão em Português

O que este actor faz?

Este actor consulta dados de reputação de empresas no Reclame Aqui e outras plataformas de avaliação brasileiras usando apenas o CNPJ. Não é necessário conhecer o slug ou URL do perfil da empresa no Reclame Aqui.

Para cada CNPJ, você recebe:

• Notas de reputação unificadas (geral, últimos 90 dias, últimos 365 dias) na escala 0-10
• Classificações: OTIMO, BOM, REGULAR, RUIM, NAO RECOMENDADO ou RA1000
• Volume de reclamações com recortes temporais (30, 90, 180, 365 dias)
• Detalhes por marca: cada perfil de marca vinculado ao CNPJ, com notas individuais, taxas de resposta, taxas de resolução, tempo médio de resposta e distribuição de categorias de reclamações
• Sentimento do consumidor: percentual de consumidores que voltariam a negociar

Casos de uso

• Due diligence: Avaliar reputação de fornecedores ou parceiros antes de fechar contratos
• Inteligência competitiva: Monitorar tendências de satisfação do cliente dos concorrentes
• Qualificação de leads: Pontuar leads pela reputação pública antes do contato
• Avaliação de risco: Identificar empresas com notas de reputação em queda
• Pesquisa de mercado: Comparar reputação entre empresas de um setor
• Compliance: Monitoramento automatizado de reputação para indústrias reguladas

Entrada

Campo	Tipo	Obrigatório	Descrição
cnpjs	string[]	Sim	Lista de CNPJs. Aceita formatado (07.526.557/0001-00) ou somente dígitos (07526557000100). Máximo 100 por execução.
maxBrands	integer	Não	Limite de marcas por CNPJ. Padrão 0 = todas as marcas. Grandes empresas como Ambev podem ter 10+ marcas.

Exemplo de entrada

{
  "cnpjs": [
    "07526557000100",
    "47.960.950/0001-21"
  ],
  "maxBrands": 5
}

Preços

Este actor usa cobrança pay-per-event. Você é cobrado por CNPJ consultado:

Evento	Preço
cnpj-reputation	US$ 0,10 por CNPJ

Exemplo: consultar 100 CNPJs custa US$ 10,00. Se o limite do seu orçamento for atingido durante a execução, o actor para e retorna os resultados coletados até o momento.

Como funciona

1. Valida cada CNPJ (formato e dígitos verificadores)
2. Consulta uma API profissional de dados para obter reputação e avaliações
3. Transforma os dados brutos em formato limpo e estruturado com nomes de campos em português
4. Traduz as descrições de classificação para português (GREAT -> OTIMO, GOOD -> BOM, etc.)
5. Retorna um registro por CNPJ no dataset

CNPJs inválidos são ignorados com aviso. Se a consulta de um CNPJ falhar após tentativas, um registro de erro é incluído no dataset para que você saiba exatamente quais falharam.

Dicas

• Grandes empresas (ex: Ambev, Petrobras) podem ter 10-20+ perfis de marca vinculados a um único CNPJ. Use maxBrands para limitar o tamanho da saída se precisar apenas das principais marcas.
• Empresas novas ou pequenas podem retornar possuiDados: false se não tiverem presença no Reclame Aqui.
• Processamento em lote: Você pode consultar até 100 CNPJs por execução. Para volumes maiores, agende múltiplas execuções.
• Integrações: Exporte resultados como JSON, CSV ou Excel do dataset Apify, ou use a API do Apify para integrar diretamente com seus sistemas.

Perguntas frequentes

P: Preciso de uma conta no Reclame Aqui? Não. Este actor usa uma fonte de dados agregada. Você só precisa do CNPJ da empresa.

P: Quão atualizados são os dados? Os dados são atualizados regularmente pelo provedor de dados. O campo ultimaAvaliacaoEm mostra a data da avaliação mais recente.

P: E se um CNPJ não tiver dados de reputação? O actor retorna um registro com possuiDados: false e todas as notas como null. A consulta ainda é cobrada.

P: Posso usar CPF em vez de CNPJ? Não. Este actor suporta apenas CNPJ (números de registro de empresa com 14 dígitos).

---

Built by BrasilDados