# Trustpilot Competitor Review Monitor (`signalcrawl/trustpilot-competitor-review-monitor`) Actor Monitor public Trustpilot business reviews and export reputation intelligence with ratings, sentiment, urgency, response gaps, competitor weakness scores, CRM notes, and dedupe-ready keys. - **URL**: https://apify.com/signalcrawl/trustpilot-competitor-review-monitor.md - **Developed by:** [SignalCrawl](https://apify.com/signalcrawl) (community) - **Categories:** Lead generation, Automation, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 review intelligence records This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Trustpilot Competitor Review Monitor Turn public Trustpilot company reviews into competitor and reputation intelligence for sales, marketing, customer success, support, product, and agency workflows. Give the actor Trustpilot business profile URLs or plain company domains. It visits public review pages, reads JSON-LD and Next.js data when available, falls back to HTML parsing, and saves normalized review records with sentiment, urgency, competitor weakness, response-gap, CRM, and action notes. ### Pricing recommendation Recommended public-store pricing: `$2.00 / 1,000 review intelligence records`. Primary event name: `Review intelligence record`. Recommended Apify categories: `Lead generation`, `Automation`, `AI`. ### What it extracts - Company identity: `companyDomain`, `companyName`, public Trustpilot profile rating. - Review content: `rating`, `title`, `review`, `author`, `reviewDate`, `language`, `stars`. - Intelligence scores: `sentimentScore`, `urgencyScore`, `competitorWeaknessScore`. - Workflow fields: `alertType`, `responseGap`, `crmNote`, `actionNote`. - Traceability: `sourceUrl`, `dedupeKey`, `scrapedAt`. ### Input - `companyUrls`: Trustpilot business profile URLs or plain domains. - `domains`: optional additional plain domains merged with `companyUrls`. - `maxPagesPerCompany`: max review pages to request per company. - `maxReviewsPerCompany`: max unique records to save per company. - `minStars` / `maxStars`: star-rating filters. - `alertOnly`: keep only urgent or opportunity-oriented alerts. - `keywords`: optional terms that must appear in review text or generated notes. - `language`: `all` or a language code such as `en`, `fr`, `de`, `es`. - `sort`: `recency` or `relevance`. ### Use cases Competitor battlecards: monitor 1-3 star competitor reviews, identify repeated complaints about pricing, support, refunds, product quality, or onboarding, and feed the results into sales enablement. Reputation alerts: watch your own or competitor profiles for unanswered negative reviews, urgent billing complaints, legal/trust language, and public support gaps. Voice-of-customer research: collect positive and negative review language for positioning, landing pages, objection handling, product messaging, and churn prevention. Agency reporting: produce a repeatable Trustpilot monitoring dataset for reputation management, SEO/GEO research, and executive weekly summaries. ### Output example ```json { "companyDomain": "example.com", "companyName": "Example", "rating": 4.1, "title": "No support after payment", "review": "I asked for a refund and never received a response.", "author": "Jane", "reviewDate": "2026-05-19T10:00:00Z", "language": "en", "stars": 1, "sentimentScore": -1, "urgencyScore": 100, "competitorWeaknessScore": 100, "alertType": "billing_issue", "responseGap": true, "crmNote": "Example Trustpilot review: 1/5 stars, alert=billing_issue and appears unanswered.", "actionNote": "Use as competitor weakness signal; route to sales enablement and monitor for repeat pain points.", "sourceUrl": "https://www.trustpilot.com/reviews/example", "dedupeKey": "9a1c4b2d8f0e7a6b3c5d2f10", "scrapedAt": "2026-05-20T12:00:00+00:00" } ```` ### Notes on public data This actor collects public Trustpilot business review pages only. It does not log in, bypass access controls, or collect private account data. Use reasonable page limits and request delays for monitoring workflows. ### Local QA Run deterministic parser and scoring checks: ```bash python tests/qa_harness.py ``` Run locally with Apify tooling and the smoke input: ```bash apify run -i examples/cloud-smoke.json ``` # Actor input Schema ## `companyUrls` (type: `array`): Trustpilot business profile URLs or plain domains, for example https://www.trustpilot.com/review/example.com or example.com. ## `domains` (type: `array`): Optional plain business domains to monitor. Values are merged with companyUrls. ## `maxPagesPerCompany` (type: `integer`): Maximum Trustpilot review pages to request for each company. ## `maxReviewsPerCompany` (type: `integer`): Maximum unique review intelligence records to save per company. ## `minStars` (type: `integer`): Keep reviews with at least this Trustpilot star rating. ## `maxStars` (type: `integer`): Keep reviews with at most this Trustpilot star rating. ## `alertOnly` (type: `boolean`): When enabled, save only records with meaningful risk or opportunity alerts. ## `keywords` (type: `array`): Optional case-insensitive keywords that must appear in the title, review, alert, or action note. ## `language` (type: `string`): Optional language filter such as en, fr, de, es, or all. ## `sort` (type: `string`): Trustpilot review sort order. ## `requestDelayMs` (type: `integer`): Polite delay between Trustpilot page requests. ## Actor input object example ```json { "companyUrls": [ "trustpilot.com" ], "maxPagesPerCompany": 3, "maxReviewsPerCompany": 100, "minStars": 1, "maxStars": 5, "alertOnly": false, "keywords": [ "refund", "support", "cancel" ], "language": "all", "sort": "recency", "requestDelayMs": 700 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "companyUrls": [ "trustpilot.com" ], "keywords": [ "refund", "support", "cancel" ] }; // Run the Actor and wait for it to finish const run = await client.actor("signalcrawl/trustpilot-competitor-review-monitor").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "companyUrls": ["trustpilot.com"], "keywords": [ "refund", "support", "cancel", ], } # Run the Actor and wait for it to finish run = client.actor("signalcrawl/trustpilot-competitor-review-monitor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "companyUrls": [ "trustpilot.com" ], "keywords": [ "refund", "support", "cancel" ] }' | apify call signalcrawl/trustpilot-competitor-review-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=signalcrawl/trustpilot-competitor-review-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Trustpilot Competitor Review Monitor", "description": "Monitor public Trustpilot business reviews and export reputation intelligence with ratings, sentiment, urgency, response gaps, competitor weakness scores, CRM notes, and dedupe-ready keys.", "version": "0.1", "x-build-id": "esVOoRvK7eu4Dkcch" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalcrawl~trustpilot-competitor-review-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalcrawl-trustpilot-competitor-review-monitor", "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/signalcrawl~trustpilot-competitor-review-monitor/runs": { "post": { "operationId": "runs-sync-signalcrawl-trustpilot-competitor-review-monitor", "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/signalcrawl~trustpilot-competitor-review-monitor/run-sync": { "post": { "operationId": "run-sync-signalcrawl-trustpilot-competitor-review-monitor", "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": [ "companyUrls" ], "properties": { "companyUrls": { "title": "Trustpilot profile URLs or domains", "type": "array", "description": "Trustpilot business profile URLs or plain domains, for example https://www.trustpilot.com/review/example.com or example.com.", "items": { "type": "string" } }, "domains": { "title": "Domains", "type": "array", "description": "Optional plain business domains to monitor. Values are merged with companyUrls.", "items": { "type": "string" } }, "maxPagesPerCompany": { "title": "Max pages per company", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum Trustpilot review pages to request for each company.", "default": 3 }, "maxReviewsPerCompany": { "title": "Max reviews per company", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum unique review intelligence records to save per company.", "default": 100 }, "minStars": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews with at least this Trustpilot star rating.", "default": 1 }, "maxStars": { "title": "Maximum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Keep reviews with at most this Trustpilot star rating.", "default": 5 }, "alertOnly": { "title": "Alert only", "type": "boolean", "description": "When enabled, save only records with meaningful risk or opportunity alerts.", "default": false }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional case-insensitive keywords that must appear in the title, review, alert, or action note.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Optional language filter such as en, fr, de, es, or all.", "default": "all" }, "sort": { "title": "Sort", "enum": [ "recency", "relevance" ], "type": "string", "description": "Trustpilot review sort order.", "default": "recency" }, "requestDelayMs": { "title": "Request delay in ms", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Polite delay between Trustpilot page requests.", "default": 700 } } }, "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 } } } } } } } } } } ```