{ "openapi": "3.0.1", "info": { "title": "Trustpilot Reviews Scraper - Ratings & Replies, No Login", "description": "Get public Trustpilot reviews for any company domain: star rating, title, text, date, country, verification and the company's reply. Filter by stars, language and date; onlyNew for monitoring. No login.", "version": "0.1", "x-build-id": "YDFwQAYbxpJoSRQLQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cliqtomedia~trustpilot-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cliqtomedia-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/cliqtomedia~trustpilot-reviews-scraper/runs": { "post": { "operationId": "runs-sync-cliqtomedia-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/cliqtomedia~trustpilot-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-cliqtomedia-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": [ "companyDomains" ], "properties": { "companyDomains": { "title": "Companies", "type": "array", "description": "Company website domains as Trustpilot lists them (apify.com, www.booking.com), company website URLs or Trustpilot review page URLs (https://www.trustpilot.com/review/apify.com). One per line, up to 50. The Actor follows Trustpilot's own redirect when it lists the company with or without www.", "items": { "type": "string" } }, "maxReviews": { "title": "Max reviews per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many reviews for each company (1–1000). Trustpilot shows visitors 10 pages (200 reviews) per filter; above that the Actor reads each star rating separately, so more reviews are reachable. For big companies you may still get fewer than this: RUN_SUMMARY then says PUBLIC_PAGE_LIMIT.", "default": 100 }, "stars": { "title": "Star ratings", "type": "array", "description": "Only reviews with these star ratings. Leave empty for all ratings.", "items": { "type": "string", "enum": [ "5", "4", "3", "2", "1" ], "enumTitles": [ "5 stars", "4 stars", "3 stars", "2 stars", "1 star" ] }, "default": [] }, "languages": { "title": "Review languages", "maxItems": 10, "type": "array", "description": "Two-letter language codes (en, de, fr, es, it, nl, da, sv, pl, pt…), read in this order, up to 10. Leave empty or write \"all\" for every language. Note: trustpilot.com shows only English reviews unless you ask for other languages, so empty here means all of them.", "default": [], "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "recency", "relevance" ], "type": "string", "description": "Newest first, or Trustpilot's \"most relevant\" order.", "default": "recency" }, "dateRange": { "title": "Date range", "enum": [ "any", "last30days", "last3months", "last6months", "last12months" ], "type": "string", "description": "Only reviews published in this period, as Trustpilot filters them.", "default": "any" }, "verifiedOnly": { "title": "Verified reviews only", "type": "boolean", "description": "Only reviews Trustpilot marks as verified.", "default": false }, "withRepliesOnly": { "title": "Only reviews with a company reply", "type": "boolean", "description": "Only reviews the company answered.", "default": false }, "onlyNew": { "title": "Only new reviews (monitoring)", "type": "boolean", "description": "Skip reviews this Actor already delivered to you in earlier runs with the same companies and filters, and stop paging once it reaches them. Skipped reviews are not charged. The list of delivered review IDs is kept in your key-value store named trustpilot-reviews-seen.", "default": 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 } } } } } } } } } }