{ "openapi": "3.0.1", "info": { "title": "Agoda Reviews Scraper", "description": "Extract hundreds of reviews per hotel in minutes. including the ones Agoda's own page never shows you. Paste a hotel URL and get clean, structured review data: ratings, guest text in both the original language and yours, traveller types, stay dates, room types, photos and owner replies.", "version": "0.0", "x-build-id": "b9w11M2sn9xH3Q0yY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reviewly~agoda-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reviewly-agoda-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/reviewly~agoda-reviews-scraper/runs": { "post": { "operationId": "runs-sync-reviewly-agoda-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/reviewly~agoda-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-reviewly-agoda-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": "Start URLs", "type": "array", "description": "Agoda hotel URLs to scrape, e.g. https://www.agoda.com/ibis-budapest-city/hotel/budapest-hu.html. The /reviews/ variant of a hotel URL works too.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviews": { "title": "Max reviews per hotel", "minimum": 0, "type": "integer", "description": "Stop after this many reviews per hotel. 0 means collect everything reachable.", "default": 0 }, "fastMode": { "title": "Fast mode", "type": "boolean", "description": "Fetch only the single default page of reviews (about 120 per hotel, one API call) instead of sweeping every review language. Much faster and cheaper, but on the test property that is 121 reviews against 670-760 for a full sweep.", "default": true }, "language": { "title": "Output language", "enum": [ "en-us", "de-de", "fr-fr", "es-es", "it-it", "pt-pt", "nl-nl", "ru-ru", "ja-jp", "ko-kr", "zh-cn", "zh-tw", "th-th", "id-id", "vi-vn" ], "type": "string", "description": "Language Agoda should translate the reviews into. The untranslated text is kept in originalTitle/originalComment regardless.", "default": "en-us" }, "includeDemographicSweep": { "title": "Also sweep traveller types", "type": "boolean", "description": "After the language sweep, sweep six traveller types (solo, couple, family, business, …). On the test hotel this added 70-150 reviews that no language filter surfaced. Ignored in fast mode.", "default": false }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Pause between API calls. Agoda throttles per exit IP by returning empty review lists; the actor detects that, retries and rotates its proxy session, but a delay keeps it from happening in the first place. A full sweep is roughly 85 calls per hotel (34 review languages plus the traveller-type pass), so this setting has a real effect on run time.", "default": 500 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Recommended, and important once you scrape more than one hotel or run on a schedule: Agoda rate-limits per exit IP and a full sweep is 85-115 calls per hotel. Note that Agoda's throttling is largely random per request rather than a lasting per-IP ban, so the retry ladder recovers most reviews and a proxy did not measurably raise the count on a single property. The actor rotates to a fresh session whenever it detects throttling." } } }, "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 } } } } } } } } } }