# Agoda Hotel Scraper (`parsebird/agoda-hotel-scraper`) Actor Scrape Agoda hotel data by name, URL or ID: live room prices, offers, ratings, reviews, amenities, rooms, photos and location. Export as JSON, CSV or Excel, or use the API. - **URL**: https://apify.com/parsebird/agoda-hotel-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.49 / 1,000 hotels This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### Agoda Hotel Scraper Agoda Hotel Scraper extracts hotel details, live room prices, ratings and guest reviews from [Agoda](https://www.agoda.com) by hotel name, property URL or hotel ID.
Get date-specific room offers with prices before and after taxes, category scores, up to 50 review comments per hotel, amenities, room details, nearby places and every photo URL in one structured record per hotel.
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ``` Use the Apify Actor parsebird/agoda-hotel-scraper to get Agoda hotel data. Call it with ApifyClient: client.actor("parsebird/agoda-hotel-scraper").call(run_input={"hotelIds": [10715, 10571], "checkIn": "2027-03-15", "lengthOfStay": 1, "adults": 2, "rooms": 1, "includeReviews": true, "reviewsPerHotel": 10}). Inputs (at least one of the first three is required): hotelIds (array of positive integers), propertyUrls (array of Agoda hotel URLs), searchTerms (array of specific hotel names), checkIn (string YYYY-MM-DD, empty = no prices), lengthOfStay (integer 1-30, default 1), adults (integer 1-20, default 2), rooms (integer 1-10, default 1), includeReviews (boolean, default false), reviewsPerHotel (integer 1-50, default 10), maxItems (integer 0-100000, default 0 = no limit), requestDelay (number 0-60 seconds, default 1.5), proxyConfiguration (object, optional). Each dataset item is one hotel with hotel_id, hotel_name, accommodation_type, address, city, country, lat, lng, star_rating, review_score, review_count, category_scores, score_distribution, price (cheapest room per room per night as listed by Agoda before tax, USD), price_with_taxes (same offer, all charges included), currency, rooms_available, offer_count, room_offers, check_in, length_of_stay, room_types, rooms, amenities, amenity_groups, highlights, nearby_attractions, nearby_essentials, check_in_time, check_out_time, description, image_url, image_count, all_images, property_url, reviews, parse_confidence, warnings, scraped_at. API docs: https://apify.com/parsebird/agoda-hotel-scraper/api. Get a token at https://console.apify.com/account/integrations. ``` ### What is Agoda Hotel Scraper? **Agoda Hotel Scraper** is an **Agoda API alternative** that turns public Agoda hotel pages into clean, structured data. Give it **hotel IDs, Agoda URLs or hotel names** and it returns one detailed record per hotel, with **live room prices** for the dates you choose. The easiest way to try it is to open the [Input tab](https://apify.com/parsebird/agoda-hotel-scraper/input-schema), keep the prefilled hotel IDs and press **Start**. No Agoda account or API key is needed. ### What can Agoda Hotel Scraper do? - 🏨 **Three ways to pick hotels:** numeric hotel IDs, property URLs or hotel names, on their own or combined. Duplicates are removed automatically. - 💰 **Live pricing for your dates:** set check-in, nights, adults and rooms to get every sellable room offer. - ⭐ **Guest reviews:** overall score, category scores, score distribution and up to 50 individual review comments per hotel. - 🧭 **Complete hotel profiles:** rooms, amenities by group, nearby landmarks and transport, check-in times, description and all photo URLs. - 🔎 **Built-in quality signals:** every record has a `parse_confidence` score and a `warnings` list, so you can spot incomplete data. As an Apify Actor, it also comes with: - [Scheduling](https://docs.apify.com/platform/schedules) to track hotel prices daily or weekly - [API access](https://apify.com/parsebird/agoda-hotel-scraper/api) from any language - [Integrations](https://apify.com/integrations) with Zapier, Make, Google Sheets, Slack and more - Export to **JSON, CSV, Excel** or HTML - Automatic proxy handling, with no proxy setup needed ### What data can you extract from Agoda? | Group | Fields | Description | |-------|--------|-------------| | Identity | `hotel_id`, `hotel_name`, `former_name`, `accommodation_type` | Agoda ID, name and property type | | Location | `address`, `city`, `country`, `area_name`, `postal_code`, `location_highlight`, `lat`, `lng` | Full address and coordinates | | Ratings | `star_rating`, `review_score`, `review_count`, `review_text`, `category_scores`, `score_distribution`, `awards` | Stars, guest score and score breakdowns | | Pricing | `price`, `price_with_taxes`, `currency`, `rooms_available`, `offer_count`, `room_offers` | Cheapest room per night and every offer | | Requested dates | `check_in`, `length_of_stay` | The dates you asked for | | Rooms | `room_types`, `rooms` | Room names, beds, size, view, features, photo count and thumbnail | | Amenities | `amenities`, `amenity_groups` | Flat list and grouped by category | | Nearby | `highlights`, `nearby_attractions`, `nearby_essentials` | Landmarks, airports and transport, with distances | | Property | `check_in_time`, `check_out_time`, `description` | Stay times and hotel description | | Images | `image_url`, `image_count`, `all_images` | Main photo and all photo URLs | | Reviews | `reviews` | Optional comments with rating, title, text, date, traveller type, country, room type and stay length | | Run details | `property_url`, `parse_confidence`, `warnings`, `scraped_at` | Source link, data quality and UTC timestamp | ### How to scrape Agoda hotels 1. Open [Agoda Hotel Scraper](https://apify.com/parsebird/agoda-hotel-scraper) and go to the **Input** tab. 2. Add **hotel IDs**, **property URLs** or **hotel names**. Specific names work best, such as `The Peninsula Bangkok`. 3. For prices, choose a **check-in date**, then set **nights**, **adults** and **rooms**. 4. Turn on **Include review comments** if you want the text of guest reviews. 5. Press **Start** and wait for the run to finish. 6. Download the results as **JSON, CSV or Excel**, or read them through the API. 7. To monitor prices, add the run to a [Schedule](https://docs.apify.com/platform/schedules). Daily is a good starting point. ### How much does it cost to scrape Agoda? Agoda Hotel Scraper uses pay-per-event pricing. Compute and proxy costs are included in the event price. | Event | Free | Bronze | Silver | Gold | |-------|------|--------|--------|------| | Hotel saved (`hotel-scraped`) | $0.00499 | $0.00449 | $0.00399 | $0.00349 | | **Per 1,000 hotels** | **$4.99** | **$4.49** | **$3.99** | **$3.49** | | Run start (`apify-actor-start`), per GB of memory | $0.005 | $0.005 | $0.005 | $0.005 | You pay for each hotel saved to the dataset. Live pricing and review comments cost nothing extra, and a hotel that can't be retrieved isn't charged. For example, 1,000 hotels on the Free plan cost $4.99 plus the run start fee. Runs stop on their own when they reach your spending limit. ### Input parameters Fill in at least one of `hotelIds`, `propertyUrls` or `searchTerms`. | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | hotelIds | array of integers | No\* | — | Positive numeric Agoda hotel IDs | | propertyUrls | array of strings | No\* | — | Agoda hotel page URLs | | searchTerms | array of strings | No\* | — | Specific hotel names, matched through Agoda's search suggestions | | checkIn | string | No | — | Check-in date in `YYYY-MM-DD`. Without it, no prices are returned | | lengthOfStay | integer | No | 1 | Nights, 1 to 30 | | adults | integer | No | 2 | Adult guests, 1 to 20 | | rooms | integer | No | 1 | Rooms, 1 to 10 | | includeReviews | boolean | No | false | Add individual review comments | | reviewsPerHotel | integer | No | 10 | Maximum comments per hotel, 1 to 50 | | maxItems | integer | No | 0 | Maximum hotels to save, up to 100,000. 0 means no limit | | requestDelay | number | No | 1.5 | Seconds between hotels, 0 to 60 | | proxyConfiguration | object | No | automatic | Optional custom proxy settings | Example input: ```json { "hotelIds": [10715, 10571], "checkIn": "2027-03-15", "lengthOfStay": 1, "adults": 2, "rooms": 1, "includeReviews": true, "reviewsPerHotel": 10, "maxItems": 2 } ``` ### Output example Each hotel is one dataset item. You can download the dataset in JSON, HTML, CSV or Excel. This shortened example comes from a real run; long lists are cut to one item. ```json { "hotel_id": 10715, "hotel_name": "The Peninsula Bangkok", "accommodation_type": "Hotel", "address": "Siam Chaophraya Holdings, 333 Charoennakorn Road, Bangkok Riverside, Bangkok, Thailand, 10600", "city": "Bangkok", "country": "Thailand", "lat": 13.7230730056763, "lng": 100.510955810547, "star_rating": 5.0, "review_score": 9.2, "review_count": 5331, "review_text": "Exceptional", "category_scores": { "cleanliness": 9.6, "facilities": 9.4, "location": 9.0, "roomComfort": 9.3, "staffPerformance": 9.5, "valueForMoney": 9.0 }, "score_distribution": { "exceptional": 2082, "excellent": 406, "very_good": 91, "good": 60, "below_expectation": 60 }, "price": 834.39, "price_with_taxes": 982.08, "currency": "USD", "rooms_available": true, "offer_count": 11, "room_offers": [ { "room_id": 7619240, "name": "Deluxe Twin Room", "price": 834.39, "price_with_taxes": 982.08, "price_before_discount": 1025.82, "discount_percent": 19, "currency": "USD", "free_cancellation": true, "cancellation": "Cancel for free before November 28, 2026", "max_occupancy": 3, "rooms_left": 10, "benefits": ["Cancel for free before November 28, 2026", "Pay to hotel"], "supplier": "Agoda.com" } ], "check_in": "2026-12-28", "length_of_stay": 1, "rooms": [ { "room_id": 7619240, "name": "Deluxe Twin Room", "bed": "2 single beds", "size": "Room size: 45 m²/484 ft²", "view": "Sea view", "features": ["Room size: 45 m²/484 ft²", "Sea view", "2 single beds"], "image_count": 15 } ], "nearby_essentials": [ { "category": "Airports", "name": "Don Mueang International Airport (DMK)", "distance_km": 23.43, "distance_text": "23.43 km" } ], "check_in_time": "02:00 PM", "check_out_time": "12:00 PM", "image_count": 87, "property_url": "https://www.agoda.com/the-peninsula-bangkok/hotel/bangkok-th.html", "reviews": [ { "review_id": 1201251052, "rating": 10.0, "title": "Excellent", "check_in_month": "October 2026", "review_date": "2026-10-30T09:37:26+07:00", "reviewer_type": "Couple", "reviewer_country": "United Kingdom", "room_type": "Deluxe Room", "stay_length": 3 } ], "parse_confidence": 1.0, "warnings": [] } ``` ### Use the Agoda API alternative in Python and JavaScript Get your token on the [Integrations page](https://console.apify.com/account/integrations). See the [Apify API docs](https://docs.apify.com/api/v2) for more. **Python** ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("parsebird/agoda-hotel-scraper").call(run_input={ "searchTerms": ["The Peninsula Bangkok"], "checkIn": "2027-03-15", "lengthOfStay": 2, "adults": 2, "rooms": 1, }) for hotel in client.dataset(run["defaultDatasetId"]).iterate_items(): print(hotel["hotel_name"], hotel["price"], hotel["currency"]) ``` **JavaScript** ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const run = await client.actor('parsebird/agoda-hotel-scraper').call({ hotelIds: [10715, 10571], includeReviews: true, reviewsPerHotel: 20, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((hotel) => console.log(hotel.hotel_name, hotel.review_score)); ``` ### Use cases - **Hotel price monitoring:** schedule runs for the same dates and watch how rates change. - **Competitor rate tracking:** compare your property with nearby hotels on price, score and availability. - **Travel apps and comparison sites:** feed hotel profiles, rooms, photos and amenities into your product. - **Review analysis:** study what guests praise or complain about, by traveller type and country. - **Market research:** compare star ratings, scores and pricing across hotels and cities. ### How it works 1. The Actor turns your hotel names and URLs into Agoda hotel IDs and removes duplicates. 2. It requests each hotel's public data in English, with prices in USD. 3. If you set a check-in date, it requests the room offers for your dates and confirms that Agoda answered for those exact dates. 4. It optionally adds review comments, scores the record's completeness and saves it to the dataset. ### Is it legal to scrape Agoda? This Actor collects only publicly available hotel information and requires no login. Web scraping of public data is generally legal, but results may include personal data protected by regulations such as the GDPR, and Agoda's terms of service may apply to your use. Review comments can contain text written by individuals, so collect and use them only for a legitimate reason. If you're unsure, ask your lawyer. You can read more in Apify's post on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Other travel scrapers from ParseBird - [Hotels.com Scraper](https://apify.com/parsebird/hotels-com-scraper) - [Airbnb Scraper & API](https://apify.com/parsebird/airbnb-scraper) - [Expedia Reviews Scraper](https://apify.com/parsebird/expedia-reviews-scraper) - [HolidayCheck.de Hotels Scraper](https://apify.com/parsebird/holidaycheck-hotels-scraper) - [HRS Hotel Reviews Scraper](https://apify.com/parsebird/hrs-hotel-reviews-scraper) - [GetYourGuide Tours & Activities Scraper](https://apify.com/parsebird/getyourguide-scraper) ### FAQ **Does Agoda have a public API?** Agoda offers an affiliate program, but this Actor needs no Agoda partner account or API key. Use it as an Agoda API alternative through the [Apify API](https://apify.com/parsebird/agoda-hotel-scraper/api). **What does the `price` field mean?** It's the cheapest room offer per room, per night, as Agoda lists it before tax. Agoda decides which charges count as tax by the visitor's location, so a service charge can be in or out of this number. `price_with_taxes` is the same offer with everything included and didn't change with location in our tests, so use it to compare hotels. All prices are in USD. **Why are the prices empty?** Prices need a valid `checkIn`. Without one, or with a past date, you get hotel details only. Agoda also doesn't sell dates too far ahead, so the Actor leaves prices empty and explains why in `warnings` rather than returning prices for other dates. If `rooms_available` is `false`, Agoda had no offers for that hotel and stay. **Why does the `rooms` list change when I add a date?** With a date, it lists only the room types Agoda can sell for that stay. Without a date, or when nothing is available, it lists the hotel's rooms in general. **Can I scrape every hotel in a city?** Not with search terms alone. Agoda's suggestions focus on named hotels, and a broad term like `Bangkok` usually returns regions, so it finds few or no hotels. Provide property URLs or hotel IDs for a full list. **Why did a hotel name return several hotels, or none?** Names are matched against Agoda's suggestions, keeping only hotels that fit your words. Include the city, as in `Mandarin Oriental Tokyo`. For an exact hotel, use its URL or ID. **How many review comments can I get?** Up to 50 per hotel, in Agoda's default review order. The `review_count` field always shows the hotel's full total. Agoda has no comment text for some hotels; those records have an empty `reviews` list and a note in `warnings`. **What happens when something goes wrong?** The key-value store's `OUTPUT` record summarises each run. `emptyReason` is `NO_MATCH_FOR_INPUT` when nothing matched, and `stoppedEarly` is `INPUT_PARTIAL` or `BLOCK_PARTIAL` when only some inputs worked. Failed hotels aren't charged. **Can I integrate this with other tools?** Yes. You can connect runs to [Zapier, Make, Google Sheets, Slack and more](https://apify.com/integrations), or use webhooks and the API. **Something isn't working or a field is missing. What should I do?** Please open a ticket on the **Issues** tab. We read every report and welcome feature requests. # Changelog This Actor's version history is a separate document: https://apify.com/parsebird/agoda-hotel-scraper/changelog.md # Actor input Schema ## `hotelIds` (type: `array`): Add numeric Agoda hotel IDs. This is the most reliable way to pick hotels. ## `propertyUrls` (type: `array`): Paste full Agoda hotel page URLs, for example https://www.agoda.com/the-peninsula-bangkok/hotel/bangkok-th.html. ## `searchTerms` (type: `array`): Enter specific hotel names, for example The Peninsula Bangkok. Agoda's search suggestions turn each name into hotels. A broad destination such as Bangkok returns few or no hotels because Agoda suggests regions for it, so use URLs or IDs instead. ## `checkIn` (type: `string`): Pick a check-in date (YYYY-MM-DD) to get live room prices and offers. Leave empty for hotel details without prices. Past dates and dates Agoda does not sell yet return hotel details without prices. ## `lengthOfStay` (type: `integer`): Set the number of nights, from 1 to 30. ## `adults` (type: `integer`): Set the number of adult guests, from 1 to 20. ## `rooms` (type: `integer`): Set the number of rooms, from 1 to 10. ## `includeReviews` (type: `boolean`): Turn on to add individual guest review comments to each hotel. Scores and review counts are always included. ## `reviewsPerHotel` (type: `integer`): Set the maximum number of review comments per hotel, from 1 to 50. ## `maxItems` (type: `integer`): Limit how many hotels to save, up to 100,000. Use 0 for no limit. ## `requestDelay` (type: `number`): Set the wait between hotels, from 0 to 60 seconds. ## `proxyConfiguration` (type: `object`): Optional. Without a proxy, the Actor picks one automatically and switches to residential proxies if Agoda blocks it. ## Actor input object example ```json { "hotelIds": [ 10715, 10571 ], "checkIn": "2027-03-15", "lengthOfStay": 1, "adults": 2, "rooms": 1, "includeReviews": false, "reviewsPerHotel": 10, "maxItems": 2, "requestDelay": 1.5 } ``` # Actor output Schema ## `dataset` (type: `string`): No description # 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 = { "hotelIds": [ 10715, 10571 ], "checkIn": "2027-03-15", "maxItems": 2 }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/agoda-hotel-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 = { "hotelIds": [ 10715, 10571, ], "checkIn": "2027-03-15", "maxItems": 2, } # Run the Actor and wait for it to finish run = client.actor("parsebird/agoda-hotel-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "hotelIds": [ 10715, 10571 ], "checkIn": "2027-03-15", "maxItems": 2 }' | apify call parsebird/agoda-hotel-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/agoda-hotel-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/vfpUiiHgfITdf7cDX/builds/on6VocX8XUVMbnH3K/openapi.json