{ "openapi": "3.0.1", "info": { "title": "KKday Tours Scraper", "description": "[💰 $1.70 / 1K] Extract KKday tours, activities, and experiences at scale — names, prices (from/original/discount), star ratings, review counts, supplier details, destinations, categories, images, and video clips. Search by destination keyword or paste KKday list, search, and category page URLs.", "version": "1.0", "x-build-id": "VBv5bea77GDf9Ixyc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~kkday-tours-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-kkday-tours-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/solidcode~kkday-tours-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-kkday-tours-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/solidcode~kkday-tours-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-kkday-tours-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": { "searchQueries": { "title": "Search Terms", "type": "array", "description": "Destinations, activities, or keywords to search on KKday, such as \"Tokyo\", \"Universal Studios\", or \"Bali diving\". Each term runs its own search. Leave empty if you are pasting URLs below.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional. Paste KKday listing page URLs directly — search results (e.g. https://www.kkday.com/en/search?keyword=tokyo), category pages, or country/city pages. Any page number in the URL is respected. Use this instead of, or alongside, search terms.", "items": { "type": "string" } }, "language": { "title": "Language / Market", "enum": [ "en-us", "en-au", "en-sg", "en-my", "en-ph", "en-hk", "zh-tw", "zh-hk", "zh-cn", "ja", "ko", "th", "vi" ], "type": "string", "description": "The KKday market and language for results. This controls the language of tour names, descriptions, and destination names.", "default": "en-us" }, "currency": { "title": "Currency", "enum": [ "USD", "TWD", "HKD", "SGD", "MYR", "THB", "JPY", "KRW", "PHP", "VND", "IDR", "CNY", "AUD", "EUR", "GBP" ], "type": "string", "description": "The currency tour prices are returned in. Leave on the default to use the market's standard currency.", "default": "USD" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of tours to return across all searches and URLs. Set to 0 for unlimited — collect every tour found, up to a safety ceiling of about 3,000 tours per search (well above KKday's inventory for any single keyword). The last page is always collected in full, so a run may return slightly more than this number.", "default": 100 }, "ignoreUrlFailures": { "title": "Continue on Errors", "type": "boolean", "description": "Keep running when a single search term or URL fails — a URL we can't turn into a KKday search, or a search we can't reach after several tries — by skipping it with a warning and moving on. Turn this off to stop the whole run as soon as any search term or URL fails. (A valid search that simply finds no tours is not a failure — it is reported as an empty result either way.)", "default": true } } }, "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 } } } } } } } } } }