{ "openapi": "3.0.1", "info": { "title": "Hotel Reviews Monitor - New Agoda, Trip.com, Kurzurlaub Reviews", "description": "For hotel revenue managers and review-alert tools: only the new guest reviews from Agoda, Trip.com and Kurzurlaub.de, with rating, date, text, reviewer, room and the hotel's reply. One property took 2-29 s in production runs (2026-09-23). For daily or hourly schedules; nothing new = one free row.", "version": "0.1", "x-build-id": "39tg3Gslg7gYRG2iD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~hotel-reviews-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-hotel-reviews-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/neverempty~hotel-reviews-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-hotel-reviews-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/neverempty~hotel-reviews-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-hotel-reviews-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": { "propertyUrls": { "title": "Property URLs", "type": "array", "description": "Hotel page URLs from Agoda (https://www.agoda.com/marine-hotel/hotel/dublin-ie.html), Trip.com (https://www.trip.com/hotels/beijing-hotel-detail-375126/) or Kurzurlaub.de (https://www.kurzurlaub.de/hotel/mosel_saar/lieser/hotel-schloss-lieser.html). Up to 20 per run; one property per run keeps each run to a few seconds. Each run returns only the reviews that are new since the last run for that property.", "items": { "type": "string" } }, "maxReviewsFirstRun": { "title": "Reviews to return on the first check", "minimum": 0, "maximum": 500, "type": "integer", "description": "The first time a property is checked, return this many of its newest reviews and only remember the rest. 0 = return none and start watching from now. Empty = 10. A first check reads at most 50 reviews on Kurzurlaub.de and about 10 on Trip.com, so a larger number returns no more there. Later runs return every new review." }, "includeOtherSites": { "title": "Agoda: include Booking.com and Priceline reviews", "type": "boolean", "description": "Agoda also shows reviews it takes from Booking.com and Priceline.com. On (or empty) = return them too, with reviewSite saying where each one comes from. Off = only reviews written on Agoda. Switching it starts a new watch for Agoda properties (the next run is a first check again)." }, "watchName": { "title": "Watch name", "type": "string", "description": "Optional. Runs with the same watch name share what has already been returned. Give different names to two schedules that watch the same property for different purposes, so each gets every new review. Letters, digits, dot, dash and underscore." }, "resetMonitoringState": { "title": "Reset monitoring state", "type": "boolean", "description": "Forget what this watch remembered for these properties at the start of this run, so this run is a first check again. Turn it off again for scheduled runs, or every run starts over and returns the same reviews again." } } }, "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 } } } } } } } } } }