# Trustpilot Reviews Scraper | Business Data (`datascraperes/trustpilot-reviews-scraper`) Actor

Scrape Trustpilot reviews, ratings, dates and company replies. Export business profiles, discover companies by category, and collect transparency reports. Filter reviews by language, stars and date, with deduplicated results and coverage summaries.

- **URL**: https://apify.com/datascraperes/trustpilot-reviews-scraper.md
- **Developed by:** [DataScraperES](https://apify.com/datascraperes) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 94.1% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.38 / 1,000 data results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

Collect **structured Trustpilot reviews and business intelligence** from Trustpilot. Enter company domains or business IDs to export review text, ratings, replies and business context, or choose a discovery/report mode.

**No fixed 200-review cap.** Set **Maximum results** (`maxItems`) above 200 to request larger review exports. Collection still depends on the available source records, your selected filters and your result cap.

### What this Actor does

Reviews mode follows the available listings for each selected star rating and checks completed listings against the source totals. The Actor also offers business profiles, business and category search, category companies, category trees, featured categories, similar companies, transparency, review statistics and locations.

Each Dataset record has a `recordType`, stable `id` and `scrapedAt` timestamp. Reviews include their company context and public reviewer information when available. The Actor does not visit company websites or extract email addresses.

### Use cases

- Export review text and replies for customer-feedback analysis.
- Compare company ratings and review distributions.
- Discover businesses in a category and country.
- Collect transparency and location reports for business research.

### How to use

1. Keep **Reviews** and enter a domain such as `pccomponentes.com` or a Trustpilot company URL.
2. Set **Maximum results**. Open **Optional review filters** only if you need a language, star-rating or date filter. **Optional discovery settings** are for search and category modes.
3. Click **Start**, then open the Dataset and run summary.

The complete example below requests five reviews. Increasing `maxItems` allows collection to continue farther through the available listings.

### Input

```json
{
  "mode": "reviews",
  "businessUnits": [
    "pccomponentes.com"
  ],
  "maxItems": 5,
  "language": "all",
  "stars": [
    "1",
    "2",
    "3",
    "4",
    "5"
  ],
  "date": "all",
  "query": "",
  "searchLimit": 5,
  "categoryIds": [],
  "countryCode": "US"
}
```

| Field | Meaning and default |
|---|---|
| `mode` | Defaults to `reviews`. Also supports `businesses`, `search`, `searchCategories`, `categoryBusinesses`, `categories`, `featuredCategories`, `similar`, `transparency`, `statistics` and `locations`. |
| `businessUnits` | Required in reviews, profiles, similar companies and business-report modes. Up to 100 domains, business IDs or Trustpilot company URLs. Repeated business identities are merged. No target is added automatically. |
| `query` | Required in either search mode; at most 200 characters. Ignored in other modes. |
| `categoryIds` | Required for category companies. Optional in category-tree mode; without IDs, roots are discovered from featured categories. Up to 100 IDs. |
| `countryCode` | Category-company country, default `US`. Choose a suggested country or enter its two-letter code. Letter case and surrounding spaces are normalized. This does not filter reviewer country. |
| `language` | Review/statistics language, default `all`. Choose a suggested language or enter a two- or three-letter code. Letter case and surrounding spaces are normalized. |
| `stars` | Review ratings as strings: `"1"` through `"5"`. Defaults to all five. Ignored in other modes. |
| `date` | Review/statistics range: `all`, `last30days`, `last3months`, `last6months` or `last12months`. Default `all`. |
| `maxItems` | Global Dataset cap across all targets, default 100; maximum accepted value 100,000. Reaching it does not prove that all available source records were collected. |
| `searchLimit` | Requested ranked search results, default 10; allowed range 1–50. Search also respects `maxItems`. |

Business URLs are normalized into domains; they are not fetched. Domains must match the resolved business or one of its source-listed aliases. Use a business ID when a domain cannot be resolved exactly. Fields belonging to other modes are ignored, while their values must still be valid.

The form starts with three controls: collection mode, companies and maximum results. The two optional sections keep review filters separate from discovery settings. Country and language menus suggest readable choices and also accept custom codes.

If an input needs correction, the log identifies the field (and list entry when applicable) and explains what to enter. Input errors detected before collection create no result charges. A missing company/category confirmed during lookup is also reported as an input issue; valid results from other targets are preserved and billed normally. The run ends without an Actor error for these correctable cases, but the summary has `complete: false`, `inputIssues` and an `invalid_input` or `partial` status. It does not display `Completed` for an unfinished request. Source unavailability, unsupported source records and collection time or spending limits also produce a partial summary after saved results are checked. A run can therefore finish without an Actor error while collection remains incomplete. Uncertain storage or billing and internal faults remain errors.

Apify can reject schema-invalid requests before a run starts. In that case, correct the field indicated by the form or API response; there is no Actor run log yet.

### Output

The Dataset contains product records only. Review rows contain review text, dates, stars, verification fields, public reviewer details, company replies and business context. Business rows contain profile fields, review counts, categories, verification, and published phone/address information where available. Missing optional values remain `null`.

Category records describe one category. Transparency and statistics records hold the corresponding report objects. A locations record contains one business's location list and its declared count; an empty list is valid. Similar-company mode returns unique business profiles and can return no results.

This is the complete Dataset item from a successful run using the input above:

```json
{
  "recordType": "review",
  "id": "57a314df0000ff000977e4a9",
  "businessUnitId": "4c311b2b00006400050d5d4e",
  "businessName": "PcComponentes",
  "businessDomain": "pccomponentes.com",
  "businessWebsiteUrl": "https://pccomponentes.com",
  "businessCountryCode": "ES",
  "businessTrustScore": 4.1,
  "businessStars": 4,
  "businessVerified": false,
  "reviewId": "57a314df0000ff000977e4a9",
  "reviewUrl": "https://www.trustpilot.com/reviews/57a314df0000ff000977e4a9",
  "businessUrl": "https://www.trustpilot.com/review/pccomponentes.com",
  "stars": 1,
  "title": "Decepcionante Problemas sin solucionar desde hace 3 años.",
  "text": "Compré un ordenador PC COM (con ampliación de garantía 5 años) , desde el primer día los puertos USB 3.0 no funcionaban correctamente, se mandó a reparar y al poco volvían a fallar, recientemente he vuelto a solicitar reparación pero por ahora no tengo claro que sean capaz  de resover el problema. (que me parece sencillo, cambio de placa base)",
  "language": "es",
  "createdAt": "2016-08-04T10:11:43Z",
  "updatedAt": null,
  "experiencedAt": null,
  "isVerified": false,
  "reviewVerificationLevel": "",
  "source": "Trustpilot",
  "status": "active",
  "numberOfLikes": 4,
  "isLatestByConsumerOnBusinessUnit": true,
  "isLatestByConsumerOnLocation": false,
  "consumersReviewCountOnSameDomain": 1,
  "consumersReviewCountOnSameLocation": 0,
  "reviewerId": "56faeed20000ff000a12c8e7",
  "reviewerName": "cliente",
  "reviewerCountryCode": "ES",
  "reviewerImageUrl": null,
  "reviewerNumberOfReviews": 3,
  "reviewerVerified": false,
  "companyReplyText": "Buenos días, mi nombre es Maribel Gómez y te escribo desde PcComponentes. En primer lugar, lamentamos lo sucedido y te pedimos disculpas por las incidencias que comentas. ¿Podrías facilitarme el número de referencia que tengas? Gracias y un saludo.",
  "companyReplyCreatedAt": "2016-08-09T06:40:22Z",
  "companyReplyUpdatedAt": null,
  "scrapedAt": "2026-11-05T16:20:18.111302Z"
}
```

Use Overview for a compact table, Details for the full column layout, or All fields to inspect the returned records. Export records as JSON, CSV or Excel. The separate run summary reports delivered records, target outcomes, caps and review-coverage checks; it is not a billable Dataset record.

### Pricing

The billing contract is pay per event: one `data-result` event per unique product record successfully saved and verified in the Dataset. Reports with multiple nested entries count as one Dataset record. Empty searches, failed requests, discarded duplicates and run summaries do not create result events. There is no separate page or enrichment event.

The FREE-plan price is **$0.0005 per delivered result**, equivalent to **$0.50 per 1,000 results**. Paid plans receive the discounts shown below. Reviews count individually; the other supported product records use the same plan price. There is no separate run-start fee.

| Plan | Price per result | Equivalent per 1,000 results |
|---|---:|---:|
| FREE | $0.0005 | $0.50 |
| BRONZE | $0.00045 | $0.45 |
| SILVER | $0.0004 | $0.40 |
| GOLD | $0.000375 | $0.375 |
| PLATINUM | $0.000375 | $0.375 |
| DIAMOND | $0.000375 | $0.375 |

The actual charge is per delivered result. Check the **Pricing** tab for the current configuration.

### Related Actors

| Actor | Best for |
|---|---|
| [Google Maps Reviews Scraper | Ratings & Replies](https://apify.com/datascraperes/google-maps-reviews-scraper) | Collect reviews and owner replies for Google Maps business listings. |
| [Tripadvisor Reviews Scraper with Place Data](https://apify.com/datascraperes/tripadvisor-reviews-data-scraper) | Collect place-based reviews for hotels, restaurants and attractions. |

### Limits and data quality

There is **no fixed limit of 200 reviews per company**. Reviews are collected one star rating at a time, oldest first within each rating; the combined output is not globally chronological. Source availability, changes during collection and your global `maxItems` cap can prevent a full export. A verified exhausted listing is different from a run that stops at `maxItems`.

Review coverage is checked against completed partition totals and available language/rating statistics. The summary never treats a capped request as full historical coverage. If a target cannot be completed, the summary reports partial collection, preserves already delivered records and continues with independent company targets when possible. Uncertain mandatory delivery or billing stops collection for review.

Search returns a ranked subset. Reaching `searchLimit` does not establish that every matching company or category was collected. Category-company totals can be limited by Trustpilot. Category-tree mode covers the roots discoverable from the featured categories. Neither discovery mode promises every business worldwide. Similar-company lists and location lists may be empty. A location report is delivered only when its list matches the source's declared count.

The accepted 100,000-record cap is an input limit, not a guarantee that a particular source, workload or run will deliver that many records. Temporary source restrictions can end a run before the requested cap. Review content and company data are snapshots and may change later.

### Frequently asked questions

#### Where do I find the incorrect input?

Look for `Input field` warnings in the log. For example, `businessUnits[1]` identifies the second company entry. The warning gives a correction, and `SUMMARY.inputIssues` contains the same field and message. Fix the input and start a new run. Check `SUMMARY.complete` rather than assuming that a run without an Actor error collected everything requested.

#### Does it use the company website or collect emails?

It collects Trustpilot data and omits email fields. It does not visit company websites. Original review and reply text is preserved as written.

#### Can I collect more than 200 reviews?

Yes. Set `maxItems` above 200; for example, `maxItems: 300` requests up to 300 results. This is a global cap across all selected companies. Source availability and your filters still determine how many matching reviews can be collected.

#### Can I request every review?

Choose all desired ratings, `language: "all"`, `date: "all"` and a sufficiently large `maxItems`. Check the summary for source exhaustion and coverage verification; reaching a cap alone does not establish completeness.

#### Can I select verified-only reviews or reviews with replies?

Those selectors are not supported inputs. The returned verification and company-reply fields let you filter exported records in your own tools.

#### What happens after an interruption?

When the same run resumes with its original storage and input, existing delivery records are verified before more results are saved. Source pages can be revisited. This does not provide incremental synchronization across separate runs.

### Responsible use

Use the data in accordance with applicable terms and privacy requirements. This independent Actor is not affiliated with Trustpilot. Public review text can contain personal information supplied by its author; handle exports appropriately.

### Support

Open an issue in the Actor's **Issues** tab with the run ID, reproducible input and expected outcome. Do not include account credentials or private session data.

[GitHub examples: Python, JavaScript and CSV export](https://github.com/datacrawler-edu/trustpilot-reviews-api)

# Actor input Schema

## `mode` (type: `string`):

Keep Reviews for review exports. Choose another mode for company profiles, search or reports. Only fill the optional fields described for that mode.

## `businessUnits` (type: `array`):

For reviews and company reports, add one company per line: pccomponentes.com or https://www.trustpilot.com/review/pccomponentes.com. Business IDs are also accepted. Leave empty for search or category discovery. Up to 100 entries.

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

Total records to save across all companies. Default 100; maximum 100,000. A report counts as one record. Stopping at this limit does not mean all available data was collected.

## `language` (type: `string`):

For Reviews and Review statistics. Choose All languages or a language, or enter a two- or three-letter language code such as es or en. Other modes ignore this filter.

## `stars` (type: `array`):

For Reviews only. Leave all ratings selected to include every rating; deselect ratings to filter. Reviews are collected one rating at a time, not globally by date.

## `date` (type: `string`):

For Reviews and Review statistics. Leave All time for no date filter.

## `query` (type: `string`):

Only for Search businesses and Search categories. Enter a keyword such as electronics. Not needed when collecting reviews from company domains.

## `searchLimit` (type: `integer`):

Only for Search businesses and Search categories. Default 10; maximum 50. Maximum results also limits the saved records.

## `categoryIds` (type: `array`):

For Companies by category, enter IDs such as electronics_technology. Use Search categories to find IDs. In Category tree this optionally selects roots. Leave empty in other modes.

## `countryCode` (type: `string`):

Only for Companies by category. Choose a country or enter its two-letter code, such as ES or US. This does not filter the country of review authors.

## Actor input object example

```json
{
  "mode": "reviews",
  "businessUnits": [
    "pccomponentes.com"
  ],
  "maxItems": 5,
  "language": "all",
  "stars": [
    "1",
    "2",
    "3",
    "4",
    "5"
  ],
  "date": "all",
  "query": "",
  "searchLimit": 5,
  "categoryIds": [],
  "countryCode": "US"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 = {
    "mode": "reviews",
    "businessUnits": [
        "pccomponentes.com"
    ],
    "maxItems": 5,
    "language": "all",
    "stars": [
        "1",
        "2",
        "3",
        "4",
        "5"
    ],
    "date": "all",
    "query": "",
    "searchLimit": 5,
    "categoryIds": [],
    "countryCode": "US"
};

// Run the Actor and wait for it to finish
const run = await client.actor("datascraperes/trustpilot-reviews-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 = {
    "mode": "reviews",
    "businessUnits": ["pccomponentes.com"],
    "maxItems": 5,
    "language": "all",
    "stars": [
        "1",
        "2",
        "3",
        "4",
        "5",
    ],
    "date": "all",
    "query": "",
    "searchLimit": 5,
    "categoryIds": [],
    "countryCode": "US",
}

# Run the Actor and wait for it to finish
run = client.actor("datascraperes/trustpilot-reviews-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 '{
  "mode": "reviews",
  "businessUnits": [
    "pccomponentes.com"
  ],
  "maxItems": 5,
  "language": "all",
  "stars": [
    "1",
    "2",
    "3",
    "4",
    "5"
  ],
  "date": "all",
  "query": "",
  "searchLimit": 5,
  "categoryIds": [],
  "countryCode": "US"
}' |
apify call datascraperes/trustpilot-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datascraperes/trustpilot-reviews-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/i2QIDUd8nDGrMhdOa/builds/pCfqDSGzZ9AXzzwc3/openapi.json
