# Agoda Hotel Rates Scraper (`xtracto/agoda-hotels-scraper`) Actor Scrape Agoda hotels by destination or hotel ID: name, star rating, review score and count, live nightly price (with/without tax, before-discount), coordinates, address, and room offers. Pick your dates, guests, and currency. No login. - **URL**: https://apify.com/xtracto/agoda-hotels-scraper.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 99.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Agoda Hotel Rates Scraper Extract hotels and live nightly prices from Agoda — by destination or by specific hotel. For every hotel you get its name, star rating, guest review score and review count, exact coordinates, address, the cheapest available price (with and without taxes/fees, plus the before-discount price), and the cheapest room offers with their cancellation policy. Choose your own check-in/check-out dates, number of guests, and currency. ### Why use this actor - **No account, no login, no API key** required. - **Real, dated prices** — the price for the exact stay dates, guests, and currency you ask for, not a vague "from" figure. - **Two ways to search** — sweep every hotel in a destination, or track specific hotels by their Agoda property ID (ideal for rate-parity and price monitoring over time). - **Rich structured fields** — star rating, guest review score and count, latitude/longitude, full address, and per-room offers. - **Any currency** — prices come back in the currency you choose (USD, EUR, SGD, GBP, …). - **Stable JSON output** ready for spreadsheets, databases, dashboards, or pipelines. Export to JSON, CSV, or Excel. - **Runs on a schedule** with automatic retries — no scrapers, browsers, or blocks to babysit. ### How it works 1. Choose a **mode**: *Search* a destination, or pull *Property* detail + rates for specific hotel IDs. 2. Enter your **destinations** (city or place names) or **hotel property IDs**, your **check-in / check-out** dates, **guests**, and **currency**. 3. The actor matches each place name to the right Agoda destination automatically, then collects every hotel with its live price and review data. 4. Each hotel becomes one clean row in your dataset, which you can download or feed into another system. You do not manage any of the retrieval, retries, or formatting — just the inputs above. ### Input #### Search mode ```json { "mode": "search", "destinations": ["Singapore"], "checkIn": "2026-08-10", "checkOut": "2026-08-11", "adults": 2, "children": 0, "rooms": 1, "currency": "USD", "fetchRooms": true, "maxItems": 100, "maxItemsPerSearch": 200, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` #### Property mode (detail + rates for specific hotels) ```json { "mode": "property", "propertyIds": ["185945"], "checkIn": "2026-08-10", "checkOut": "2026-08-11", "adults": 2, "children": 0, "rooms": 1, "currency": "EUR", "fetchRooms": true } ``` | Field | Type | Description | | --- | --- | --- | | `mode` | string | `search` (find hotels in a destination) or `property` (detail + rates for specific hotel IDs). | | `destinations` | array | City / place names to search, e.g. `Singapore`, `Tokyo`, `Bali`. Search mode. | | `searchUrls` | array | Optional Agoda search URLs that contain a city id, e.g. `https://www.agoda.com/search?city=4064`. Search mode. | | `propertyIds` | array | Agoda numeric hotel IDs, e.g. `185945` (Marina Bay Sands). Property mode. | | `checkIn` | string | Check-in date `YYYY-MM-DD`. Defaults to ~30 days out. | | `checkOut` | string | Check-out date `YYYY-MM-DD`. One night after check-in by default. | | `adults` | integer | Adult guests to price for (default 2). | | `children` | integer | Children in the party (default 0). | | `rooms` | integer | Rooms to price (default 1). | | `currency` | string | Currency code the prices are returned in, e.g. `USD`, `EUR`, `SGD`. | | `fetchRooms` | boolean | Include the cheapest room offers (price + cancellation policy) on each record. | | `maxItems` | integer | Overall cap on hotel records for the run (0 = no limit). | | `maxItemsPerSearch` | integer | Cap per destination. Agoda serves 45 hotels per page. | | `proxyConfiguration` | object | Residential proxy recommended for stable, geo-consistent results. | ### Output #### Search mode — one row per hotel ```json { "_input": "Singapore", "_source": "S1-citysearch", "_scrapedAt": "2026-07-09T20:36:50Z", "recordType": "HOTEL", "propertyId": 335555, "hotelName": "Dorsett Changi City Singapore", "starRating": 4.0, "reviewScore": 8.6, "reviewCount": 7860, "latitude": 1.3343963623046875, "longitude": 103.96414184570312, "address": "Changi, Singapore", "city": "Singapore", "cityId": 4064, "propertyType": "Hotel", "url": "https://www.agoda.com/dorsett-changi-city-singapore/hotel/singapore-sg.html", "checkIn": "2026-08-10", "checkOut": "2026-08-11", "occupancy": { "adults": 2, "children": 0, "rooms": 1 }, "currency": "USD", "isAvailable": true, "soldOut": false, "cheapestPrice": 164.67, "priceInclusive": 197.43, "priceExclusive": 164.67, "beforeDiscountPrice": 164.67, "rooms": [ { "roomName": null, "price": 164.67, "priceInclusive": 197.43, "beforeDiscountPrice": 164.67, "currency": "USD", "cancellation": "NonRefundable", "availableRooms": 65, "supplierId": 332 } ] } ``` #### Property mode — one row per hotel (detail + rates) ```json { "_input": "185945", "_source": "S1-property", "_scrapedAt": "2026-07-09T20:37:12Z", "recordType": "PROPERTY", "propertyId": 185945, "hotelName": "Marina Bay Sands", "starRating": 5.0, "reviewScore": 8.9, "reviewCount": 48807, "latitude": 1.2836209535598755, "longitude": 103.86072540283203, "address": "10 Bayfront Avenue, Marina Bay, Singapore", "city": "Singapore", "cityId": 4064, "propertyType": "Hotel", "url": "https://www.agoda.com/marina-bay-sands/hotel/singapore-sg.html", "checkIn": "2026-08-10", "checkOut": "2026-08-11", "occupancy": { "adults": 2, "children": 0, "rooms": 1 }, "currency": "EUR", "isAvailable": true, "soldOut": false, "cheapestPrice": 744.45, "priceInclusive": 892.60, "priceExclusive": 744.45, "beforeDiscountPrice": 744.45, "rooms": [ { "roomName": null, "price": 744.45, "priceInclusive": 892.60, "beforeDiscountPrice": 744.45, "currency": "EUR", "cancellation": "FreeCancellation", "availableRooms": 50, "supplierId": 332 } ] } ``` | Field | Type | Description | | --- | --- | --- | | `propertyId` | integer | Agoda's unique hotel ID. | | `hotelName` | string | Hotel name. | | `starRating` | number | Official star rating (1–5). | | `reviewScore` | number | Guest review score out of 10. | | `reviewCount` | integer | Number of guest reviews. | | `latitude` / `longitude` | number | Hotel coordinates. | | `address` | string | Street/area, city, country. | | `city` / `cityId` | string / integer | City name and Agoda city ID. | | `propertyType` | string | e.g. Hotel, Resort, Apartment. | | `url` | string | Agoda hotel page. | | `checkIn` / `checkOut` | string | The dates the price applies to. | | `occupancy` | object | Adults, children, rooms the price is for. | | `currency` | string | Currency of all prices in the record. | | `isAvailable` / `soldOut` | boolean | Availability for the requested stay. | | `cheapestPrice` | number | Cheapest nightly price, excluding taxes/fees. | | `priceInclusive` | number | Cheapest nightly price including taxes/fees. | | `priceExclusive` | number | Cheapest nightly price excluding taxes/fees. | | `beforeDiscountPrice` | number | Nightly price before any discount. | | `rooms` | array | Cheapest available room offers (price, taxes, cancellation policy, rooms left). Present when `fetchRooms` is on. | ### Notes & limits - **Prices are per night** for the requested dates, guests, and rooms, in your chosen currency. - **Search returns 45 hotels per page**; raise `maxItemsPerSearch` for more, or use several destinations for volume. - A small share of hotels can show as sold out (no price) for a given date/occupancy — those rows carry `isAvailable: false`. - In search results, room offers reflect the **cheapest** available option, so `roomName` may be blank; use property mode for a specific hotel. - For **rate-parity / price tracking**, run property mode on a schedule with the same `propertyIds` across different dates — each run captures that day's live price. - Residential proxy (any country) is recommended for the most consistent results. ### Other travel actors | Actor | What it does | | --- | --- | | Booking.com Hotels Scraper | Hotel search results from Booking.com by destination and dates. | | Agoda Hotel Rates Scraper | This actor — Agoda hotels, live rates, and review data. | # Actor input Schema ## `mode` (type: `string`): 'Search' finds all hotels in a destination with live prices. 'Property' pulls rich detail + room rates for specific hotels by their Agoda property ID (great for rate tracking across dates). ## `destinations` (type: `array`): City, region, or place names to search, e.g. Singapore, Tokyo, Bali. Each is matched to an Agoda destination automatically. ## `searchUrls` (type: `array`): Paste Agoda search URLs that contain a city id, e.g. https://www.agoda.com/search?city=4064 . Used in Search mode alongside (or instead of) destinations. ## `propertyIds` (type: `array`): Agoda numeric property IDs to pull detail + room rates for, e.g. 185945 (Marina Bay Sands). Used only in Property mode. ## `checkIn` (type: `string`): Check-in date in YYYY-MM-DD format. Defaults to about 30 days from today if left blank. ## `checkOut` (type: `string`): Check-out date in YYYY-MM-DD format. One night after check-in by default. ## `adults` (type: `integer`): Number of adult guests to price the stay for. ## `children` (type: `integer`): Number of children in the party. ## `rooms` (type: `integer`): Number of rooms to price. ## `currency` (type: `string`): ISO currency code the prices are returned in, e.g. USD, EUR, SGD, GBP. ## `fetchRooms` (type: `boolean`): Add a list of the cheapest available room offers (price, cancellation policy) to each hotel record. ## `maxItems` (type: `integer`): Overall cap on the number of hotel records for the whole run. ## `maxItemsPerSearch` (type: `integer`): Cap on hotels returned per destination. Agoda serves 45 hotels per page. ## `proxyConfiguration` (type: `object`): Residential proxy is recommended for stable, geo-consistent results. ## Actor input object example ```json { "mode": "search", "destinations": [ "Singapore" ], "searchUrls": [], "propertyIds": [ "185945" ], "checkIn": "2026-08-10", "checkOut": "2026-08-11", "adults": 2, "children": 0, "rooms": 1, "currency": "USD", "fetchRooms": true, "maxItems": 100, "maxItemsPerSearch": 200, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "destinations": [ "Singapore" ], "searchUrls": [], "propertyIds": [ "185945" ], "checkIn": "2026-08-10", "checkOut": "2026-08-11", "currency": "USD" }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/agoda-hotels-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "destinations": ["Singapore"], "searchUrls": [], "propertyIds": ["185945"], "checkIn": "2026-08-10", "checkOut": "2026-08-11", "currency": "USD", } # Run the Actor and wait for it to finish run = client.actor("xtracto/agoda-hotels-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "destinations": [ "Singapore" ], "searchUrls": [], "propertyIds": [ "185945" ], "checkIn": "2026-08-10", "checkOut": "2026-08-11", "currency": "USD" }' | apify call xtracto/agoda-hotels-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/agoda-hotels-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Agoda Hotel Rates Scraper", "description": "Scrape Agoda hotels by destination or hotel ID: name, star rating, review score and count, live nightly price (with/without tax, before-discount), coordinates, address, and room offers. Pick your dates, guests, and currency. No login.", "version": "0.1", "x-build-id": "k7M4tzQ5PP4GA8Yjg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~agoda-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-agoda-hotels-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/xtracto~agoda-hotels-scraper/runs": { "post": { "operationId": "runs-sync-xtracto-agoda-hotels-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/xtracto~agoda-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-xtracto-agoda-hotels-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": { "mode": { "title": "Mode", "enum": [ "search", "property" ], "type": "string", "description": "'Search' finds all hotels in a destination with live prices. 'Property' pulls rich detail + room rates for specific hotels by their Agoda property ID (great for rate tracking across dates).", "default": "search" }, "destinations": { "title": "Destinations", "type": "array", "description": "City, region, or place names to search, e.g. Singapore, Tokyo, Bali. Each is matched to an Agoda destination automatically.", "items": { "type": "string" } }, "searchUrls": { "title": "Agoda search URLs (optional)", "type": "array", "description": "Paste Agoda search URLs that contain a city id, e.g. https://www.agoda.com/search?city=4064 . Used in Search mode alongside (or instead of) destinations.", "items": { "type": "string" } }, "propertyIds": { "title": "Hotel property IDs (Property mode)", "type": "array", "description": "Agoda numeric property IDs to pull detail + room rates for, e.g. 185945 (Marina Bay Sands). Used only in Property mode.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Defaults to about 30 days from today if left blank." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Check-out date in YYYY-MM-DD format. One night after check-in by default." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of adult guests to price the stay for.", "default": 2 }, "children": { "title": "Children", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of children in the party.", "default": 0 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of rooms to price.", "default": 1 }, "currency": { "title": "Currency", "type": "string", "description": "ISO currency code the prices are returned in, e.g. USD, EUR, SGD, GBP." }, "fetchRooms": { "title": "Include room offers", "type": "boolean", "description": "Add a list of the cheapest available room offers (price, cancellation policy) to each hotel record.", "default": true }, "maxItems": { "title": "Max hotels total (0 = no limit)", "minimum": 0, "type": "integer", "description": "Overall cap on the number of hotel records for the whole run.", "default": 100 }, "maxItemsPerSearch": { "title": "Max hotels per destination", "minimum": 1, "type": "integer", "description": "Cap on hotels returned per destination. Agoda serves 45 hotels per page.", "default": 200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxy is recommended for stable, geo-consistent results.", "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 } } }, "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 } } } } } } } } } } ```