# Reclame Aqui Scraper: Reputation & Complaints (`allanmxr/reclame-aqui-scraper`) Actor

Reputation and complaints from Reclame Aqui (Brazil) in one flat dataset: score, solution rate, would do business again, response time, RA1000, plus complaint title, text, status, date, category, city/UF. Compare many companies or a category ranking. No consumer identification.

- **URL**: https://apify.com/allanmxr/reclame-aqui-scraper.md
- **Developed by:** [Allan Marcelino](https://apify.com/allanmxr) (community)
- **Categories:** Business, Lead generation, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Reclame Aqui Scraper: Company Reputation and Complaints (Brazil)

Scrape **company reputation and consumer complaints from Reclame Aqui**, Brazil's largest complaint and reputation site. You can compare many companies, or a whole category ranking, in one run. The output is one flat dataset.

**Em português:** extraia a **reputação de empresas no Reclame Aqui**: nota, índice de solução, "voltaria a fazer negócio", taxa de resposta, tempo médio de resposta e selo RA1000, por período (6 meses, 12 meses, ano passado, geral). Também extrai as **reclamações** com título, texto, status (não respondida, respondida, resolvida, não resolvida), data, categoria, produto, problema e cidade/UF. Você pode comparar várias empresas numa execução ou puxar o **ranking das melhores e piores empresas** de um segmento. Exemplos: *reclamações do Nubank no Reclame Aqui*, *reputação Mercado Livre Reclame Aqui*, *ranking piores bancos Reclame Aqui*, *reclamações não respondidas Magazine Luiza*. Nenhum campo de identificação do consumidor (nome, e-mail, telefone, CPF) é coletado.

You type company names, Reclame Aqui shortnames or page URLs, and pick filters for status, period and consumer state. You get two kinds of records in the same dataset:

- `recordType: "company"`: the reputation panel of a company for one period.
- `recordType: "complaint"`: one complaint.

No login or API key is needed.

### Why this scraper

- **Compare companies in one run.** List 2 or 200 companies and get their reputation side by side: score, solution rate, would-do-business-again, response rate, average response time in hours, RA1000 status, total and unanswered complaints.
- **Category rankings.** Give a segment such as `varejo/marketplaces` or `bancos-e-financeiras/bancos-tradicionais-e-digitais` and get the best or worst companies of that ranking, with their position, reputation and complaints.
- **Five reputation periods.** Last 6 months, last 12 months, last calendar year, the year before, and overall. Each one is a separate record, ready for trend charts.
- **Status filter on Reclame Aqui itself.** Collect only not-answered, answered, resolved or not-resolved complaints. Only what you asked for is fetched and charged.
- **Past the 500 limit of the site.** Reclame Aqui shows only 500 complaints per list. When you ask for more, the Actor splits the search on the site's own filters (status, consumer state, problem, product and category) and collects each part, so one company can return tens of thousands of complaints with no duplicates.
- **Period and state filters.** Use `dateFrom` and `dateTo` for complaints created in a window, and pick consumer states (UF), filtered on Reclame Aqui itself.
- **Full complaint text** and the consumer's final evaluation, rating and "would do business again" answer, with category, product and problem names.
- **Privacy by design (LGPD).** Consumer identification fields (name, e-mail, phone, CPF) are never collected. The complaint text is the public text Reclame Aqui already masks, and this Actor adds best-effort masking of CPF, RG, e-mail, phone numbers, self-introductions ("meu nome é ...") and signatures left behind. Free text can still mention a name in an unusual way, so turn off `includeComplaintText` if you need titles only.
- **Low price per result**, with one simple event: every record is one result.

### Use cases

- **Brand monitoring and customer experience**: track new complaints, unanswered complaints and the evolution of your score.
- **Competitor benchmarking**: compare the reputation of every player in a segment.
- **Due diligence**: check suppliers, partners, e-commerce sellers or acquisition targets before signing.
- **Market research and NLP**: topic modelling, sentiment and root-cause analysis on complaint texts.
- **Lead generation for CX and SAC tools**: find companies with low response rates (company-level data only).

### Input

| Field | Description |
|---|---|
| `sources` | `companies` (the list below) and/or `categoryRanking`. The `maxItems` budget is shared equally; a source that runs dry hands its share to the other. |
| `companies` | One per line: a name (`Magazine Luiza`), a shortname (`magazine-luiza-loja-online`) or a URL (`https://www.reclameaqui.com.br/empresa/nubank/`). A name takes the first match of the Reclame Aqui search, so paste the URL when the name is ambiguous. |
| `rankingCategories` | Segment slugs `main/secondary` or the segment URL `https://www.reclameaqui.com.br/segmentos/varejo/marketplaces/`. Browse them at reclameaqui.com.br/segmentos. |
| `rankingType` | `best`, `worst` or `both`. |
| `rankingMaxCompanies` | Companies taken from the top of each ranking list (1 to 100). |
| `includeReputation` | One company record per period (default on). |
| `reputationPeriods` | `sixMonths`, `twelveMonths`, `lastYear`, `yearBeforeLast`, `overall`. |
| `maxComplaintsPerCompany` | Complaints per company, 0 to 50000 (0 = reputation only). Up to 500 they are the newest overall. Above 500 the search is split by status, state and problem/product/category, and the quota is shared fairly between the parts (newest first within each part). |
| `complaintStatus` | `not_answered`, `answered`, `resolved`, `not_resolved`. Empty means every status. The quota per company is split equally between the chosen statuses. |
| `dateFrom`, `dateTo` | Complaints created in this window (YYYY-MM-DD). |
| `consumerStates` | Consumer states (UF), for example `SP`, `RJ`. Filtered on Reclame Aqui itself. |
| `includeComplaintText` | Full text and the final evaluation (default on). Turn it off to keep titles only. |
| `maxItems` | Total records, company and complaint records together. |
| `proxyConfiguration` | Optional. By default the Actor starts direct and climbs to Apify Proxy only when Reclame Aqui blocks it. A proxy chosen here is used from the first request. |

Example: compare three banks on unanswered complaints from São Paulo in November.

```json
{
  "companies": ["nubank", "banco-inter", "https://www.reclameaqui.com.br/empresa/itau/"],
  "reputationPeriods": ["sixMonths", "twelveMonths"],
  "maxComplaintsPerCompany": 100,
  "complaintStatus": ["not_answered"],
  "dateFrom": "2026-11-01",
  "consumerStates": ["SP"]
}
```

### Output

Company record:

```json
{
  "recordType": "company",
  "companyId": "88850",
  "companyShortname": "nubank",
  "companyName": "Nubank",
  "companyUrl": "https://www.reclameaqui.com.br/empresa/nubank/",
  "cnpj": "18236120000158",
  "mainSegment": "Bancos e Financeiras",
  "segment": "Bancos Tradicionais e Digitais",
  "reputationPeriod": "sixMonths",
  "periodStart": "2026-05-01",
  "periodEnd": "2026-10-31",
  "reputationStatus": "RA1000",
  "score": 8.8,
  "consumerScore": 7.81,
  "responseRate": 99.9,
  "solutionRate": 93.2,
  "dealAgainRate": 81.5,
  "avgResponseTimeHours": 94.5,
  "totalComplaints": 56842,
  "unansweredComplaints": 37,
  "complaintsLast30Days": 8900,
  "rankingType": null,
  "rankingPosition": null
}
```

Complaint record:

```json
{
  "recordType": "complaint",
  "complaintId": "B9RJH9knDV9KYYxD",
  "complaintUrl": "https://www.reclameaqui.com.br/nubank/...",
  "companyName": "Nubank",
  "title": "Caí em [Editado pelo Reclame Aqui] pelo WhatsApp e enviei mais de R$2000 via Pix",
  "text": "Ola, boa tarde! ...",
  "status": "not_answered",
  "isResolved": null,
  "wouldDoBusinessAgain": null,
  "consumerScore": null,
  "hasCompanyReply": false,
  "createdAt": "2026-11-18T21:52:39-03:00",
  "category": "Meios de pagamentos eletrônicos",
  "product": "Pagamentos eletrônicos",
  "problem": null,
  "consumerCity": "Cascavel",
  "consumerState": "CE"
}
```

The dataset has two table views, **Complaints** and **Company reputation**. Filter by `recordType` when you export.

### Limits of the source

- Reclame Aqui serves only **500 complaints per filtered list**. Splitting by status, state and the top problem, product and category values reaches far more (tens of thousands for the biggest companies), but not every complaint of a company with hundreds of thousands: complaints outside the top facet values stay out of reach. The run summary tells you when the limit was hit.
- The period filter runs on the newest complaints of each status (up to 2000 per company), because the site has no date filter. For very large companies (hundreds of complaints a day) a window more than a few days back can come out empty; the run summary says when.
- The company's reply to each complaint is not included.

### Pricing

Pay per result: one `result` event per record (company period or complaint). See the Pricing tab.

### FAQ

**Is it legal?** The Actor reads only public pages that anyone can open without logging in. It never collects consumer identification fields, and it masks personal data left in the public text on a best-effort basis. You remain responsible for how you use the data under LGPD and GDPR.

**Why are some numbers null?** Companies with too few complaints in a period have no index on Reclame Aqui (`NO_INDEX` or `NOT_RECOMMENDED`), and the site shows `--` there.

**A company was not found.** Paste its Reclame Aqui URL (`https://www.reclameaqui.com.br/empresa/<shortname>/`) instead of the name.

**Can I get every complaint of a big company?** No. See the limits of the source above.

### Run summary

Each run stores `RUN_SUMMARY` in the key-value store. It has the records per source, the companies not found or failed, the total of complaints on the site per company, and whether you asked for more than the site lets the Actor reach.

# Actor input Schema

## `sources` (type: `array`):

Companies: the companies you list below. Category ranking: the best or worst companies of a Reclame Aqui category. The record budget (Max items) is shared between them.

## `companies` (type: `array`):

One per line: company name (Nubank), Reclame Aqui shortname (nubank) or page URL (https://www.reclameaqui.com.br/empresa/nubank/). A name takes the first match of the Reclame Aqui search; paste the URL to be sure.

## `rankingCategories` (type: `array`):

One per line: category slugs main/secondary (varejo/marketplaces) or the category URL (https://www.reclameaqui.com.br/segmentos/varejo/marketplaces/). Browse them at reclameaqui.com.br/segmentos/.

## `rankingType` (type: `string`):

Best rated, worst rated or both lists of each category.

## `rankingMaxCompanies` (type: `integer`):

How many companies to take from the top of each ranking list.

## `includeReputation` (type: `boolean`):

One record per company and period with score, solution rate, would do business again, response rate, average response time and RA1000 status.

## `reputationPeriods` (type: `array`):

Periods of the reputation panel shown on Reclame Aqui. Each period is one record per company.

## `maxComplaintsPerCompany` (type: `integer`):

Complaints to collect per company, 0 for reputation only. Up to 500 they are the newest overall. Reclame Aqui serves only 500 per query, so past 500 the Actor splits the search by status, consumer state and problem/product/category on the site itself; very large companies reach tens of thousands, not every complaint.

## `complaintStatus` (type: `array`):

Leave empty for every status. The quota per company is split equally between the chosen statuses.

## `dateFrom` (type: `string`):

Only complaints created on or after this date (YYYY-MM-DD).

## `dateTo` (type: `string`):

Only complaints created on or before this date (YYYY-MM-DD).

## `consumerStates` (type: `array`):

Only complaints from consumers in these states, filtered on Reclame Aqui itself. Leave empty for all.

## `includeComplaintText` (type: `boolean`):

Full complaint text and the consumer's final evaluation. Identification fields are never collected; the free text is the public text already masked by Reclame Aqui, plus best-effort masking of CPF, RG, e-mail, phone, self-introductions and signatures. Turn off to keep titles only.

## `maxItems` (type: `integer`):

Maximum records in total (company and complaint records together). Each record is one charged result.

## `proxyConfiguration` (type: `object`):

Optional. Leave empty and the Actor connects directly, falling back to Apify Proxy (datacenter, then residential Brazil) only when Reclame Aqui blocks it. A proxy chosen here is used from the first request.

## Actor input object example

```json
{
  "sources": [
    "companies"
  ],
  "companies": [
    "nubank",
    "mercado-livre"
  ],
  "rankingType": "best",
  "rankingMaxCompanies": 10,
  "includeReputation": true,
  "reputationPeriods": [
    "sixMonths"
  ],
  "maxComplaintsPerCompany": 10,
  "complaintStatus": [],
  "consumerStates": [],
  "includeComplaintText": true,
  "maxItems": 30
}
```

# Actor output Schema

## `complaints` (type: `string`):

Complaint records (recordType complaint).

## `companies` (type: `string`):

Company reputation records (recordType company), one per period.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "sources": [
        "companies"
    ],
    "companies": [
        "nubank",
        "mercado-livre"
    ],
    "reputationPeriods": [
        "sixMonths"
    ],
    "maxComplaintsPerCompany": 10,
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("allanmxr/reclame-aqui-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "sources": ["companies"],
    "companies": [
        "nubank",
        "mercado-livre",
    ],
    "reputationPeriods": ["sixMonths"],
    "maxComplaintsPerCompany": 10,
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("allanmxr/reclame-aqui-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "sources": [
    "companies"
  ],
  "companies": [
    "nubank",
    "mercado-livre"
  ],
  "reputationPeriods": [
    "sixMonths"
  ],
  "maxComplaintsPerCompany": 10,
  "maxItems": 30
}' |
apify call allanmxr/reclame-aqui-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,allanmxr/reclame-aqui-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/4gK6GsBxT2eRY0fYK/builds/XpvIfJmZQJwd8Xlac/openapi.json
