{ "openapi": "3.0.1", "info": { "title": "Trustpilot Reviews Scraper", "description": "Extracts Trustpilot reviews by company domain or URL in every language: rating, title, text, date, reviewer country, verification and company reply as JSON. Only-new mode for monitoring, star, language and keyword filters. No proxy setup needed.", "version": "0.0", "x-build-id": "1SqtNVOSJ9gYC3Qkz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apifry~trustpilot-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apifry-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/apifry~trustpilot-reviews-scraper/runs": { "post": { "operationId": "runs-sync-apifry-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/apifry~trustpilot-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-apifry-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": [ "companies" ], "properties": { "companies": { "title": "Companies", "type": "array", "description": "Add companies as their website domain (www.amazon.com), website URL, or Trustpilot review page URL from any country site (https://uk.trustpilot.com/review/www.amazon.co.uk). One company per line.", "items": { "type": "string" } }, "maxReviewsPerCompany": { "title": "Max reviews per company", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Enter the most reviews to keep per company. Trustpilot shows 200 reviews per filter, so beyond 200 the run splits the list by star and language and removes duplicates; large companies typically give 1,000–3,000 reviews this way. You pay only for reviews stored in the dataset.", "default": 100 }, "onlyNewerThan": { "title": "Only reviews newer than", "type": "string", "description": "Enter a date (2026-10-01) or a relative period (7 days, 12 hours, 2 weeks). Older reviews are skipped and not charged; each list stops once it reaches them." }, "onlyNewSinceLastRun": { "title": "Only new since the last run", "type": "boolean", "description": "Turn on for scheduled monitoring: each run keeps only reviews newer than the newest one seen by your previous run (per company). The mark is kept in the key-value store 'apifry-trustpilot-reviews-state' in your account. Daily runs keep up even with very busy companies.", "default": false }, "stars": { "title": "Star ratings", "type": "array", "description": "Select the star ratings to keep, e.g. 1 and 2 for complaints. Other reviews are not read and not charged. 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" ] } }, "languages": { "title": "Languages", "type": "array", "description": "Add two-letter language codes (en, de, fr, es …) to keep only reviews in those languages. Leave empty for every language — unlike Trustpilot's website, which by default shows only your own language.", "items": { "type": "string" } }, "countries": { "title": "Reviewer countries", "type": "array", "description": "Add two-letter country codes (US, GB, DE, CN …) to keep only reviews written by people from those countries. Reviews from other countries are skipped and not charged. Trustpilot has no country filter of its own, so the run reads the company's reviews and keeps the matching ones; it stops a company after 30 pages in a row without a match. Leave empty for all countries.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Add words or phrases; only reviews whose title or text contains at least one of them are kept (case-insensitive). Reviews without a match are not charged. Leave empty to keep all.", "items": { "type": "string" } }, "includeTags": { "title": "Tag every review (topics, sentiment, bug, feature request)", "type": "boolean", "description": "Adds topics (delivery, returns & refunds, customer service, product quality, price & billing, scam & trust, website & ordering), sentiment and isFeatureRequest (suggestions) to each review. Tagged reviews are charged the 'Review with tags' price instead of 'Review'. Reviews in languages other than EN, DE, FR, ES, PT, IT, RU stay untagged at the plain review price. Rule-based, not AI.", "default": false }, "includeInsights": { "title": "Insights per company", "type": "boolean", "description": "Writes record INSIGHTS: complaint topics with shares and quotes, frequent words and phrases in 1–2 star reviews, suggestions, company reply rate and time. Charged once per company with at least 30 reviews in this run; failed, incomplete or tiny samples are free. Based on the reviews this run collected — the TrustScore stays in SUMMARY.", "default": false }, "includeTrends": { "title": "Trends per company", "type": "boolean", "description": "Writes record TRENDS: average rating, review count and 1–2 star share per week or month with change to the previous period, a spike flag, and the same by reviewer country. Charged once per company with at least 30 reviews in this run. Use no star or keyword filter for a true picture.", "default": false }, "useApifyProxy": { "title": "Use Apify Proxy (datacenter)", "type": "boolean", "description": "Turn on only if runs stop with 'Trustpilot keeps refusing this IP'. Trustpilot is normally reachable without a proxy; with this on, the whole run uses one datacenter IP.", "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 } } } } } } } } } }