{ "openapi": "3.0.1", "info": { "title": "Trustpilot Reviews Scraper: Score, Text & Replies", "description": "Trustpilot reviews for any company domain: stars, title, text, date, language, the company's reply and its TrustScore. Alerts for new and low-star reviews. No reviewer names.", "version": "1.0", "x-build-id": "4dh8b42t1THNPDxD4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/accountable_eel~trustpilot-reviews-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-accountable_eel-trustpilot-reviews-lookup", "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/accountable_eel~trustpilot-reviews-lookup/runs": { "post": { "operationId": "runs-sync-accountable_eel-trustpilot-reviews-lookup", "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/accountable_eel~trustpilot-reviews-lookup/run-sync": { "post": { "operationId": "run-sync-accountable_eel-trustpilot-reviews-lookup", "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": { "domains": { "title": "Company domains (or Trustpilot links)", "type": "array", "description": "One company per line: a plain domain such as stripe.com, or a trustpilot.com/review/stripe.com link. Each domain returns its newest reviews plus the company's TrustScore. No login required. Reviewer names and profiles are never returned. Accepted formats: stripe.com, notion.so, https://www.trustpilot.com/review/wise.com. You're only charged for the ones we actually find — a miss costs nothing.", "items": { "type": "string" } }, "maxReviewsPerDomain": { "title": "Reviews to read per domain", "type": "integer", "description": "Newest reviews first, 20 per page, up to 400. Counts reviews read, before the filters below. Each page is one proxy request of about 12 seconds.", "default": 20 }, "minStars": { "title": "Minimum stars", "type": "integer", "description": "Keep reviews with at least this many stars (1-5). Applied after the fetch." }, "maxStars": { "title": "Maximum stars", "type": "integer", "description": "Keep reviews with at most this many stars (1-5). Use 2 for complaints. Applied after the fetch." }, "sinceDate": { "title": "Published since (date)", "type": "string", "description": "ISO date such as 2026-09-01. Keeps reviews published on or after it. Applied after the fetch.", "default": "" }, "onlyWithReply": { "title": "Only reviews the company replied to", "type": "boolean", "description": "Applied after the fetch.", "default": false }, "deltaMode": { "title": "Track reviews across runs", "type": "boolean", "description": "Turns the actor into a review monitor. Each run compares every review with the previous run and fills in 'Change since last run' (first-seen, new-review, new-low-review, unchanged) and the previous TrustScore. Schedule it daily and combine with 'Only return rows that changed' and 'Send alerts to'.", "default": false }, "deltaName": { "title": "Watchlist name (optional)", "type": "string", "description": "Leave empty and one is derived from your domains. Type your own name to keep one memory across changes, or to run several independent watchlists.", "default": "" }, "alertOn": { "title": "Alert on", "enum": [ "all", "new-low-review", "new-review" ], "type": "string", "description": "Which new review raises an alert message. All is new reviews and new low-star reviews.", "default": "all" }, "lowStarMax": { "title": "Low-star means at most (stars)", "type": "integer", "description": "With monitoring on, a new review with this many stars or fewer is a new-low-review. Default 2.", "default": 2 }, "alertOnChangeOnly": { "title": "Only return rows that changed", "type": "boolean", "description": "With monitoring on, a review you have already been shown (change = unchanged) writes no row and is not billed. First-seen, new-review and new-low-review rows are returned.", "default": false }, "skipFirstRun": { "title": "Seed silently (no rows for a domain seen the first time)", "type": "boolean", "description": "The first reading of a domain has nothing to compare with. Turn this on to remember its reviews without returning or billing them, so rows and alerts start from the second run.", "default": false }, "notifyUrl": { "title": "Send alerts to (Discord or Slack webhook, Telegram bot link, or any URL)", "type": "string", "description": "Optional. After a review row is billed, each new review and new low-star review is posted here as one message with stars, title, text and a link. Discord or Slack: paste the channel's webhook URL. Telegram: https://api.telegram.org/bot/sendMessage?chat_id=. Any other URL receives JSON. Messages are free, and a failed message never fails the run (the row's notifyErrors says why). Stored encrypted, never logged or written to the results." }, "notifyFormat": { "title": "Message format", "enum": [ "auto", "discord", "slack", "telegram", "json" ], "type": "string", "description": "Leave on 'Detect from the link': discord.com links get Discord messages, hooks.slack.com Slack, api.telegram.org Telegram, anything else JSON. Pick one only to override that.", "default": "auto" }, "maxNotificationsPerRun": { "title": "Most alert messages per run", "type": "integer", "description": "Up to 100. After this, one 'more alerts' message says the rest are in the run's dataset. 0 sends only that one message.", "default": 20 }, "testRun": { "title": "Try it first — only process the first 5", "type": "boolean", "description": "Turn this on to test your input on a small sample before running the full list. Turn it off to process everything.", "default": false }, "onlyFound": { "title": "Hide rows with no result", "type": "boolean", "description": "Only keep rows where something was actually found. Misses are always free, whether or not you show them here.", "default": false }, "includeKeywords": { "title": "Only keep rows containing", "type": "array", "description": "Optional. Only keep results that mention at least one of these words (e.g. a job title, a city, a product name). Leave empty to keep everything.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Skip rows containing", "type": "array", "description": "Optional. Drop any result that mentions one of these words. Leave empty to skip nothing.", "items": { "type": "string" } }, "maxResults": { "title": "Stop after this many results", "minimum": 1, "type": "integer", "description": "Optional. Stop the run once this many results have been found — useful for a quick, cheap sample. Leave blank for no limit." }, "columns": { "title": "Which columns do you want?", "type": "array", "description": "Choose which pieces of information to include in each result row. All are included by default.", "items": { "type": "string", "enum": [ "reviewId", "domain", "businessName", "businessTrustScore", "businessReviewCount", "rating", "title", "text", "publishedAt", "experiencedAt", "likes", "language", "isVerified", "replyText", "replyAt", "changeType", "previousTrustScore", "url", "checkedAt" ], "enumTitles": [ "Review id", "Company domain", "Company", "TrustScore (company)", "Reviews (company, total)", "Stars", "Review title", "Review text", "Published", "Date of experience", "Likes", "Language", "Verified", "Company reply", "Reply date", "Change since last run", "TrustScore last run", "Company page", "Checked at" ] }, "default": [ "reviewId", "domain", "businessName", "businessTrustScore", "businessReviewCount", "rating", "title", "text", "publishedAt", "experiencedAt", "likes", "language", "isVerified", "replyText", "replyAt", "changeType", "previousTrustScore", "url", "checkedAt" ] }, "expandRows": { "title": "One row per review (recommended) — turn off for one row per domain instead", "type": "boolean", "description": "When on, each review found gets its own row instead of being grouped under its domain. You're still only charged once per domain, no matter how many rows it produces.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel requests. Keep conservative — this target has no browser fallback, so getting blocked costs more than slow-and-steady.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy config. Residential recommended for anti-bot-sensitive targets.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }