# Agoda Property Details by URL (`burbn/agoda-property-details`) Actor Scrape any Agoda property in seconds. Get live prices, review scores, full photo galleries, amenities & policies from a hotel URL. Bulk URLs supported - download structured data instantly. - **URL**: https://apify.com/burbn/agoda-property-details.md - **Developed by:** [Kevin](https://apify.com/burbn) (community) - **Categories:** Travel, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 Property Details by URL **πŸ›ŽοΈ Extract complete Agoda hotel/property details straight from an Agoda property URL β€” name, star rating, address, review scores, images, amenities, policies, nearby attractions, and pricing. Scrape one or many properties in a single run.** --- ### πŸ“‹ Table of Contents - [✨ Features](#-features) - [🎯 Use Cases](#-use-cases) - [⚑ Quick Start](#-quick-start) - [πŸ“Š Input Parameters](#-input-parameters) - [πŸ“€ Output Format](#-output-format) - [❓ FAQ](#-faq) - [πŸ› οΈ Troubleshooting](#️-troubleshooting) - [🏷️ Tags](#️-tags) --- ### ✨ Features - **πŸ”— URL-based Extraction** – Just paste an Agoda hotel page URL - **🏨 Rich Property Data** – Name, star rating, type, address, and coordinates - **⭐ Review Insights** – Overall score, score text, total reviews, and per-provider breakdown - **πŸ–ΌοΈ Full Image Gallery** – All property images plus image category counts - **🧰 Amenities & Policies** – Grouped facilities, child policies, extra-bed rules, and more - **πŸ“ Location Context** – Nearby attractions, essentials (airports, transport, hospitals), and a static map - **πŸ’± Flexible Pricing** – Set stay dates, occupancy, and currency - **πŸ“¦ Batch Mode** – Scrape multiple property URLs in one run --- ### 🎯 Use Cases | Use Case | Description | Key Benefits | |----------|-------------|--------------| | 🏨 Hotel Research | Pull complete details for specific properties | Compare hotels quickly | | πŸ’° Rate Monitoring | Track per-night pricing for chosen dates | Spot deals and trends | | πŸ“Š Market Analysis | Analyze ratings, amenities, and positioning | Competitive insights | | πŸ—ΊοΈ Travel Planning | Gather location, attractions, and policies | Build trip itineraries | | πŸ€– Data Pipelines | Feed structured hotel data to your systems | Automation & dashboards | --- ### ⚑ Quick Start #### 1️⃣ Basic – Single Property ```json { "propertyUrls": [ "https://www.agoda.com/en-in/centara-grand-mirage-beach-resort/hotel/pattaya-th.html?ds=FeCgpmQUAsQiYEpQ" ] } ```` #### 2️⃣ Advanced – Multiple Properties with Stay Details ```json { "propertyUrls": [ "https://www.agoda.com/millennium-hilton-bangkok_13/hotel/bangkok-th.html", "https://www.agoda.com/en-in/centara-grand-mirage-beach-resort/hotel/pattaya-th.html" ], "checkIn": "2026-09-10", "checkOut": "2026-09-12", "adults": 2, "rooms": 1, "currency": "USD" } ``` *** ### πŸ“Š Input Parameters | Parameter | Type | Required | Description | Default | |-----------|------|----------|-------------|---------| | `propertyUrls` | Array | βœ… Yes | One or more Agoda hotel page URLs | - | | `checkIn` | String | ❌ No | ISO date `YYYY-MM-DD`. Defaults to +30 days | API default | | `checkOut` | String | ❌ No | ISO date `YYYY-MM-DD`. Defaults to +32 days | API default | | `adults` | Integer | ❌ No | Adults per room | `2` | | `rooms` | Integer | ❌ No | Number of rooms | `1` | | `currency` | String | ❌ No | ISO currency code for returned prices | `USD` | #### πŸ”— Supported URL Forms - `https://www.agoda.com/-h/hotel/-.html` (id in slug β€” fastest) - `https://www.agoda.com//hotel/-.html` (clean slug) *** ### πŸ“€ Output Format #### 🧾 Property Data Structure (abridged) ```json { "source": "agoda_property_details", "input_url": "https://www.agoda.com/.../hotel/pattaya-th.html", "check_in": "2026-09-10", "check_out": "2026-09-12", "adults": 2, "rooms": 1, "currency": "USD", "property_id": 52152, "property_type": "NormalProperty", "name": "Centara Grand Mirage Beach Resort Pattaya", "star_rating": 5, "accommodation_type": 34, "agoda_url": "https://www.agoda.com/.../hotel/pattaya-th.html", "city": "Pattaya", "area": "Wong Amat Beach", "country": "Thailand", "postal_code": "20150", "review_score": 8.6, "review_count": 23569, "review_score_text": "Excellent", "cheapest_room_per_night_inclusive": null, "main_image": "https://pix8.agoda.net/hotelImages/.../image.jpeg", "image_count": 180, "highlights": [], "amenity_groups": [], "policies": {}, "nearby_attractions": [], "nearby_essentials": [], "static_map_url": "//maps.googleapis.com/maps/api/staticmap?...", "scraped_at": "2026-06-10T00:00:00.000Z" } ``` #### πŸ“‹ Key Output Fields | Field | Type | Description | |-------|------|-------------| | `source` | String | Always `agoda_property_details` | | `input_url` | String | The Agoda URL you provided | | `property_id` | Number | Agoda property identifier | | `property_type` | String | Property type (e.g., NormalProperty) | | `name` | String | Property display name | | `star_rating` | Number | Star rating | | `city` / `area` / `country` / `postal_code` | String | Address parts | | `address` | Object | Full address object (incl. IDs) | | `review_score` | Number | Overall review score | | `review_count` | Number | Total number of reviews | | `review_score_text` | String | Score label (e.g., "Excellent") | | `reviews_by_provider` | Array | Per-provider score breakdown | | `cheapest_room_*` | Mixed | Cheapest room name/price fields | | `main_image` | String | First image URL | | `images` | Array | All image URLs | | `image_count` | Number | Number of images | | `image_categories` | Array | Image category counts | | `description` | String | Full property description (HTML) | | `highlights` | Array | Property highlights | | `things_youll_love` | Array | Notable features | | `amenity_groups` | Array | Grouped facilities/amenities | | `policies` | Object | Child, infant, extra-bed, and other policies | | `nearby_attractions` | Array | Points of interest nearby | | `nearby_essentials` | Array | Airports, transport, hospitals, shopping, etc. | | `static_map_url` | String | Static map image URL | | `scraped_at` | String | ISO timestamp of extraction | > Failed URLs are still written to the dataset with `error: true` and an `error_message`, so nothing is silently dropped. *** ### ❓ FAQ - **Q: What input do I need?** - At least one Agoda property URL. Stay dates, occupancy, and currency are optional. - **Q: Can I scrape multiple hotels at once?** - Yes. Add several URLs to `propertyUrls` and the actor processes them sequentially. - **Q: What if I don't set check-in/check-out?** - The API defaults to +30/+32 days from today. - **Q: Why is `cheapestRoom` sometimes empty?** - Pricing depends on availability for the chosen dates, occupancy, and currency. Try different dates. - **Q: Which currencies are supported?** - Common ISO codes including USD, EUR, GBP, INR, THB, AUD, SGD, JPY, and more. *** ### πŸ› οΈ Troubleshooting | Issue | Cause | Solution | |-------|-------|----------| | ❌ "No property URL provided" | Empty `propertyUrls` | Add at least one Agoda URL | | ❌ "Invalid Agoda URL" | URL is not an agoda.com link | Use a valid Agoda hotel page URL | | ❌ "Property not found" | Wrong or expired URL | Re-copy the URL from Agoda | | ⏱️ "Rate limit exceeded" | Too many requests | Wait and retry | | ⚠️ Empty pricing | No availability for dates | Adjust check-in/check-out or occupancy | *** ### 🏷️ Tags `agoda scraper`, `agoda hotel details`, `agoda property api`, `agoda hotel data scraper`, `agoda url scraper`, `agoda hotel details extractor`, `agoda travel data`, `agoda hotel pricing`, `agoda reviews`, `hotel amenities scraper`, `apify actor`, `agoda hotel research tool`, `agoda data extraction` *** ### 🎁 Get $5 Free Apify Credits New to Apify? [Sign up using this link](https://apify.com?fpr=free-credits) and get **$5 free credits** to start extracting Agoda Property Details right away! No credit card required. ### πŸš€ Get Started Now 1. πŸ”— Paste one or more **Agoda property URLs** 2. πŸ“… (Optional) Set **check-in / check-out**, **adults**, **rooms**, and **currency** 3. ▢️ Click **Start** to run the actor 4. πŸ“₯ Download your data in JSON, CSV, Excel, or HTML format ### πŸ“ž Support For questions, feedback, or custom requests regarding the Agoda Property Details actor, please contact us through Apify or open a support issue. *Built with ❀️ using the Apify Platform | Optimized for Performance & Reliability* # Actor input Schema ## `propertyUrls` (type: `array`): πŸ“‹ Add one or more Agoda hotel page URLs. Supported forms: β€’ https://www.agoda.com/-h/hotel/-.html (id in slug β€” fastest) β€’ https://www.agoda.com//hotel/-.html (clean slug) ## `checkIn` (type: `string`): πŸ—“οΈ ISO date (YYYY-MM-DD). If left empty, the API defaults to +30 days from today. ## `checkOut` (type: `string`): πŸ—“οΈ ISO date (YYYY-MM-DD). If left empty, the API defaults to +32 days from today. ## `adults` (type: `integer`): πŸ§‘β€πŸ€β€πŸ§‘ Number of adults per room. ## `rooms` (type: `integer`): πŸšͺ Number of rooms to price. ## `currency` (type: `string`): πŸ’° ISO currency code for returned prices. ## Actor input object example ```json { "propertyUrls": [ "https://www.agoda.com/en-in/centara-grand-mirage-beach-resort/hotel/pattaya-th.html?ds=FeCgpmQUAsQiYEpQ" ], "checkIn": "2026-09-10", "checkOut": "2026-09-12", "adults": 2, "rooms": 1, "currency": "USD" } ``` # Actor output Schema ## `property_details` (type: `string`): Open the dataset view with an overview of all scraped properties including name, star rating, location, review score, pricing, and more. # 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 = { "propertyUrls": [ "https://www.agoda.com/en-in/centara-grand-mirage-beach-resort/hotel/pattaya-th.html?ds=FeCgpmQUAsQiYEpQ" ], "checkIn": "2026-09-10", "checkOut": "2026-09-12", "adults": 2, "rooms": 1, "currency": "USD" }; // Run the Actor and wait for it to finish const run = await client.actor("burbn/agoda-property-details").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 = { "propertyUrls": ["https://www.agoda.com/en-in/centara-grand-mirage-beach-resort/hotel/pattaya-th.html?ds=FeCgpmQUAsQiYEpQ"], "checkIn": "2026-09-10", "checkOut": "2026-09-12", "adults": 2, "rooms": 1, "currency": "USD", } # Run the Actor and wait for it to finish run = client.actor("burbn/agoda-property-details").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 '{ "propertyUrls": [ "https://www.agoda.com/en-in/centara-grand-mirage-beach-resort/hotel/pattaya-th.html?ds=FeCgpmQUAsQiYEpQ" ], "checkIn": "2026-09-10", "checkOut": "2026-09-12", "adults": 2, "rooms": 1, "currency": "USD" }' | apify call burbn/agoda-property-details --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=burbn/agoda-property-details", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Agoda Property Details by URL", "description": "Scrape any Agoda property in seconds. Get live prices, review scores, full photo galleries, amenities & policies from a hotel URL. Bulk URLs supported - download structured data instantly.", "version": "1.0", "x-build-id": "YXXlFKwXZrxHXagIb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burbn~agoda-property-details/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burbn-agoda-property-details", "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/burbn~agoda-property-details/runs": { "post": { "operationId": "runs-sync-burbn-agoda-property-details", "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/burbn~agoda-property-details/run-sync": { "post": { "operationId": "run-sync-burbn-agoda-property-details", "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": [ "propertyUrls" ], "properties": { "propertyUrls": { "title": "πŸ”— Agoda Property URLs", "minItems": 1, "maxItems": 10, "type": "array", "description": "πŸ“‹ Add one or more Agoda hotel page URLs. Supported forms:\nβ€’ https://www.agoda.com/-h/hotel/-.html (id in slug β€” fastest)\nβ€’ https://www.agoda.com//hotel/-.html (clean slug)", "items": { "type": "string" } }, "checkIn": { "title": "πŸ“… Check-in Date", "type": "string", "description": "πŸ—“οΈ ISO date (YYYY-MM-DD). If left empty, the API defaults to +30 days from today." }, "checkOut": { "title": "πŸ“… Check-out Date", "type": "string", "description": "πŸ—“οΈ ISO date (YYYY-MM-DD). If left empty, the API defaults to +32 days from today." }, "adults": { "title": "πŸ‘₯ Adults per Room", "minimum": 1, "maximum": 30, "type": "integer", "description": "πŸ§‘β€πŸ€β€πŸ§‘ Number of adults per room.", "default": 2 }, "rooms": { "title": "πŸ›οΈ Number of Rooms", "minimum": 1, "maximum": 30, "type": "integer", "description": "πŸšͺ Number of rooms to price.", "default": 1 }, "currency": { "title": "πŸ’± Currency", "enum": [ "USD", "EUR", "GBP", "INR", "THB", "AUD", "CAD", "SGD", "JPY", "CNY", "HKD", "MYR", "IDR", "PHP", "VND", "KRW", "AED", "SAR", "CHF", "SEK", "NZD", "ZAR", "BRL", "RUB", "TRY" ], "type": "string", "description": "πŸ’° ISO currency code for returned prices.", "default": "USD" } } }, "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 } } } } } } } } } } ```