# Google Business Review Response Priority Scorer (`rotvuvo/google-business-review-response-priority-scorer`) Actor Score imported Google Business Profile review rows into response priorities, SLA, issue themes, risk flags, response angles, and escalation actions. Use it after a Google review scraper, GBP export, reputation tool, spreadsheet, or manual queue. - **URL**: https://apify.com/rotvuvo/google-business-review-response-priority-scorer.md - **Developed by:** [Wit Nomad](https://apify.com/rotvuvo) (community) - **Categories:** Marketing, SEO tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Google Business Review Response Priority Scorer Turn imported Google Business/Profile review rows into a response queue with priority scores, risk flags, issue themes, suggested response angle, SLA, and next action. This Actor is an ingest-first scoring layer. It does not scrape Google, does not log in to Google Business Profile, and does not post replies. Use it after an existing Apify Google Maps/Reviews scraper, Google Business Profile export, reputation-management export, spreadsheet, or manual review queue. ### What it does - Normalizes common Google review row fields from Apify and spreadsheet exports. - Scores each review for response urgency using star rating, missing owner response, review sentiment, and escalation keywords. - Flags sensitive cases such as refunds, legal/safety/health complaints, discrimination language, and churn-risk wording. - Detects practical issue themes such as service, quality, pricing, scheduling, safety, and praise. - Emits a queue-ready dataset with priority, SLA, suggested response angle, and escalation action. ### Input Provide `items`, a non-empty array of imported review rows. Common aliases include `reviewId`, `businessName`, `rating`, `reviewText`, `publishedAtDate`, and `ownerResponse`. Optional `businessProfile` controls escalation preferences and SLA defaults. ### Output fields Each dataset item includes `responsePriorityScore`, `priority`, `sentiment`, `issueThemes`, `riskFlags`, `responseStatus`, `suggestedResponseAngle`, `escalationAction`, `slaHours`, `confidence`, and data-quality warnings. ### Example use cases - Local SEO agencies triaging unanswered 1-3 star reviews across clients. - Multi-location brands routing sensitive reviews to managers before public replies. - Reputation teams turning raw Google review exports into daily response queues. - Automations that send only high-priority reviews to Slack, CRM, or a ticket queue. ### Limitations - This Actor does not scrape Google Maps or Google Business Profile. - It does not draft final legal/compliance-approved replies and does not auto-post responses. - It uses deterministic keyword/rating rules, not live AI sentiment calls. - It only analyzes fields supplied in the input rows; missing or stale review data lowers confidence. - Suggested response angle is operational guidance, not legal advice or a guarantee of review removal, ranking improvement, or customer recovery. ### Local run ```bash npm install npm test node src/main.js --input ../../samples/google-business-reviews/google-business-review-response-priority-scorer-input.json --output /tmp/google-business-review-priority-output.json ```` # Actor input Schema ## `mode` (type: `string`): Input mode. This version supports imported Google Business/Profile review rows only. ## `items` (type: `array`): Rows from existing Apify Google Maps/Reviews scrapers, Google Business Profile exports, reputation tools, spreadsheets, or manual review queues. Common aliases include reviewId/id/reviewUrl, businessName/placeName/title/business\_name, locationName/location/branch/address, rating/stars/reviewRating, reviewText/text/textTranslated/review\_text/comment/content, publishedAtDate/reviewDate/date/timestamp, ownerResponse/responseFromOwnerText/business\_response/ownerResponseText, reviewerName/authorName/name, source/platform/reviewOrigin, categoryName/categories/business\_types. The generic name field is treated as reviewer name, not business name. ## `businessProfile` (type: `object`): Optional brand/location context and escalation preferences. Risk and theme matching uses review text only; business names, categories, and URLs do not trigger escalation keywords. ## `maxItems` (type: `integer`): Maximum imported rows to process. ## `scrapedAt` (type: `string`): Optional ISO timestamp for deterministic output metadata. This Actor does not scrape; when omitted or invalid, the runtime uses this fixed default reference timestamp. ## Actor input object example ```json { "mode": "items", "items": [ { "reviewId": "rev-low-1", "businessName": "Acme Dental Austin", "locationName": "Austin", "rating": 1, "reviewText": "Terrible service. I was overcharged and want a refund. The room felt unsafe and I will never again visit.", "publishedAtDate": "2026-07-07T10:00:00.000Z", "responseFromOwnerText": "" }, { "reviewId": "rev-mixed-1", "businessName": "Acme Dental Round Rock", "rating": 3, "reviewText": "The dentist was helpful, but the wait was slow and the front desk ignored us.", "publishedAtDate": "2026-07-06T16:00:00.000Z" }, { "reviewId": "rev-good-1", "placeName": "Acme Dental Austin", "stars": 5, "text": "Great visit. The staff were friendly and helpful.", "ownerResponse": "Thanks for visiting us!" } ], "businessProfile": { "brandName": "Acme Dental", "locations": [ "Austin", "Round Rock" ], "targetCategories": [ "Dental clinic" ], "escalationKeywords": [ "refund", "injury", "unsafe", "legal" ], "urgentRatingThreshold": 2, "defaultSlaHours": 48, "autoThankRating": 5 }, "maxItems": 500, "scrapedAt": "2026-07-08T00:00:00.000Z" } ``` # 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 = { "mode": "items", "items": [ { "reviewId": "rev-low-1", "businessName": "Acme Dental Austin", "locationName": "Austin", "rating": 1, "reviewText": "Terrible service. I was overcharged and want a refund. The room felt unsafe and I will never again visit.", "publishedAtDate": "2026-07-07T10:00:00.000Z", "responseFromOwnerText": "" }, { "reviewId": "rev-mixed-1", "businessName": "Acme Dental Round Rock", "rating": 3, "reviewText": "The dentist was helpful, but the wait was slow and the front desk ignored us.", "publishedAtDate": "2026-07-06T16:00:00.000Z" }, { "reviewId": "rev-good-1", "placeName": "Acme Dental Austin", "stars": 5, "text": "Great visit. The staff were friendly and helpful.", "ownerResponse": "Thanks for visiting us!" } ], "businessProfile": { "brandName": "Acme Dental", "locations": [ "Austin", "Round Rock" ], "targetCategories": [ "Dental clinic" ], "escalationKeywords": [ "refund", "injury", "unsafe", "legal" ], "urgentRatingThreshold": 2, "defaultSlaHours": 48, "autoThankRating": 5 }, "scrapedAt": "2026-07-08T00:00:00.000Z" }; // Run the Actor and wait for it to finish const run = await client.actor("rotvuvo/google-business-review-response-priority-scorer").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 = { "mode": "items", "items": [ { "reviewId": "rev-low-1", "businessName": "Acme Dental Austin", "locationName": "Austin", "rating": 1, "reviewText": "Terrible service. I was overcharged and want a refund. The room felt unsafe and I will never again visit.", "publishedAtDate": "2026-07-07T10:00:00.000Z", "responseFromOwnerText": "", }, { "reviewId": "rev-mixed-1", "businessName": "Acme Dental Round Rock", "rating": 3, "reviewText": "The dentist was helpful, but the wait was slow and the front desk ignored us.", "publishedAtDate": "2026-07-06T16:00:00.000Z", }, { "reviewId": "rev-good-1", "placeName": "Acme Dental Austin", "stars": 5, "text": "Great visit. The staff were friendly and helpful.", "ownerResponse": "Thanks for visiting us!", }, ], "businessProfile": { "brandName": "Acme Dental", "locations": [ "Austin", "Round Rock", ], "targetCategories": ["Dental clinic"], "escalationKeywords": [ "refund", "injury", "unsafe", "legal", ], "urgentRatingThreshold": 2, "defaultSlaHours": 48, "autoThankRating": 5, }, "scrapedAt": "2026-07-08T00:00:00.000Z", } # Run the Actor and wait for it to finish run = client.actor("rotvuvo/google-business-review-response-priority-scorer").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 '{ "mode": "items", "items": [ { "reviewId": "rev-low-1", "businessName": "Acme Dental Austin", "locationName": "Austin", "rating": 1, "reviewText": "Terrible service. I was overcharged and want a refund. The room felt unsafe and I will never again visit.", "publishedAtDate": "2026-07-07T10:00:00.000Z", "responseFromOwnerText": "" }, { "reviewId": "rev-mixed-1", "businessName": "Acme Dental Round Rock", "rating": 3, "reviewText": "The dentist was helpful, but the wait was slow and the front desk ignored us.", "publishedAtDate": "2026-07-06T16:00:00.000Z" }, { "reviewId": "rev-good-1", "placeName": "Acme Dental Austin", "stars": 5, "text": "Great visit. The staff were friendly and helpful.", "ownerResponse": "Thanks for visiting us!" } ], "businessProfile": { "brandName": "Acme Dental", "locations": [ "Austin", "Round Rock" ], "targetCategories": [ "Dental clinic" ], "escalationKeywords": [ "refund", "injury", "unsafe", "legal" ], "urgentRatingThreshold": 2, "defaultSlaHours": 48, "autoThankRating": 5 }, "scrapedAt": "2026-07-08T00:00:00.000Z" }' | apify call rotvuvo/google-business-review-response-priority-scorer --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rotvuvo/google-business-review-response-priority-scorer", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Business Review Response Priority Scorer", "description": "Score imported Google Business Profile review rows into response priorities, SLA, issue themes, risk flags, response angles, and escalation actions. Use it after a Google review scraper, GBP export, reputation tool, spreadsheet, or manual queue.", "version": "0.1", "x-build-id": "DOaRmbmqvNfOBoN6Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rotvuvo~google-business-review-response-priority-scorer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rotvuvo-google-business-review-response-priority-scorer", "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/rotvuvo~google-business-review-response-priority-scorer/runs": { "post": { "operationId": "runs-sync-rotvuvo-google-business-review-response-priority-scorer", "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/rotvuvo~google-business-review-response-priority-scorer/run-sync": { "post": { "operationId": "run-sync-rotvuvo-google-business-review-response-priority-scorer", "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": [ "items" ], "properties": { "mode": { "title": "Mode", "enum": [ "items" ], "type": "string", "description": "Input mode. This version supports imported Google Business/Profile review rows only.", "default": "items" }, "items": { "title": "Imported review rows", "minItems": 1, "type": "array", "description": "Rows from existing Apify Google Maps/Reviews scrapers, Google Business Profile exports, reputation tools, spreadsheets, or manual review queues. Common aliases include reviewId/id/reviewUrl, businessName/placeName/title/business_name, locationName/location/branch/address, rating/stars/reviewRating, reviewText/text/textTranslated/review_text/comment/content, publishedAtDate/reviewDate/date/timestamp, ownerResponse/responseFromOwnerText/business_response/ownerResponseText, reviewerName/authorName/name, source/platform/reviewOrigin, categoryName/categories/business_types. The generic name field is treated as reviewer name, not business name.", "items": { "type": "object" } }, "businessProfile": { "title": "Business profile", "type": "object", "description": "Optional brand/location context and escalation preferences. Risk and theme matching uses review text only; business names, categories, and URLs do not trigger escalation keywords." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum imported rows to process.", "default": 500 }, "scrapedAt": { "title": "Reference timestamp", "type": "string", "description": "Optional ISO timestamp for deterministic output metadata. This Actor does not scrape; when omitted or invalid, the runtime uses this fixed default reference timestamp.", "default": "2026-07-08T00:00:00.000Z" } } }, "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 } } } } } } } } } } ```