Skip to content
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.
POSThttps://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

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Request 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
  }
}