{ "openapi": "3.0.1", "info": { "title": "Trustpilot Reviews & TrustScore Scraper", "description": "Give it domains such as monzo.com or Trustpilot URLs, in bulk. Get each review's rating, text, date and company reply, plus a free TrustScore summary. Filter by stars, language, date, keyword, topic or reviewer country. Reads past the 200-review limit without logging in. $0.25 per 1,000 reviews.", "version": "1.0", "x-build-id": "LHcFR7NkFjb7XTpb0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/heyitsgautham~trustpilot-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-heyitsgautham-trustpilot-reviews-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/heyitsgautham~trustpilot-reviews-scraper/runs": { "post": { "operationId": "runs-sync-heyitsgautham-trustpilot-reviews-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/heyitsgautham~trustpilot-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-heyitsgautham-trustpilot-reviews-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": [ "businesses" ], "properties": { "businesses": { "title": "Businesses", "minItems": 1, "type": "array", "description": "Trustpilot review page URLs (any country site, such as de.trustpilot.com) or plain website domains such as booking.com.", "items": { "type": "string" } }, "maxReviewsPerBusiness": { "title": "Max reviews per business", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many reviews for each business. Every successful business also gets one free company summary row. Above 200, the scraper reads deeper filter combinations to get past Trustpilot's logged-out page limit, which takes longer. See the README for the coverage to expect by company size.", "default": 100 }, "stars": { "title": "Star ratings", "type": "array", "description": "Only reviews with these star ratings. Leave empty for all ratings.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] }, "default": [] }, "language": { "title": "Review language", "type": "string", "description": "all, or a two-letter language code such as en, de, fr, es or it. Trustpilot's own site shows only English by default; this scraper defaults to all languages.", "default": "all" }, "datePeriod": { "title": "Date period", "enum": [ "any", "last30days", "last3months", "last6months", "last12months" ], "type": "string", "description": "Only reviews published in this period.", "default": "any" }, "verifiedOnly": { "title": "Verified reviews only", "type": "boolean", "description": "Only reviews Trustpilot marks as verified.", "default": false }, "withRepliesOnly": { "title": "Reviews with a company reply only", "type": "boolean", "description": "Only reviews the business replied to.", "default": false }, "keyword": { "title": "Keyword", "type": "string", "description": "Only reviews that contain this word in the title or text, using Trustpilot's own search. Whole words, not case-sensitive, accents count (rücksendung is not rucksendung). Several words match any of them. Put a phrase in double quotes to match it exactly." }, "topics": { "title": "Topics", "type": "array", "description": "Only reviews Trustpilot tagged with these topics. Several topics match reviews that have all of them. IDs Trustpilot accepts: customer_service, delivery_service, product, order, refund, value_for_money, staff, price, quality, app, website, contact, payment, booking_process, location, delivery. If Trustpilot ignores an ID, that business returns a free row saying so and no reviews.", "default": [], "items": { "type": "string" } }, "reviewerCountries": { "title": "Reviewer countries", "type": "array", "description": "Only reviews written by reviewers from these countries, as two-letter codes such as US, GB or DE. Trustpilot has no country filter, so the scraper reads reviews and keeps the matching ones. You pay only for those. A business stops after 50 pages plus 10 pages for every 20 matching reviews, so a rare country does not run for long.", "default": [], "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "recency", "relevance" ], "type": "string", "description": "Order Trustpilot returns reviews in.", "default": "recency" }, "splitToGetMore": { "title": "Go past the 200-review page limit", "type": "boolean", "description": "Trustpilot shows logged-out visitors only 10 pages (200 reviews) per filter. When on, the scraper also reads each star rating and language separately, and when Max reviews per business is above 200 it goes on to verified, replied, topic and keyword filters inside each of those, to collect more. Results then come grouped by filter instead of one date order.", "default": true }, "onlyNewSinceLastRun": { "title": "Only new since the last run", "type": "boolean", "description": "For scheduled runs. Returns only reviews this actor has not returned to you before for the same business and filters, and nothing older than the newest one it returned last time. The first run returns the usual results and remembers them. Works best with newest-first order, where the run stops at the first page with nothing new. The memory is a key-value store named trustpilot-reviews-scraper-monitor in your Apify account.", "default": false }, "publishedAfter": { "title": "Published after", "pattern": "^$|^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?)?$|^\\d+\\s*(minute|hour|day|week|month|year)s?(\\s+ago)?$", "type": "string", "description": "Only reviews published on or after this date. Use a date such as 2026-10-01, an ISO time such as 2026-10-01T12:00:00Z (UTC), or a relative value such as 7 days, meaning the last 7 days. With newest-first order the run stops as soon as it reaches older ones." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many pages to fetch in parallel.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed. Trustpilot pages load fine from Apify's own servers. Turn on only if you see blocks.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }