{ "openapi": "3.0.1", "info": { "title": "Booking Reviews Scraper", "description": "Extract guest reviews from any Booking.com hotel in seconds. Collect review text, scores, reviewer and stay details, photos, ratings, and more. Filter by score, date, country, and photo availability, with multi language support. Ideal for professionals who need structured review data fast.", "version": "1.0", "x-build-id": "uoaVKSsqWZXHZXiYq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~booking-com-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-booking-com-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/parseforge~booking-com-reviews-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-booking-com-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/parseforge~booking-com-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-booking-com-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": "Hotel URLs", "type": "array", "description": "One or more Booking.com hotel or reviews page URLs. The tool automatically converts hotel URLs to the matching reviews page.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 100. Paid users: Optional, max 1,000,000" }, "maxReviewsPerHotel": { "title": "Max Reviews Per Hotel", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum reviews to collect from each hotel." }, "sortReviewsBy": { "title": "Sort Reviews By", "enum": [ "f_relevance", "f_score_desc", "f_score_asc" ], "type": "string", "description": "How to order the collected reviews.", "default": "f_relevance" }, "cutoffDate": { "title": "Cutoff Date (UTC)", "type": "string", "description": "Stop collecting when reviews older than this date are found. Works best with default (Relevance) sorting. Format: YYYY-MM-DD." }, "reviewScores": { "title": "Review Scores Filter", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Only collect reviews within these score ranges.", "items": { "type": "string", "enum": [ "ALL", "review_adj_superb", "review_adj_good", "review_adj_average_passable", "review_adj_poor" ], "enumTitles": [ "All scores", "Superb (9-10)", "Good (7-8.9)", "Average/Passable (5-6.9)", "Poor (0-4.9)" ] }, "default": [ "ALL" ] }, "minScore": { "title": "Minimum Score", "minimum": 0, "maximum": 10, "type": "number", "description": "Only collect reviews with a score equal to or above this value (0-10)." }, "onlyWithPhotos": { "title": "Only Reviews With Photos", "type": "boolean", "description": "When enabled, only collect reviews that include photos.", "default": false }, "reviewerCountryIncludes": { "title": "Reviewer Country Contains", "type": "string", "description": "Only collect reviews where the reviewer country contains this text (e.g., 'United' matches 'United States')." }, "language": { "title": "Language", "type": "string", "description": "Language for the review pages (e.g., en-gb, en-us, es, fr, de).", "default": "en-gb" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Not required, but can be enabled if needed." } } }, "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 } } } } } } } } } }