{ "openapi": "3.0.1", "info": { "title": "Traveloka Hotel Reviews Scraper - Guest Ratings & Replies", "description": "Scrape Traveloka hotel & activity reviews - guest reviews, 1-10 ratings, category sub-scores, owner replies, reviewer data, photos and full timestamps, with LLM-ready markdown. Structured JSON/CSV for analytics, AI and market research. No login.", "version": "1.0", "x-build-id": "5xjYyjds61tLWrCHI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/factden~traveloka-hotel-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-factden-traveloka-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/factden~traveloka-hotel-reviews-scraper/runs": { "post": { "operationId": "runs-sync-factden-traveloka-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/factden~traveloka-hotel-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-factden-traveloka-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "🌐 Traveloka hotel or activity URLs", "maxItems": 500, "type": "array", "description": "Traveloka hotel (/hotel/…) or activity (/activities/…/product/…) URLs. Mix freely - each is scraped in the en-en locale (English text, original-language body preserved). Up to 500 URLs per run.", "items": { "type": "string" } }, "maxReviews": { "title": "🔢 Max reviews per listing", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum reviews to extract per hotel or activity.", "default": 200 }, "sortBy": { "title": "🔀 Sort order", "enum": [ "mostRecent", "mostRelevant", "mostHelpful" ], "type": "string", "description": "Order reviews are returned in (and, with a per-listing cap, which ones are kept first). The date and rating filters below are always applied to every review independently of the sort.", "default": "mostRecent" }, "fromDate": { "title": "📅 From date", "type": "string", "description": "Only include reviews submitted on or after this date (YYYY-MM-DD). Applied to every review found, so incremental runs return exactly the reviews posted since your last sync." }, "minRating": { "title": "🌟 Minimum rating (1 = worst, 10 = best)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Minimum overall rating to include, on Traveloka's 10-point scale (matches the website).", "default": 1 }, "maxRating": { "title": "🌟 Maximum rating (1 = worst, 10 = best)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum overall rating to include, on Traveloka's 10-point scale (matches the website). The default of 10 means no cap (all reviews); set a specific value like 5 to keep only lower-rated reviews (5/10 or below).", "default": 10 }, "includePartnerReviews": { "title": "🌐 Include partner-source reviews", "type": "boolean", "description": "Traveloka shows native reviews PLUS reviews aggregated from partner sites (Expedia, Agoda, Booking and others). Leave ON (default) to capture every review the listing displays, each tagged with its real source in the reviewProvider field. Turn OFF to return native Traveloka reviews only.", "default": true }, "proxyConfiguration": { "title": "🛡️ Proxy configuration", "type": "object", "description": "Apify Residential proxy by default (recommended - Traveloka blocks most datacenter IPs).", "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 } } } } } } } } } }