{ "openapi": "3.0.1", "info": { "title": "Skyscanner Hotel Reviews Scraper API $1/1k — Aggregated Reviews", "description": "Pull hotel reviews from Skyscanner, aggregated from partners such as Hotels.com, Expedia and Tripadvisor in one call. Full review text, rating, source, dates, images and hotel replies. Optional AI review insights answer any question about a hotel's reviews. $1/1k, JSON or CSV.", "version": "0.0", "x-build-id": "XwXXra2jEt03y0f08" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~skyscanner-hotel-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-skyscanner-hotel-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/memo23~skyscanner-hotel-reviews-scraper/runs": { "post": { "operationId": "runs-sync-memo23-skyscanner-hotel-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/memo23~skyscanner-hotel-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-skyscanner-hotel-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": "Skyscanner hotel page URLs, the kind ending in …/ht-129259677. The hotel id is read from the ht- part.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "A Skyscanner hotel URL." } }, "required": [ "url" ] } }, "hotelIds": { "title": "Hotel IDs", "type": "array", "description": "Skyscanner hotel ids (numeric), for example 129259677. The hotels scraper returns them in its hotelId field. Not needed when startUrls has a hotel URL.", "items": { "type": "string" } }, "maxReviewsPerHotel": { "title": "Max reviews per hotel", "minimum": 1, "type": "integer", "description": "Maximum reviews to fetch per hotel. Reviews are fetched 50 at a time until this is reached.", "default": 50 }, "maxItems": { "title": "Max hotels", "minimum": 1, "type": "integer", "description": "Maximum number of hotels to process.", "default": 10 }, "sortBy": { "title": "Sort by", "enum": [ "SORT_TYPE_MOST_RECENT", "SORT_TYPE_RATING_DESC", "SORT_TYPE_RATING_ASC", "SORT_TYPE_RECOMMENDED" ], "type": "string", "description": "Sort order for reviews. Most recent and the rating sorts are also applied by the actor, so rows come back in that order: Skyscanner sorts some hotels only in batches.", "default": "SORT_TYPE_MOST_RECENT" }, "includeReviewInsight": { "title": "Include AI review insight", "type": "boolean", "description": "Ask an AI a question about each hotel's reviews and get a hotelSays + travellersSay summary. The answer comes back in English whatever the language setting. Add-on: $0.01 per hotel answered (a hotel with no reviews is skipped and not charged).", "default": false }, "reviewInsightQuestion": { "title": "Review insight question", "type": "string", "description": "The question asked about each hotel's reviews, for example \"Is the breakfast good?\" or \"Is it quiet at night?\". Used only when the AI review insight is on.", "default": "What do guests say about this hotel?" }, "locale": { "title": "Language", "type": "string", "description": "Language reviews are returned in. Reviews written in another language come back translated, and translationType says which. Pick one or type another locale code.", "default": "en-GB" }, "market": { "title": "Market", "type": "string", "description": "Country Skyscanner answers from. Pick one or type another country code.", "default": "GB" }, "proxy": { "title": "Proxy", "type": "object", "description": "Proxy configuration (non-paying users). Paying users use our residential pool automatically." } } }, "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 } } } } } } } } } }