{ "openapi": "3.0.1", "info": { "title": "Trustpilot Reviews Scraper | Includes Company Replies", "description": "Scrape Trustpilot business reviews by domain: reviewer, star rating, title, text, date, company reply, trust score & total count. No login, beats the AWS WAF via residential proxies. Works in Claude, ChatGPT & any MCP agent.", "version": "0.5", "x-build-id": "JzGt95nh5v46jKbXf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~trustpilot-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-trustpilot-reviews", "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/themineworks~trustpilot-reviews/runs": { "post": { "operationId": "runs-sync-themineworks-trustpilot-reviews", "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/themineworks~trustpilot-reviews/run-sync": { "post": { "operationId": "run-sync-themineworks-trustpilot-reviews", "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", "properties": { "companyDomains": { "title": "Company domains", "type": "array", "description": "Trustpilot company domains to scrape, for example [\"amazon.com\", \"booking.com\"]. Batching is much cheaper per review than separate runs: clearing Trustpilot's bot check costs one real browser page load, and that clearance then covers every company in the same run. Twenty companies in one run costs roughly a third per review of twenty single-company runs. Max reviews applies PER company.", "items": { "type": "string" } }, "companyDomain": { "title": "Company domain", "type": "string", "description": "Single company domain, for example \"amazon.com\". Kept for existing runs and saved tasks; prefer Company domains above, which accepts a list and is cheaper per review. If both are given, the list wins." }, "maxResults": { "title": "Max reviews", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum reviews PER COMPANY (not per run), so 100 with three companies can return up to 300. Trustpilot's public site serves about 200 reviews per company (10 pages) before asking for a login, so a higher value returns everything available and finishes early. You are never charged for reviews that do not exist. Use the star rating filter to open a fresh 10-page window.", "default": 100 }, "starsFilter": { "title": "Star rating filter (optional)", "uniqueItems": true, "type": "array", "description": "Only keep reviews with these star ratings (1-5). Leave empty to keep all ratings. Example: [1, 2] for negative reviews only.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ] } }, "includeReviewInsights": { "title": "Include review insights", "type": "boolean", "description": "Adds one extra insights row PER COMPANY: a rating breakdown, the most common phrases in negative reviews, the reply rate on negative reviews, and a month by month rating trend. Computed entirely from the reviews already collected in this run, no AI, no extra fetch. Off by default. Only charged for a company that actually returned at least one review.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Trustpilot fronts every page with an AWS WAF challenge that blocks datacenter IPs. RESIDENTIAL proxies are REQUIRED for this actor to return data.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } }, "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 } } } } } } } } } }