{ "openapi": "3.0.1", "info": { "title": "Klook Hotels Scraper", "description": "Extract Klook hotel listings with hotel names, prices, ratings, reviews, locations, room details, amenities, discounts, images, and booking URLs. Ideal for hotel price monitoring, travel market research, competitor analysis, accommodation datasets, and travel apps.", "version": "0.0", "x-build-id": "akdfHOxVtKxmjd1QV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~Klook-Hotels-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-Klook-Hotels-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~Klook-Hotels-Scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-Klook-Hotels-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~Klook-Hotels-Scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-Klook-Hotels-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": { "startUrl": { "title": "Hotel listing URL", "type": "string", "description": "Optional Klook hotels/searchresult/ URL for a city, district, landmark or hotel search. Takes priority over location. Hotel detail URLs are not supported." }, "location": { "title": "Location", "type": "string", "description": "City, district or landmark to search when no listing URL is supplied. Use a URL to identify an ambiguous destination precisely.", "default": "Dubai" }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Optional YYYY-MM-DD date. Supply both check-in and check-out dates. Overrides the URL check-in date." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Optional YYYY-MM-DD date after check-in. Overrides the URL check-out date. Without dates, Klook supplies suggested-date prices." }, "adults": { "title": "Adults", "minimum": 1, "type": "integer", "description": "Number of adults, at least 1. Overrides URL occupancy; otherwise the URL value or 2 is used." }, "rooms": { "title": "Rooms", "minimum": 1, "type": "integer", "description": "Number of rooms, at least 1. Overrides the URL room count; otherwise the URL value or 1 is used." }, "childAges": { "title": "Child age", "minimum": 0, "maximum": 17, "type": "integer", "description": "Optional age from 0 to 17 for one child. Overrides the URL child count and ages. Leave unset to preserve URL occupancy or use no children. For multiple children, provide their ages in the listing URL." }, "sortBy": { "title": "Sort order", "enum": [ "hotel_score", "review_score" ], "type": "string", "description": "Choose Klook's recommended order or guest review score, highest first. Overrides URL sorting when supplied. Price sorting is not offered because displayed prices are not reliably ordered." }, "resultsWanted": { "title": "Maximum hotels", "minimum": 1, "type": "integer", "description": "Maximum number of unique hotel listings to save. Fewer may be returned when matching properties or available pages are exhausted.", "default": 20 }, "maxPages": { "title": "Maximum pages", "minimum": 1, "type": "integer", "description": "Maximum listing pages to request. Each source page normally contains up to 20 hotel cards.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are recommended for reliable Klook access. Explicit proxy settings are preserved; access is not guaranteed.", "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 } } } } } } } } } }