{
"openapi": "3.0.1",
"info": {
"title": "Review Monitor: Google Maps, Tripadvisor & Trustpilot",
"description": "Get new reviews from Google Maps, Tripadvisor and Trustpilot in one clean format: rating, text, date, owner reply and a rating snapshot per business. Newest first, rating and date filters, and an only-new mode for scheduled review alerts. Pay per review.",
"version": "1.0",
"x-build-id": "xhi4ERYdHHEYn8qbt"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/vncntlabs~review-monitor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-vncntlabs-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/vncntlabs~review-monitor/runs": {
"post": {
"operationId": "runs-sync-vncntlabs-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/vncntlabs~review-monitor/run-sync": {
"post": {
"operationId": "run-sync-vncntlabs-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",
"properties": {
"googlePlaces": {
"title": "Google Maps places",
"type": "array",
"description": "One per line: the business's Google Maps link (best: open it on Google Maps and copy the URL or the share link), a place ID (ChIJ…), or Business name, City. Names are matched by Google, so check businessName in the results.",
"items": {
"type": "string"
}
},
"tripadvisorUrls": {
"title": "Tripadvisor pages",
"type": "array",
"description": "One per line: the Tripadvisor page of a hotel, restaurant or attraction (contains _Review-g…-d…), any Tripadvisor country domain.",
"items": {
"type": "string"
}
},
"trustpilotDomains": {
"title": "Trustpilot companies",
"type": "array",
"description": "One per line: the company's website domain (zappos.com) or its Trustpilot page (trustpilot.com/review/zappos.com).",
"items": {
"type": "string"
}
},
"maxReviewsPerBusiness": {
"title": "Max reviews per business",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Newest first, up to 1000. In only-new mode this is the most new reviews returned per business per run.",
"default": 100
},
"minRating": {
"title": "Minimum stars",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "Only reviews with at least this many stars.",
"default": 1
},
"maxRating": {
"title": "Maximum stars",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "Only reviews with at most this many stars, e.g. 2 for negative-review alerts.",
"default": 5
},
"reviewsNewerThan": {
"title": "Only reviews newer than",
"type": "string",
"description": "Optional: a date (2026-10-01) or a period (7 days, 24 hours, 2 weeks, 3 months)."
},
"country": {
"title": "Google country",
"enum": [
"Argentina",
"Australia",
"Austria",
"Bangladesh",
"Belgium",
"Brazil",
"Bulgaria",
"Canada",
"Chile",
"Colombia",
"Costa Rica",
"Croatia",
"Cyprus",
"Czechia",
"Denmark",
"Dominican Republic",
"Ecuador",
"Egypt",
"Estonia",
"Finland",
"France",
"Germany",
"Greece",
"Hong Kong",
"Hungary",
"Iceland",
"India",
"Indonesia",
"Ireland",
"Israel",
"Italy",
"Japan",
"Kenya",
"Kuwait",
"Latvia",
"Lithuania",
"Luxembourg",
"Malaysia",
"Malta",
"Mexico",
"Morocco",
"Netherlands",
"New Zealand",
"Nigeria",
"Norway",
"Pakistan",
"Peru",
"Philippines",
"Poland",
"Portugal",
"Puerto Rico",
"Qatar",
"Romania",
"Saudi Arabia",
"Serbia",
"Singapore",
"Slovakia",
"Slovenia",
"South Africa",
"South Korea",
"Spain",
"Sweden",
"Switzerland",
"Taiwan",
"Thailand",
"Turkiye",
"Ukraine",
"United Arab Emirates",
"United Kingdom",
"United States",
"Uruguay",
"Vietnam"
],
"type": "string",
"description": "Google Maps only: the Google edition used to look the place up.",
"default": "United States"
},
"language": {
"title": "Google language",
"type": "string",
"description": "Google Maps only: language code (en, de, es, pt-BR...). Google may translate reviews into this language; the original text is kept in originalText when available.",
"default": "en"
},
"onlyNewReviews": {
"title": "Only new reviews (monitoring)",
"type": "boolean",
"description": "For scheduled runs: remembers the reviews delivered before and returns only new ones, plus each business's rating and review-count change since the last check. The first run returns the latest reviews as a baseline. History is kept in your Apify account (key-value store 'review-monitor').",
"default": false
},
"monitorId": {
"title": "Monitor name",
"type": "string",
"description": "Optional. Name the monitor to keep its history stable when you edit the list, e.g. my-restaurants."
},
"includeReviewerDetails": {
"title": "Include reviewer names and profiles",
"type": "boolean",
"description": "Off by default: reviewer names, profile links and locations are personal data and are left out. Turn on only if you need them (for example to reply to reviewers) and have a lawful basis to process them.",
"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
}
}
}
}
}
}
}
}
}
}