Examples
Update Settings
Configure the Trustpilot Reviews Scraper settings
The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POST
https://api.lobstr.io/v1/squids/{squid_hash}Configure your Trustpilot Reviews Scraper squid settings. Filter by star rating, language, date, and more to target specific review types.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Content-TypestringheaderrequiredRequest body format. Value: application/json
Scraper Parameters
Set these parameters in the params object:
| Parameter | Type | Default | Description |
|---|---|---|---|
| max_results | integer | 200 | Maximum number of reviews to collect per company page |
| max_unique_results_per_run | integer | unlimited | Maximum unique reviews across all tasks in the run |
| stars | string | all | Filter by star rating: all, 1, 2, 3, 4, 5 |
| language | string | All languages | Filter by review language. Allowed values: All languages, Arabic, Chinese (Simplified), Chinese (Traditional), Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Russian, Spanish, Swedish, Thai, Turkish, Vietnamese |
| verified | boolean | false | Only return reviews from verified purchases |
| replies | boolean | false | Include company replies in the results |
| search | string | null | Filter reviews by keyword |
| topics | string | null | Filter by Trustpilot topic tag |
| start_page | integer | 1 | Page number to start scraping from |
| fetch_since | string | null | Stop scraping when items older than this threshold are reached (based on published_at). Use a relative duration (24h, 7d, 2w) or an absolute date (YYYY-MM-DD HH:MM:SS) |
| fetch_since_timezone | string | null | Timezone for interpreting an absolute fetch_since date (e.g. Europe/Paris). Only applies when fetch_since is an absolute date — ignored for relative values like 24h or 7d. See supported timezones. |
Squid Settings
Configure general squid settings:
| Setting | Type | Description |
|---|---|---|
| name | string | Display name for your squid configuration |
| concurrency | integer | Number of parallel scraping threads (default: 1) |
| export_unique_results | boolean | Export only unique results (deduplicated) |
| to_complete | boolean | Run until all tasks complete |
| no_line_breaks | boolean | Remove line breaks from results |
Use stars: 1 combined with fetch_since: 7d to monitor recent negative reviews for reputation management.
Set verified: true to focus on reviews from confirmed customers only.
Code Examples
curl -X POST "https://api.lobstr.io/v1/squids/YOUR_SQUID_HASH" \ -H "Authorization: Token YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Trustpilot Reviews Scraper (1)", "concurrency": 1, "export_unique_results": true, "to_complete": false, "no_line_breaks": true, "params": { "max_results": 200, "stars": "all", "language": "English", "verified": false, "replies": false, "fetch_since": null } }'
Response
201
{ "name": "Trustpilot Reviews Scraper (1)", "concurrency": 1, "export_unique_results": true, "to_complete": false, "no_line_breaks": true, "params": { "max_results": 200, "stars": "all", "language": "English", "verified": false, "replies": false, "fetch_since": null } }