{
"openapi": "3.0.1",
"info": {
"title": "Agoda Reviews Scraper",
"description": "[💰$3.5/1k] Extract Agoda hotel reviews with traveler type, language & rating filters. Sort by most recent, highest/lowest rated, or most helpful. Perfect for hotel reputation monitoring, competitor analysis, and sentiment analysis.",
"version": "0.0",
"x-build-id": "33IDQ4jX2qJ47HANx"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/epicscrapers~agoda-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-epicscrapers-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/epicscrapers~agoda-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-epicscrapers-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/epicscrapers~agoda-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-epicscrapers-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",
"properties": {
"hotelUrls": {
"title": "Hotel URLs",
"type": "array",
"description": "Paste one or more Agoda hotel page URLs. The scraper will extract the hotel ID from each page automatically.
Example: https://www.agoda.com/hotels/.../hotel.html",
"items": {
"type": "string"
}
},
"hotelIds": {
"title": "Hotel IDs",
"type": "array",
"description": "Add numeric Agoda hotel IDs to scrape.
You can find the hotel ID in the URL after /hotels/. Leave empty if you're using URLs above.",
"items": {
"type": "string"
}
},
"maxReviews": {
"title": "Max reviews per hotel",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Maximum number of reviews to fetch per hotel. If fewer reviews are available, all will be returned. Start with a small number (e.g. 20) for a test run.
🔍 Need all reviews? Set this to 10000.",
"default": 20
},
"sort": {
"title": "Sort order",
"enum": [
"1",
"7",
"2",
"3"
],
"type": "string",
"description": "Choose how reviews are ordered before scraping. \"Most recent\" gives you the freshest feedback first.",
"default": "1"
},
"demographic": {
"title": "Traveler type",
"enum": [
"0",
"1",
"2",
"3",
"4",
"5",
"6"
],
"type": "string",
"description": "Filter reviews by the type of traveler who wrote them.",
"default": "0"
},
"provider": {
"title": "Review source",
"enum": [
"-1",
"332",
"3038"
],
"type": "string",
"description": "Choose which platform's reviews to fetch.",
"default": "-1"
},
"includeCumulative": {
"title": "Include cumulative scores",
"type": "boolean",
"description": "When enabled, each review in the dataset will include a _cumulative field with the hotel's aggregate review scores, breakdown by category (staff, cleanliness, location, etc.), and review filters.
This adds extra data useful for analysis but is not needed for most use cases. Disabled by default to keep dataset items smaller.",
"default": false
},
"rateLimit": {
"title": "Rate limit (ms)",
"minimum": 100,
"maximum": 10000,
"type": "integer",
"description": "Delay between pagination requests. Increase this (e.g. to 2000) if you encounter rate-limiting or IP blocks during large runs.",
"default": 500
}
}
},
"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
}
}
}
}
}
}
}
}
}
}