{ "openapi": "3.0.1", "info": { "title": "Hrs Hotels Reviews Scraper", "description": "Scrape guest reviews from any HRS hotel to JSON, CSV or Excel. Exports review text, 1-10 ratings, per-category scores, traveller type, dates and hotel replies — no login or API key needed. Sweeps all seven HRS locales so you get every published review, not just the ones in one language.", "version": "0.0", "x-build-id": "oijY5SYwLkUMCqPyM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reviewly~hrs-hotels-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reviewly-hrs-hotels-reviews-scraper", "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/reviewly~hrs-hotels-reviews-scraper/runs": { "post": { "operationId": "runs-sync-reviewly-hrs-hotels-reviews-scraper", "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/reviewly~hrs-hotels-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-reviewly-hrs-hotels-reviews-scraper", "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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "HRS hotel page URLs, e.g. https://www.hrs.com/en/hotel/391864 or https://www.hrs.de/de/hotel/391864. Any locale of the same hotel works — the scraper reads the hotel ID out of the URL and then visits every language itself. Leave empty if you are using Hotel IDs instead.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "hotelIds": { "title": "Hotel IDs", "type": "array", "description": "HRS numeric hotel IDs, one per line, e.g. 391864. The hotel ID is the number at the end of a hotel URL: hrs.com/en/hotel/. Use this instead of Start URLs, or alongside them — a hotel listed in both is only scraped once.", "items": { "type": "string" } }, "languages": { "title": "Languages", "type": "array", "description": "Which HRS language sites to collect from. Leave empty to sweep all of them, which is what you want in almost every case: an HRS hotel page only shows the reviews written in that page's language, so the complete review set is the union of all seven. Restricting this is for when you only want reviews in specific languages.", "items": { "type": "string", "enum": [ "de", "en", "es", "fr", "it", "nl", "pl" ], "enumTitles": [ "German", "English", "Spanish", "French", "Italian", "Dutch", "Polish" ] } }, "maxReviews": { "title": "Max reviews per hotel", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to keep per hotel, newest first. 0 means no limit. This trims the result after collection — it does not make the run cheaper, because HRS ships a whole language's reviews in one page load.", "default": 0 }, "targetDate": { "title": "Only reviews after", "type": "string", "description": "Skip reviews posted before this date (ISO 8601, e.g. 2025-01-01). Useful for incremental runs — set it to the date of your last run." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy by default. HRS serves its hotel pages without a bot wall, so the actor also runs fine on datacenter proxy or with no proxy at all — but residential IPs are the safest choice on long multi-hotel runs and give the retry loop a clean IP to fall back on.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }