# Trustpilot Universal Scraper (`scrapifier/trustpilot-universal-scraper`) Actor
⚡ Scrape unlimited Trustpilot reviews for any company! Paste a domain or review URL, filter by stars, language, period or keywords, and instantly get rich, structured data — reviews, ratings, replies, TrustScores — for reputation monitoring, competitor analysis or lead generation.
- **URL**: https://apify.com/scrapifier/trustpilot-universal-scraper.md
- **Developed by:** [Scrapifier](https://apify.com/scrapifier) (community)
- **Categories:** Lead generation, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars
## Pricing
$0.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/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## ⭐ Trustpilot Scraper
Extract Trustpilot reviews for any company by name, domain or URL — and export them as structured JSON, CSV or Excel. No code required.
[](https://apify.com/scrapifier/trustpilot-universal-scraper)
### 📋 Contents
- [Overview](#-overview)
- [How to use](#-how-to-use)
- [Input](#-input)
- [Output](#-output)
- [Pricing](#-pricing)
- [Proxy and performance](#-proxy-and-performance)
- [Integrations](#-integrations)
- [Related Actors](#-related-actors)
- [FAQ](#-faq)
- [Support](#-support)
### 📖 Overview
Collect Trustpilot reviews for any company by typing a name, a domain, or pasting a review URL. For each review you get the title and text, star rating, date, verification status, the reviewer (name, country), the company's reply, and the full **company profile** (TrustScore, rating distribution, category, contact details).
- Find a company by **name**, **domain**, **website URL** or a **Trustpilot review URL** — or scrape a **reviewer's** profile.
- Filter by **star rating, language, date range, keyword, topic, country, verified** and replied reviews.
- Optionally expand to a company's **regional Trustpilot sites** (amazon.com, amazon.co.uk, amazon.de…).
- Exports to JSON, CSV, Excel, or the Apify dataset API.
- Pay per result — no subscription.
### 🚀 How to use
1. Add one or more companies in **Company URLs** — a name (`amazon`), a domain (`www.amazon.com`), a website, or a Trustpilot review URL (one per line).
2. Optionally add filters: **star rating**, **language**, **date range**, **keyword**, **country**, verified/replied.
3. Set **Max reviews per company** and start the run.
4. Download your data from the **Storage** tab, or fetch it from the API.
### 📥 Input
| Field | Key | Type | Default | Description |
|---|---|---|---|---|
| Company URLs | `company_urls` | array | — | Company name, domain, website URL, Trustpilot review URL, or a reviewer profile URL. |
| Star rating | `stars` | select (multi) | — | Keep only 1–5 star reviews. Empty = all. |
| Languages | `languages` | array | — | Keep only these languages (ISO 639-1). Empty = all. |
| Date window / range | `date` / `start_date` / `end_date` | select / date | — | Recent window, or an exact from/to range. |
| Keyword | `search` | string | — | Only reviews containing this exact text. |
| Topics | `topics` | array | — | Only reviews about these themes (broader match). |
| Countries | `countries` | array | — | Keep only these reviewer countries (ISO alpha-2). Empty = all. |
| Verified only | `verified` | boolean | `false` | Only reviews with a verified order / invitation. |
| Replied only | `replies_only` | boolean | `false` | Only reviews the company has replied to. |
| Sort | `sort` | select | — | Review ordering. |
| Regional sites | `expand_regional_domains` | boolean | `false` | Also scrape a company's regional Trustpilot sites. |
| Max reviews per company | `max_reviews_per_company` | integer | — | Reviews to collect per company. `0` = as many as available. |
| Include company profile | `include_company_info` | boolean | `true` | Attach the full company profile to every review. |
| Flat company columns | `flatten_company_data` | boolean | `false` | Add flat `company_name`, `company_domain`, `company_trust_score`… columns. |
| Proxy configuration | `proxyConfiguration` | object | Residential | Residential proxies recommended. |
Example input
```json
{
"company_urls": ["www.amazon.com"],
"stars": [1, 2],
"languages": ["en"],
"start_date": "2026-01-01",
"max_reviews_per_company": 500,
"include_company_info": true
}
````
### 📤 Output
Each review is stored as one dataset item. Export it as JSON, CSV or Excel, or read it from the API.
| Field | Description |
|---|---|
| `id` | Trustpilot review ID |
| `url` | Link to the review |
| `title` / `text` | Review title and body |
| `rating` | Star rating (1–5) |
| `language` | Review language |
| `published_date` / `experienced_date` | When the review was published / the experience happened |
| `verified` / `verification_level` | Verification status |
| `likes` | Useful votes |
| `consumer{}` | Reviewer: name, country, number of reviews |
| `reply{}` | The company's reply, if any |
| `company{}` | Full company profile: TrustScore, stars, total reviews, category, contact |
| `company_name` / `company_domain` / `company_trust_score` … | Flat columns (with **Flat company columns**) |
| `scraped_at` | Extraction timestamp |
Example output
```json
{
"id": "abc123",
"url": "https://www.trustpilot.com/reviews/abc123",
"title": "Fast delivery, great service",
"text": "Ordered on Monday, arrived Wednesday. Very happy.",
"rating": 5,
"language": "en",
"published_date": "2026-06-20T14:03:00Z",
"verified": true,
"likes": 2,
"consumer": { "name": "John D.", "country": "GB", "review_count": 7 },
"reply": { "text": "Thanks for your feedback!", "published_date": "2026-06-21T09:00:00Z" },
"company": { "name": "Amazon", "domain": "www.amazon.com", "trust_score": 4.1, "total_reviews": 132045 },
"scraped_at": "2026-06-25 10:00:00"
}
```
### 💰 Pricing
**$0.50 per 1,000 reviews.** No subscription — you pay only for the results you extract. New Apify users can try the Actor with their free monthly platform credits.
### 🛡️ Proxy and performance
- Residential proxies are recommended for reliable runs (on by default).
- Start with a small **Max reviews per company** to validate your filters, then increase it.
- Use **Date range** with the default sort to stop early once you reach older reviews.
- Add several companies in one run to compare brands side by side.
### 🔌 Integrations
Run the Actor from the [Apify API](https://docs.apify.com/api/v2), the [JavaScript](https://docs.apify.com/sdk/js) or [Python](https://docs.apify.com/sdk/python) clients, or connect it to Make, Zapier, n8n, Google Sheets and Slack through Apify integrations. Each run's data is available as JSON or CSV via the dataset API.
### 🔗 Related Actors
- [Glassdoor Reviews Universal Scraper](https://apify.com/scrapifier/glassdoor-reviews-universal-scraper) — company reviews from Glassdoor.
- [Vinted Universal Scraper](https://apify.com/scrapifier/vinted-universal-scraper) — second-hand marketplace listings.
Need another source? Open an issue.
### ❓ FAQ
**How do I target a specific country's Trustpilot?**
Paste that country's Trustpilot review URL, or turn on **Regional sites** to cover them all.
**Can I scrape the reviews written by one person?**
Yes — paste that reviewer's Trustpilot profile URL.
**How fresh is the data?**
It is collected live at runtime.
### 💬 Support
Questions or issues? Post them in the **Issues** tab and I will respond quickly. If the Actor is useful to you, a review is appreciated.
# Actor input Schema
## `company_urls` (type: `array`):
One item per row. Each can be:
- a **company name** (`amazon`) — resolved to the top Trustpilot match,
- a **domain** as shown on Trustpilot (`www.amazon.com`),
- a **company website URL** (`https://www.amazon.com`),
- a **Trustpilot review URL** (`https://www.trustpilot.com/review/…` — its own query filters are kept),
- a **reviewer profile URL** (`https://www.trustpilot.com/users/{id}` — scrapes the reviews that user wrote).
Regional Trustpilot hosts (fr., uk., de.…) work too.
## `stars` (type: `array`):
Only reviews with these ratings. Empty = all ratings.
## `languages` (type: `array`):
Pick one or more languages to keep (or type any ISO 639-1 code). Empty = all languages.
## `date` (type: `string`):
Rolling date window. For an exact cutoff use 'Published after' below — the two combine.
## `start_date` (type: `string`):
Only reviews published on or after this date (YYYY-MM-DD). With the default 'Most recent' sort the run stops as soon as it reaches older reviews.
## `end_date` (type: `string`):
Only reviews published on or before this date (YYYY-MM-DD).
## `search` (type: `string`):
Only reviews containing this exact text (e.g. "refund", "delivery").
## `topics` (type: `array`):
Only reviews about these themes — a broader, semantic match than Keywords (e.g. "refund", "customer service", "delivery").
## `countries` (type: `array`):
Pick one or more reviewer countries to keep (or type any ISO 3166-1 alpha-2 code). Empty = all countries.
## `verified` (type: `boolean`):
Only reviews with a verified order / invitation.
## `replies_only` (type: `boolean`):
Only reviews the company has replied to.
## `sort` (type: `string`):
Review ordering.
## `expand_regional_domains` (type: `boolean`):
After resolving a company, also scrape every regional sibling on Trustpilot (e.g. amazon → amazon.com, amazon.co.uk, amazon.de…). The per-company limit applies to each sibling.
## `strict_name_match` (type: `boolean`):
Reject search hits whose business name doesn't clearly match your query (keeps adjacent-but-wrong brands out). Off = accept Trustpilot's top suggestion.
## `max_reviews_per_company` (type: `integer`):
How many reviews to collect per company / reviewer (0 = as many as available). With regional expansion this applies to each domain.
## `include_company_info` (type: `boolean`):
Attach the full company profile to every review: TrustScore, rating distribution, category, review velocity, reply behaviour, and contact details (email, phone, address).
## `flatten_company_data` (type: `boolean`):
Also add flat top-level columns (company\_name, company\_domain, company\_trust\_score…) next to the nested company object — ideal for CSV / Excel exports.
## `emit_input_status` (type: `boolean`):
Add an input\_status report to the run's OUTPUT record listing which inputs returned no reviews and why (not found, empty, filtered out).
## `proxyConfiguration` (type: `object`):
Residential proxies are recommended for reliable runs.
## Actor input object example
```json
{
"company_urls": [
"amazon"
],
"date": "",
"verified": false,
"replies_only": false,
"sort": "recency",
"expand_regional_domains": false,
"strict_name_match": false,
"max_reviews_per_company": 100,
"include_company_info": true,
"flatten_company_data": false,
"emit_input_status": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# Actor output Schema
## `reviews` (type: `string`):
All Trustpilot reviews extracted by this run.
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"company_urls": [
"amazon"
],
"max_reviews_per_company": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapifier/trustpilot-universal-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"company_urls": ["amazon"],
"max_reviews_per_company": 100,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("scrapifier/trustpilot-universal-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"company_urls": [
"amazon"
],
"max_reviews_per_company": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call scrapifier/trustpilot-universal-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapifier/trustpilot-universal-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Trustpilot Universal Scraper",
"description": "⚡ Scrape unlimited Trustpilot reviews for any company! Paste a domain or review URL, filter by stars, language, period or keywords, and instantly get rich, structured data — reviews, ratings, replies, TrustScores — for reputation monitoring, competitor analysis or lead generation.",
"version": "0.1",
"x-build-id": "uXEI6sYrDi6em74kM"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapifier~trustpilot-universal-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapifier-trustpilot-universal-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapifier~trustpilot-universal-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapifier-trustpilot-universal-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapifier~trustpilot-universal-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapifier-trustpilot-universal-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"company_urls"
],
"properties": {
"company_urls": {
"title": "Companies / URLs *",
"type": "array",
"description": "One item per row. Each can be:\n- a **company name** (`amazon`) — resolved to the top Trustpilot match,\n- a **domain** as shown on Trustpilot (`www.amazon.com`),\n- a **company website URL** (`https://www.amazon.com`),\n- a **Trustpilot review URL** (`https://www.trustpilot.com/review/…` — its own query filters are kept),\n- a **reviewer profile URL** (`https://www.trustpilot.com/users/{id}` — scrapes the reviews that user wrote).\nRegional Trustpilot hosts (fr., uk., de.…) work too.",
"items": {
"type": "string"
}
},
"stars": {
"title": "Star ratings",
"type": "array",
"description": "Only reviews with these ratings. Empty = all ratings.",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5"
],
"enumTitles": [
"1",
"2",
"3",
"4",
"5"
]
}
},
"languages": {
"title": "Languages",
"type": "array",
"description": "Pick one or more languages to keep (or type any ISO 639-1 code). Empty = all languages.",
"items": {
"type": "string",
"enum": [
"en",
"fr",
"de",
"es",
"it",
"nl",
"pt",
"pl",
"sv",
"da",
"no",
"fi",
"cs",
"ro",
"hu",
"el",
"ru",
"tr",
"ar",
"ja",
"zh",
"ko",
"uk",
"bg",
"sk",
"hr",
"sl",
"et",
"lv",
"lt",
"he",
"id",
"ms",
"th",
"vi",
"hi",
"bn",
"ta",
"fa",
"ur",
"sr",
"bs",
"sq",
"mk",
"ka",
"hy",
"az",
"kk",
"is",
"ga",
"cy",
"ca",
"gl",
"eu",
"af",
"sw",
"tl"
],
"enumTitles": [
"English",
"French",
"German",
"Spanish",
"Italian",
"Dutch",
"Portuguese",
"Polish",
"Swedish",
"Danish",
"Norwegian",
"Finnish",
"Czech",
"Romanian",
"Hungarian",
"Greek",
"Russian",
"Turkish",
"Arabic",
"Japanese",
"Chinese",
"Korean",
"Ukrainian",
"Bulgarian",
"Slovak",
"Croatian",
"Slovenian",
"Estonian",
"Latvian",
"Lithuanian",
"Hebrew",
"Indonesian",
"Malay",
"Thai",
"Vietnamese",
"Hindi",
"Bengali",
"Tamil",
"Persian",
"Urdu",
"Serbian",
"Bosnian",
"Albanian",
"Macedonian",
"Georgian",
"Armenian",
"Azerbaijani",
"Kazakh",
"Icelandic",
"Irish",
"Welsh",
"Catalan",
"Galician",
"Basque",
"Afrikaans",
"Swahili",
"Filipino"
]
}
},
"date": {
"title": "Period",
"enum": [
"",
"last30days",
"last3months",
"last6months",
"last12months"
],
"type": "string",
"description": "Rolling date window. For an exact cutoff use 'Published after' below — the two combine.",
"default": ""
},
"start_date": {
"title": "Published after",
"type": "string",
"description": "Only reviews published on or after this date (YYYY-MM-DD). With the default 'Most recent' sort the run stops as soon as it reaches older reviews."
},
"end_date": {
"title": "Published before",
"type": "string",
"description": "Only reviews published on or before this date (YYYY-MM-DD)."
},
"search": {
"title": "Keywords (exact)",
"type": "string",
"description": "Only reviews containing this exact text (e.g. \"refund\", \"delivery\")."
},
"topics": {
"title": "Topics (themes)",
"type": "array",
"description": "Only reviews about these themes — a broader, semantic match than Keywords (e.g. \"refund\", \"customer service\", \"delivery\").",
"items": {
"type": "string"
}
},
"countries": {
"title": "Reviewer countries",
"type": "array",
"description": "Pick one or more reviewer countries to keep (or type any ISO 3166-1 alpha-2 code). Empty = all countries.",
"items": {
"type": "string",
"enum": [
"GB",
"US",
"FR",
"DE",
"ES",
"IT",
"NL",
"BE",
"PT",
"IE",
"DK",
"SE",
"NO",
"FI",
"PL",
"CZ",
"AT",
"CH",
"AU",
"CA",
"NZ",
"IN",
"JP",
"BR",
"MX",
"AE",
"SG",
"ZA",
"AF",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AI",
"AQ",
"AG",
"AR",
"AM",
"AW",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BZ",
"BJ",
"BM",
"BT",
"BO",
"BQ",
"BA",
"BW",
"BV",
"IO",
"VG",
"BN",
"BG",
"BF",
"BI",
"CV",
"KH",
"CM",
"KY",
"CF",
"TD",
"CL",
"CN",
"CX",
"CC",
"CO",
"KM",
"CG",
"CD",
"CK",
"CR",
"HR",
"CU",
"CW",
"CY",
"CI",
"DJ",
"DM",
"DO",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"SZ",
"ET",
"FK",
"FO",
"FJ",
"GF",
"PF",
"TF",
"GA",
"GM",
"GE",
"GH",
"GI",
"GR",
"GL",
"GD",
"GP",
"GU",
"GT",
"GG",
"GN",
"GW",
"GY",
"HT",
"HM",
"HN",
"HK",
"HU",
"IS",
"ID",
"IR",
"IQ",
"IM",
"IL",
"JM",
"JE",
"JO",
"KZ",
"KE",
"KI",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MO",
"MG",
"MW",
"MY",
"MV",
"ML",
"MT",
"MH",
"MQ",
"MR",
"MU",
"YT",
"FM",
"MD",
"MC",
"MN",
"ME",
"MS",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NC",
"NI",
"NE",
"NG",
"NU",
"NF",
"KP",
"MK",
"MP",
"OM",
"PK",
"PW",
"PS",
"PA",
"PG",
"PY",
"PE",
"PH",
"PN",
"PR",
"QA",
"RO",
"RU",
"RW",
"RE",
"BL",
"SH",
"KN",
"LC",
"MF",
"PM",
"VC",
"WS",
"SM",
"SA",
"SN",
"RS",
"SC",
"SL",
"SX",
"SK",
"SI",
"SB",
"SO",
"GS",
"KR",
"SS",
"LK",
"SD",
"SR",
"SJ",
"SY",
"ST",
"TW",
"TJ",
"TZ",
"TH",
"TL",
"TG",
"TK",
"TO",
"TT",
"TN",
"TR",
"TM",
"TC",
"TV",
"VI",
"UG",
"UA",
"UM",
"UY",
"UZ",
"VU",
"VA",
"VE",
"VN",
"WF",
"EH",
"YE",
"ZM",
"ZW",
"AX"
],
"enumTitles": [
"United Kingdom",
"United States",
"France",
"Germany",
"Spain",
"Italy",
"Netherlands",
"Belgium",
"Portugal",
"Ireland",
"Denmark",
"Sweden",
"Norway",
"Finland",
"Poland",
"Czechia",
"Austria",
"Switzerland",
"Australia",
"Canada",
"New Zealand",
"India",
"Japan",
"Brazil",
"Mexico",
"United Arab Emirates",
"Singapore",
"South Africa",
"Afghanistan",
"Albania",
"Algeria",
"American Samoa",
"Andorra",
"Angola",
"Anguilla",
"Antarctica",
"Antigua and Barbuda",
"Argentina",
"Armenia",
"Aruba",
"Azerbaijan",
"Bahamas",
"Bahrain",
"Bangladesh",
"Barbados",
"Belarus",
"Belize",
"Benin",
"Bermuda",
"Bhutan",
"Bolivia",
"Bonaire, Sint Eustatius and Saba",
"Bosnia and Herzegovina",
"Botswana",
"Bouvet Island",
"British Indian Ocean Territory",
"British Virgin Islands",
"Brunei",
"Bulgaria",
"Burkina Faso",
"Burundi",
"Cabo Verde",
"Cambodia",
"Cameroon",
"Cayman Islands",
"Central African Republic",
"Chad",
"Chile",
"China",
"Christmas Island",
"Cocos (Keeling) Islands",
"Colombia",
"Comoros",
"Congo",
"Congo (DRC)",
"Cook Islands",
"Costa Rica",
"Croatia",
"Cuba",
"Curaçao",
"Cyprus",
"Côte d'Ivoire",
"Djibouti",
"Dominica",
"Dominican Republic",
"Ecuador",
"Egypt",
"El Salvador",
"Equatorial Guinea",
"Eritrea",
"Estonia",
"Eswatini",
"Ethiopia",
"Falkland Islands",
"Faroe Islands",
"Fiji",
"French Guiana",
"French Polynesia",
"French Southern Territories",
"Gabon",
"Gambia",
"Georgia",
"Ghana",
"Gibraltar",
"Greece",
"Greenland",
"Grenada",
"Guadeloupe",
"Guam",
"Guatemala",
"Guernsey",
"Guinea",
"Guinea-Bissau",
"Guyana",
"Haiti",
"Heard Island and McDonald Islands",
"Honduras",
"Hong Kong",
"Hungary",
"Iceland",
"Indonesia",
"Iran",
"Iraq",
"Isle of Man",
"Israel",
"Jamaica",
"Jersey",
"Jordan",
"Kazakhstan",
"Kenya",
"Kiribati",
"Kuwait",
"Kyrgyzstan",
"Laos",
"Latvia",
"Lebanon",
"Lesotho",
"Liberia",
"Libya",
"Liechtenstein",
"Lithuania",
"Luxembourg",
"Macao",
"Madagascar",
"Malawi",
"Malaysia",
"Maldives",
"Mali",
"Malta",
"Marshall Islands",
"Martinique",
"Mauritania",
"Mauritius",
"Mayotte",
"Micronesia",
"Moldova",
"Monaco",
"Mongolia",
"Montenegro",
"Montserrat",
"Morocco",
"Mozambique",
"Myanmar",
"Namibia",
"Nauru",
"Nepal",
"New Caledonia",
"Nicaragua",
"Niger",
"Nigeria",
"Niue",
"Norfolk Island",
"North Korea",
"North Macedonia",
"Northern Mariana Islands",
"Oman",
"Pakistan",
"Palau",
"Palestine",
"Panama",
"Papua New Guinea",
"Paraguay",
"Peru",
"Philippines",
"Pitcairn",
"Puerto Rico",
"Qatar",
"Romania",
"Russia",
"Rwanda",
"Réunion",
"Saint Barthélemy",
"Saint Helena",
"Saint Kitts and Nevis",
"Saint Lucia",
"Saint Martin",
"Saint Pierre and Miquelon",
"Saint Vincent and the Grenadines",
"Samoa",
"San Marino",
"Saudi Arabia",
"Senegal",
"Serbia",
"Seychelles",
"Sierra Leone",
"Sint Maarten",
"Slovakia",
"Slovenia",
"Solomon Islands",
"Somalia",
"South Georgia and the South Sandwich Islands",
"South Korea",
"South Sudan",
"Sri Lanka",
"Sudan",
"Suriname",
"Svalbard and Jan Mayen",
"Syria",
"São Tomé and Príncipe",
"Taiwan",
"Tajikistan",
"Tanzania",
"Thailand",
"Timor-Leste",
"Togo",
"Tokelau",
"Tonga",
"Trinidad and Tobago",
"Tunisia",
"Turkey",
"Turkmenistan",
"Turks and Caicos Islands",
"Tuvalu",
"U.S. Virgin Islands",
"Uganda",
"Ukraine",
"United States Minor Outlying Islands",
"Uruguay",
"Uzbekistan",
"Vanuatu",
"Vatican City",
"Venezuela",
"Vietnam",
"Wallis and Futuna",
"Western Sahara",
"Yemen",
"Zambia",
"Zimbabwe",
"Åland Islands"
]
}
},
"verified": {
"title": "Verified reviews only",
"type": "boolean",
"description": "Only reviews with a verified order / invitation.",
"default": false
},
"replies_only": {
"title": "With company reply only",
"type": "boolean",
"description": "Only reviews the company has replied to.",
"default": false
},
"sort": {
"title": "Sort by",
"enum": [
"recency",
"relevance"
],
"type": "string",
"description": "Review ordering.",
"default": "recency"
},
"expand_regional_domains": {
"title": "Expand regional domains",
"type": "boolean",
"description": "After resolving a company, also scrape every regional sibling on Trustpilot (e.g. amazon → amazon.com, amazon.co.uk, amazon.de…). The per-company limit applies to each sibling.",
"default": false
},
"strict_name_match": {
"title": "Strict name matching",
"type": "boolean",
"description": "Reject search hits whose business name doesn't clearly match your query (keeps adjacent-but-wrong brands out). Off = accept Trustpilot's top suggestion.",
"default": false
},
"max_reviews_per_company": {
"title": "Max reviews per company",
"minimum": 0,
"type": "integer",
"description": "How many reviews to collect per company / reviewer (0 = as many as available). With regional expansion this applies to each domain.",
"default": 100
},
"include_company_info": {
"title": "Include company profile",
"type": "boolean",
"description": "Attach the full company profile to every review: TrustScore, rating distribution, category, review velocity, reply behaviour, and contact details (email, phone, address).",
"default": true
},
"flatten_company_data": {
"title": "Flat company columns (CSV-friendly)",
"type": "boolean",
"description": "Also add flat top-level columns (company_name, company_domain, company_trust_score…) next to the nested company object — ideal for CSV / Excel exports.",
"default": false
},
"emit_input_status": {
"title": "Report empty inputs",
"type": "boolean",
"description": "Add an input_status report to the run's OUTPUT record listing which inputs returned no reviews and why (not found, empty, filtered out).",
"default": true
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Residential proxies are recommended for reliable runs."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```