PEP, sanções e compliance

Reputação no Reclame Aqui

O serviço de Reputação no Reclame Aqui retorna a reputação pública de uma empresa a partir do CNPJ: score (0 a 10), categoria/segmento, volume de reclamações recebidas/respondidas e tempo médio de resposta.

Quando usar

Descrição

O serviço de Reputação no Reclame Aqui consulta a página pública da empresa no Reclame Aqui a partir do CNPJ e retorna a reputação do período mais recente disponível (padrão: últimos 6 meses), incluindo score, selo (ex.: RA1000, GREAT, GOOD, REGULAR, BAD, NOT_RECOMMENDED), percentual de reclamações resolvidas e respondidas, tempo médio de resposta e volume total de reclamações recebidas.

Quando o CNPJ não está diretamente cadastrado para a empresa no Reclame Aqui, a consulta é repetida com a razão social da empresa, e só é aceita a empresa cuja página no Reclame Aqui declara o CNPJ consultado. A resposta identifica como a correspondência foi feita (cadastro direto, confirmação pela página da empresa, relevância de busca, ou inferência a partir de reclamações que citam o CNPJ) — a confiança de cada tipo de correspondência deve ser avaliada por quem consumir o dado.

Requisição

Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.

POST /api/v1/{tenant}/empresas/reputacao-no-reclame-aqui

CampoObrigatórioDescrição
document sim CNPJ da empresa, com ou sem máscara.
{
  "document": "00.000.000/0000-00"
}

Campos de retorno

Campos dentro de data. [] indica lista.

CampoTipo
cnpj texto
found booleano
company.name texto
company.shortname texto
company.company_id texto
company.status texto
company.category.segment texto
company.category.main_segment texto
company.category.segment_shortname texto
company.category.segment_rank número
company.cnpj_on_page texto
company.cnpj_verified_by_ra booleano
reputation.score número
reputation.status texto
reputation.solved_rate número
reputation.response_rate número
reputation.would_deal_again_rate número
reputation.avg_response_time texto
reputation.avg_response_time_hours número
reputation.consumer_score número
reputation.total_complaints número
reputation.total_answers número
reputation.total_ratings número
reputation.awaiting_answer número
reputation.period.type texto
reputation.period.start data
reputation.period.end data
match texto
verification.cnpj_on_page texto
verification.matches booleano
verification.verified_by_ra booleano
inference texto
complaints.total_all_time número
complaints.total_in_period número
complaints.period.type texto
complaints.period.start data
complaints.period.end data
complaints.last[].id texto
complaints.last[].created_at data
complaints.last[].title texto
complaints.last[].status texto
complaints.last[].solved booleano
complaints.last[].evaluated booleano
complaints.last[].url texto
complaints.last[].text texto
complaints.pending[].id texto
complaints.pending[].created_at data
complaints.pending[].title texto
complaints.pending[].status texto
complaints.pending[].solved booleano
complaints.pending[].evaluated booleano
complaints.pending[].url texto
complaints.pending[].text texto
complaints.by_category[].name texto
complaints.by_category[].count número
complaints.by_category[].share_of_complaints texto
complaints.by_problem[].name texto
complaints.by_problem[].count número
complaints.by_problem[].share_of_complaints texto
complaints.by_product[].name texto
complaints.by_product[].count número
complaints.by_product[].share_of_complaints texto
other_companies[].name texto
other_companies[].shortname texto
source texto
collected_at data
cached booleano

Exemplo de resposta

Estrutura real da resposta, com valores fictícios.

{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Reputação no Reclame Aqui",
  "query_slug": "reputacao-no-reclame-aqui",
  "data": {
    "cnpj": "texto",
    "found": false,
    "company": {
      "name": "texto",
      "shortname": "texto",
      "company_id": "texto",
      "status": "texto",
      "category": {
        "segment": "texto",
        "main_segment": "texto",
        "segment_shortname": "texto",
        "segment_rank": 0
      },
      "cnpj_on_page": "texto",
      "cnpj_verified_by_ra": false
    },
    "reputation": {
      "score": 0,
      "status": "texto",
      "solved_rate": 0,
      "response_rate": 0,
      "would_deal_again_rate": 0,
      "avg_response_time": "texto",
      "avg_response_time_hours": 0,
      "consumer_score": 0,
      "total_complaints": 0,
      "total_answers": 0,
      "total_ratings": 0,
      "awaiting_answer": 0,
      "period": {
        "type": "texto",
        "start": "2026-01-01",
        "end": "2026-01-01"
      }
    },
    "match": "texto",
    "verification": {
      "cnpj_on_page": "texto",
      "matches": false,
      "verified_by_ra": false
    },
    "inference": null,
    "complaints": {
      "total_all_time": 0,
      "total_in_period": 0,
      "period": {
        "type": "texto",
        "start": "2026-01-01",
        "end": "2026-01-01"
      },
      "last": [
        {
          "id": "texto",
          "created_at": "2026-01-01",
          "title": "texto",
          "status": "texto",
          "solved": false,
          "evaluated": false,
          "url": "texto",
          "text": "texto"
        }
      ],
      "pending": [
        {
          "id": "texto",
          "created_at": "2026-01-01",
          "title": "texto",
          "status": "texto",
          "solved": false,
          "evaluated": false,
          "url": "texto",
          "text": "texto"
        }
      ],
      "by_category": [
        {
          "name": "texto",
          "count": 0,
          "share_of_complaints": null
        }
      ],
      "by_problem": [
        {
          "name": "texto",
          "count": 0,
          "share_of_complaints": null
        }
      ],
      "by_product": [
        {
          "name": "texto",
          "count": 0,
          "share_of_complaints": null
        }
      ]
    },
    "other_companies": [
      {
        "name": "texto",
        "shortname": "texto"
      }
    ],
    "source": "texto",
    "collected_at": "2026-01-01",
    "cached": false
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.540"
}

Cobrança e respostas

  • O valor é cobrado por consulta bem-sucedida.
  • 200 — consulta processada (veja status no corpo da resposta)
  • 401 — token ausente, inválido, inativo ou expirado
  • 403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
  • 422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
  • 429 — limite de requisições por minuto da chave excedido
  • 504 — tempo máximo de execução do serviço excedido