Collectors · Company data
Trustpilot scraper API in Python
Public Trustpilot reviews of any company — rating, text, dates, verification and the company reply. One POST from Python with domain, rows back as JSON with 25 fields, $0.06 per delivered review. No proxies or parsers to maintain.
First call
Install, call, read the rows.
pip install requestsimport os, requests
r = requests.post(
"https://api.quanticdata.io/v1/scraper/collectors/trustpilot_reviews/run",
headers={"Authorization": f"Bearer {os.environ['QD_API_KEY']}"},
json={
"domain": "wise.com",
"sort": "recency",
"max_results": 20,
},
timeout=120,
)
r.raise_for_status()
run = r.json()["payload"]
print(run["count"], "rows,", run["cost"]["usd"], "USD")
for row in run["results"]:
print(row.get("id"), row.get("title"), row.get("text"), row.get("rating"))The key comes from an environment variable, never from the code. The run answers in the same request when it finishes in time; payload.results holds the rows and payload.cost what they cost.
Request parameters
What the collector takes.
| Parameter | Type | Required | Meaning |
|---|---|---|---|
domain | string | yes | The reviewed company's domain, e.g. wise.com (not the Trustpilot URL). |
sort | string: recency, relevance | no (default recency) | Review order (default recency). |
stars | integer | no | Only reviews with this star rating (1–5). Omit for all. |
country | string | no | ISO 3166-1 alpha-2 code — proxy exit geo. Omit for the default pool. |
max_results | integer | no (default 20) | How many reviews to deliver at most (1–100). You pay only for delivered reviews. |
Response fields
25 fields per review.
| Field | Type | What it holds |
|---|---|---|
rank | integer | 1-based position in the requested order. |
page | integer | Profile page the review came from. |
id | string, nullable | Trustpilot review id. |
title | string, nullable | Review title. |
text | string, nullable | Full review text. |
rating | integer, nullable | Star rating (1–5). |
date | string, nullable | Publish date (ISO 8601). |
experience_date | string, nullable | Date of the reviewed experience (ISO 8601). |
reviewer | string, nullable | Reviewer display name. |
reviewer_country | string, nullable | Reviewer country code. |
reviewer_reviews | integer, nullable | How many reviews the reviewer has written. |
verified | boolean | True when Trustpilot marks the review as verified. |
likes | integer | Useful votes on the review. |
reply | string, nullable | Company reply text, when present. |
reply_date | string, nullable | Company reply date (ISO 8601). |
url | string, nullable | Direct link to the review. |
language | string, nullable | Language of the review (ISO code). |
source | string, nullable | How the review was collected, as Trustpilot labels it (Organic, Invited…). |
verification_level | string, nullable | Trustpilot's verification label for the review (verified, invited, not-verified…). |
updated_date | string, nullable | When the reviewer last edited the review (ISO 8601), null when never. |
reply_updated_date | string, nullable | When the company last edited its reply (ISO 8601). |
reviewer_reviews_same_company | integer, nullable | How many reviews this reviewer has written about the same company. |
company | string, nullable | Reviewed company as Trustpilot names it. |
company_trust_score | number, nullable | The company's TrustScore at collection time. |
company_reviews | integer, nullable | Total reviews on the company's profile at collection time. |
Add ?format=csv to the runs endpoint to get the same rows as CSV.
Long runs
Run in the background, then poll.
A run that needs more time can go to the background: send "async": true, get 202 with the run id, and poll the runs endpoint until the status is done. Reading a run is free.
import os, time, requests
H = {"Authorization": f"Bearer {os.environ['QD_API_KEY']}"}
r = requests.post("https://api.quanticdata.io/v1/scraper/collectors/trustpilot_reviews/run", headers=H,
json={**{"domain":"wise.com","sort":"recency","max_results":20}, "async": True}, timeout=30)
run_id = r.json()["payload"]["run_id"]
while True:
run = requests.get(f"https://api.quanticdata.io/v1/scraper/collectors/runs/{run_id}", headers=H, timeout=30).json()["payload"]
if run["status"] in ("done", "failed"):
break
time.sleep(5)
print(run["status"], run["count"])Errors
What can come back, and what is billed.
| Status | Meaning | Billed |
|---|---|---|
400 | The input does not match the collector (payload.errors) | No |
401 | Missing or wrong API key | No |
402 | Balance and free credit do not cover the run: top up | No |
422 | The input can never resolve; retrying the same input cannot help | No |
424 | The run failed at the source (blocked, timed out, layout changed); safe to retry | No |
429 | Rate limit or a per-account brake; wait for Retry-After | No |
Only delivered rows are billed: a run that delivers nothing costs nothing.
Price
$0.06 per delivered review.
| Rows | Cost |
|---|---|
| 1 | $0.06 |
| 1,000 | $60.00 |
| 10,000 | $600.00 |
Up to 100 reviews per run; split larger jobs into several runs. The $2 free credit every month covers about 33 reviews. No subscription; paid tiers lower the unit price. All collector prices: collector pricing.
Before you run it
Questions developers ask
Is there a free Trustpilot reviews API?
Every account gets $2 of free usage each month, about 33 reviews of this collector at $0.06 each, with no card.
Do I have to handle proxies, retries or blocks?
No. The collector runs on our network and handles them; a run blocked at the source returns 424 and is not billed.
How many rows can one run return?
Up to 100 reviews per run (the max_results input, where the collector has one).
Can an AI agent run it?
Yes: the MCP server exposes it as the run_collector tool, with the same input and price. See the MCP server.
Run it on the free credit.
Create an API key, export it as QD_API_KEY and run the example. $0.06 per delivered review, no subscription.