{ "openapi": "3.0.1", "info": { "title": "Skyscanner Hotels Review Scraper", "description": "Extract Skyscanner hotel reviews, guest ratings, feedback, scores, and property insights at scale. Collect structured hotel review data for travel research, sentiment analysis, reputation monitoring, market intelligence, and hospitality analytics.", "version": "0.0", "x-build-id": "iSFVdF4kyfO9qSJFo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~Skyscanner-Hotels-Review-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-Skyscanner-Hotels-Review-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/shahidirfan~Skyscanner-Hotels-Review-Scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-Skyscanner-Hotels-Review-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/shahidirfan~Skyscanner-Hotels-Review-Scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-Skyscanner-Hotels-Review-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Skyscanner hotel URLs", "type": "array", "description": "One or more public Skyscanner hotel detail URLs containing an ht- hotel ID.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sortBy": { "title": "Sort reviews", "enum": [ "recommended", "rating_high_to_low", "rating_low_to_high", "most_recent" ], "type": "string", "description": "Choose the order in which reviews are collected.", "default": "recommended" }, "locale": { "title": "Output locale", "type": "string", "description": "Locale used for translated review content and labels, for example en-GB or en-US.", "default": "en-GB" }, "travellerRating": { "title": "Traveller rating", "enum": [ "all", "rating_excellent", "rating_good", "rating_average", "rating_below_average" ], "type": "string", "description": "Only collect reviews in the selected rating group.", "default": "all" }, "reviewLanguage": { "title": "Review language", "type": "string", "description": "Use all for every language, or enter a locale such as en-GB, es-ES, or de-DE.", "default": "all" }, "guestType": { "title": "Guest type", "enum": [ "all", "family", "business", "solo", "group", "couple", "other" ], "type": "string", "description": "Only collect reviews from the selected traveller group.", "default": "all" }, "provider": { "title": "Review provider", "enum": [ "all", "e_ct", "h_h1", "h_xp", "h_vs" ], "type": "string", "description": "Only collect reviews supplied by a selected provider.", "default": "all" }, "tags": { "title": "Review topics", "type": "array", "description": "Optionally require reviews with photos or matching selected topics.", "items": { "type": "string", "enum": [ "with_images", "location", "room", "service", "clean", "transportation", "meal", "quiet", "bathroom", "restaurant", "scenery", "parking", "shop", "family", "business", "gym", "wifi", "laundry", "pool" ], "enumTitles": [ "With photos", "Location", "Room", "Service", "Cleanliness", "Transportation", "Meals", "Quiet", "Bathroom", "Restaurant", "Views", "Parking", "Shopping area", "Family", "Business", "Gym", "WiFi", "Laundry", "Pool" ] }, "default": [] }, "results_wanted": { "title": "Maximum reviews", "minimum": 1, "type": "integer", "description": "Maximum total number of unique reviews saved across all input URLs.", "default": 20 }, "max_pages": { "title": "Maximum pages per hotel", "minimum": 1, "type": "integer", "description": "Safety cap for review pages requested from each hotel. Each page contains up to 10 reviews.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy or your own proxy URLs for reliable production runs.", "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 } } }, "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 } } } } } } } } } }