{ "openapi": "3.0.1", "info": { "title": "Fast Agoda Reviews Scraper", "description": "Scraper to get reviews from hotels, apartments and other accommodations listed on the Agoda.com portal. Extract data using hotel URLs for review text, ratings, stars, basic reviewer info, length of stay, liked/disliked parts, room info, date of stay and more. Download in JSON, HTML, Excel, CSV.", "version": "0.0", "x-build-id": "Mc5HCKRWTC1tNsZZ1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/knagymate~fast-agoda-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-knagymate-fast-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/knagymate~fast-agoda-reviews-scraper/runs": { "post": { "operationId": "runs-sync-knagymate-fast-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/knagymate~fast-agoda-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-knagymate-fast-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": [ "hotelUrl" ], "properties": { "hotelUrl": { "title": "Hotel URL", "type": "string", "description": "URL of hotel to scrape reviews from.", "default": "https://www.agoda.com/ibis-budapest-city/hotel/budapest-hu.html?cid=1844104" }, "rating": { "title": "Rating", "type": "array", "description": "Filter reviews by rating. Optional. If not set, reviews of all ratings will be scraped.", "items": { "type": "string", "enum": [ "all", "exceptional", "excellent", "very_good", "good", "below_expectation" ], "enumTitles": [ "All", "9+ Exceptional", "8-9 Excellent", "7-8 Very Good", "6-7 Good", "<6 Below Expectation" ] } }, "enabledProviders": { "title": "Enabled review providers", "minItems": 1, "type": "array", "description": "Choose which review providers to include in the output. At least one provider must be selected.", "items": { "type": "string", "enum": [ "Agoda", "Booking.com" ], "enumTitles": [ "Agoda", "Booking.com" ] }, "default": [ "Agoda", "Booking.com" ] }, "language": { "title": "Review Language", "enum": [ "all", "en", "fr", "de", "es", "ja", "zh-HK", "ko", "el", "pt-PT", "nl", "en-CA", "en-GB", "en-AU", "zh-TW", "en-NZ", "th", "vi", "sv", "pl", "no", "da", "tr", "ca", "hu", "ro", "he", "lt", "hr", "et" ], "type": "string", "description": "Filter reviews by a specific language. Optional. If not set, reviews from all languages will be scraped.", "default": "all" }, "cutoffDate": { "title": "Cutoff date", "type": "string", "description": "Scraper will return reviews newer than this date if it is provided." }, "aggregateRatings": { "title": "Aggregate ratings", "type": "boolean", "description": "Whether to return hotel aggregate ratings and detailed review scores next to reviews.", "default": true }, "maxReviewsPerHotel": { "title": "Maximum reviews per hotel", "minimum": 1, "type": "integer", "description": "Maximum number of reviews to scrape per hotel.", "default": 1000 } } }, "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 } } } } } } } } } }