# Agoda Scraper: Hotel Prices, Room Types and Reviews (`themineworks/agoda-scraper`) Actor

Scrape Agoda hotels by city and dates: one row per hotel with star rating, review score, nightly price with and without taxes, stay total, free cancellation, rooms left and every room type, or Agoda guest reviews per hotel. No login.

- **URL**: https://apify.com/themineworks/agoda-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Travel, E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.35 / 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 Scraper: Hotel Prices, Room Types and Reviews

[![45 Agoda hotels with prices for your dates in 6 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/agoda-scraper-hero.png)](https://console.apify.com/actors/SBlY5ha5sjVbyf377/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns Agoda hotels for any city and your dates, one row per hotel with star rating, review score, nightly price before and after taxes, the total for the stay, free cancellation and rooms left, and, if you want them, every room type with its cheapest rate. A second mode returns Agoda guest reviews, one row per review. No login, no cookies, no API key. You pay $3.60 per 1,000 hotels on the Free plan and $1.35 per 1,000 on the Gold plan; reviews are $5.40 per 1,000 on Free and $2.70 on Gold, plus a $0.002 start fee per run.

From **The Mine Works**, makers of [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), with over 335,000 runs across 330+ public actors.

Updated 12 Nov 2026: first release. City search by dates, guests and currency, taxes split out, room types per hotel, hotel links, and guest reviews from Agoda and Booking.com in one actor. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **The price a guest really pays, in columns.** Every row has `price_per_night`, `price_per_night_with_taxes`, `taxes_and_fees_per_night` and the stay total with and without taxes, plus the crossed out price and discount Agoda shows. Every hotel is priced in one answer: in our test runs 1,004 of 1,005 rows passed every check, prices included.
- **Hotels and reviews in one actor.** Most Agoda actors do one or the other. Here `mode` switches between hotel prices and guest reviews, and review runs can start from a city ("the top 20 hotels of Bali, 200 reviews each") as well as from hotel links.
- **Room types when you need them.** Turn on `includeRoomTypes` and each hotel also gets every room type on sale for your dates, with size, beds, view, its cheapest rate, and whether a breakfast or free cancellation rate exists, plus the full address, description, check-in times and facilities. Same price per hotel.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/SBlY5ha5sjVbyf377/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Food and local services family:** [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 45 Bangkok hotels for one night, 30 days from today, for 2 adults. It took 6 seconds in our test run:

```json
{
  "locations": ["Bangkok"],
  "maxHotels": 45
}
```

Put several cities on separate lines to search them in one run. Add `checkIn` (for example `2026-12-20`) and `nights` for your own dates.

Apify's free plan includes $5 of credit every month, which covers about 1,300 hotels at this actor's Free plan price.

#### Copy to your AI assistant

```text
themineworks/agoda-scraper on Apify. Returns Agoda hotels for a city and dates (one flat row per hotel with star rating, review score, nightly price with and without taxes, stay total, free cancellation, rooms left, optional room types) or Agoda guest reviews (one row per review), with no login. Call ApifyClient("TOKEN").actor("themineworks/agoda-scraper").call(run_input={"locations": ["Bangkok"], "checkIn": "2026-12-20", "nights": 2, "maxHotels": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Input: mode ("hotels" default or "reviews"), locations (city names or Agoda search links with city=, up to 50), hotelUrls (Agoda hotel links or numeric hotel ids, up to 500), checkIn (YYYY-MM-DD, default 30 days ahead), nights (1 to 30), adults, children, childAges, rooms, currency (3 letters, default USD), sortBy (recommended, price_low, price_high, stars, review_score, distance), maxHotels (per city, 1 to 2000, default 50), minStars, minReviewScore, includeRoomTypes (default false), maxReviewsPerHotel (default 100), reviewSort (newest, rating_high, rating_low, helpful), reviewSource (all, agoda, booking). Hotel rows carry hotel_id, name, url, property_type, star_rating, review_score, review_count, city, area, country, latitude, longitude, distance_to_center_km, nearby_landmarks, image_url, images, available, rooms_left, currency, price_per_night, price_per_night_with_taxes, taxes_and_fees_per_night, price_total, price_total_with_taxes, crossed_out_price_per_night, discount_percent, free_cancellation, free_cancellation_until, pay_later, pay_at_hotel, check_in, check_out, nights, search_position, and with room types: room_types, address, description, check_in_from, check_out_until, facilities. Review rows carry hotel_id, hotel_name, hotel_url, review_id, source, rating, rating_text, title, text, positives, negatives, review_date, stay_check_in, nights_stayed, traveler_type, room_type, reviewer_country, hotel_response. Each run also writes one row with _type "summary", one with _type "info" when rows were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~agoda-scraper/builds/default (Bearer TOKEN). Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Any city Agoda sells.** Type the city as you would on agoda.com (Bangkok, Bali, Tokyo, Dubai, London); the actor finds Agoda's city and reads its results 45 hotels a page. An Agoda search link with `city=` in it works too.
- **Your dates, guests and currency.** Check-in date, 1 to 30 nights, adults, children with ages, rooms, and any three letter currency (USD, EUR, THB, INR, SGD, JPY and so on). Every hotel row repeats the stay it was priced for.
- **Agoda's sort orders.** Recommended, lowest or highest price, most stars, best review score, or closest to the centre. With `maxHotels` below the city size, the sort decides which hotels you get.
- **Filters that cost nothing.** `minStars` and `minReviewScore` drop hotels before they reach your dataset, so you are never charged for them.
- **Location fields.** Area, coordinates, distance to the city centre and the five nearest landmarks with their distance.
- **Guest reviews.** Rating, title, text, what the guest liked and disliked, stay dates, nights, traveller type, room type, reviewer country and the hotel's reply. Agoda shows reviews written on Agoda and on Booking.com; `reviewSource` picks one or both.
- **Stops cleanly.** Six failed or blocked requests in a row end the run; the run stops before its time limit and keeps every row it read. The summary row says why a run returned fewer rows than asked.

### How to use it

#### Hotel prices in one city for your dates

```json
{
  "locations": ["Bali"],
  "checkIn": "2026-12-27",
  "nights": 3,
  "adults": 2,
  "currency": "EUR",
  "maxHotels": 200
}
```

#### Revenue manager: a compset with every room type

```json
{
  "hotelUrls": [
    "https://www.agoda.com/the-peninsula-bangkok/hotel/bangkok-th.html",
    "10715"
  ],
  "checkIn": "2026-12-20",
  "nights": 1
}
```

Hotels given by link or id always come back with their room types and rates. Run it every morning on a schedule to follow a competitor's prices.

#### The best rated hotels, room types included

```json
{
  "locations": ["Kuala Lumpur"],
  "sortBy": "review_score",
  "minReviewScore": 8,
  "maxHotels": 40,
  "includeRoomTypes": true
}
```

#### Cheapest stays across several cities

```json
{
  "locations": ["Bali", "Tokyo", "Dubai"],
  "sortBy": "price_low",
  "nights": 2,
  "maxHotels": 100
}
```

300 hotels from 3 cities took 30 seconds in our test run.

#### Guest reviews for the top hotels of a city

```json
{
  "mode": "reviews",
  "locations": ["Singapore"],
  "maxHotels": 10,
  "maxReviewsPerHotel": 200,
  "reviewSort": "newest"
}
```

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `mode` | string | `hotels` | `hotels` for hotel rows with prices, `reviews` for guest review rows. |
| `locations` | array of strings | empty | City names or Agoda search links with `city=`. Up to 50. |
| `hotelUrls` | array of strings | empty | Agoda hotel links or hotel ids. Up to 500. |
| `checkIn` | string | 30 days from today | Check-in date, `YYYY-MM-DD`. |
| `nights` | integer | `1` | Length of stay, 1 to 30. |
| `adults` | integer | `2` | Adults in total. |
| `children` | integer | `0` | Children in total. |
| `childAges` | array | empty | One age per child; 8 is used for any age not given. |
| `rooms` | integer | `1` | Rooms to book. |
| `currency` | string | `USD` | Currency for all hotel prices. |
| `sortBy` | string | `recommended` | `recommended`, `price_low`, `price_high`, `stars`, `review_score`, `distance`. |
| `maxHotels` | integer | `50` | Most hotels per city, 1 to 2,000. In reviews mode, how many hotels of each city to read. |
| `minStars` | integer | none | Keep only hotels with at least this many stars. |
| `minReviewScore` | integer | none | Keep only hotels with at least this score out of 10. |
| `includeRoomTypes` | boolean | `false` | Adds room types, address, description, check-in times and facilities. |
| `maxReviewsPerHotel` | integer | `100` | Reviews mode: most reviews per hotel, 1 to 5,000. |
| `reviewSort` | string | `newest` | Reviews mode: `newest`, `rating_high`, `rating_low`, `helpful`. |
| `reviewSource` | string | `all` | Reviews mode: `all`, `agoda` or `booking`. |

### What data do you get?

One row per hotel, or one row per review in reviews mode. Data rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them.

**Hotel rows**

| Field | What it is |
|---|---|
| `hotel_id`, `name`, `url`, `property_type` | Agoda hotel id, name, link, and Hotel, Apartment, Resort, Hostel and so on |
| `star_rating`, `review_score`, `review_count` | Stars (0 to 5), guest score out of 10, and how many reviews it rests on |
| `city`, `city_id`, `area`, `country`, `country_code` | Where the hotel is |
| `latitude`, `longitude`, `distance_to_center_km`, `nearby_landmarks` | Coordinates, distance to the centre, five nearest landmarks with distance |
| `image_url`, `images` | Main photo and up to 10 photos |
| `available`, `rooms_left` | Bookable for your dates, and rooms left at the cheapest rate |
| `currency`, `price_per_night`, `price_per_night_with_taxes`, `taxes_and_fees_per_night` | Cheapest price per room per night, before and after taxes and fees |
| `price_total`, `price_total_with_taxes` | Price for the whole stay |
| `crossed_out_price_per_night`, `discount_percent` | The "was" price and discount Agoda shows, when it shows one |
| `free_cancellation`, `cancellation_type`, `free_cancellation_until` | Cancellation terms of the cheapest rate |
| `pay_later`, `pay_at_hotel`, `no_credit_card_needed`, `insider_deal` | Payment options |
| `check_in`, `check_out`, `nights`, `adults`, `children`, `rooms_booked` | The stay the hotel was priced for |
| `location_query`, `search_position`, `page` | The city you typed, and the hotel's place in Agoda's results |
| `room_types` | With room types or a hotel link: one entry per room type with `room_type`, `max_occupancy`, `beds`, `room_size`, `view`, `rate_options`, `cheapest_price_per_night`, `cheapest_price_per_night_with_taxes`, `cheapest_price_total_with_taxes`, `cheapest_rate_cancellation`, `breakfast_option`, `free_cancellation_option`, `rooms_left`, `currency` |
| `room_types_count`, `cheapest_room_type`, `cheapest_price_per_night_any_room` | Room type count and the cheapest one |
| `address`, `postal_code`, `description`, `check_in_from`, `check_out_until`, `facilities`, `review_score_text`, `location_note` | Hotel page details (with room types or a hotel link) |

**Review rows**

| Field | What it is |
|---|---|
| `hotel_id`, `hotel_name`, `hotel_url` | The hotel |
| `review_id`, `source` | Review id, and Agoda or Booking.com |
| `rating`, `rating_text` | Rating out of 10 and its label |
| `title`, `text`, `positives`, `negatives` | What the guest wrote |
| `review_language`, `review_date` | Language code, date written |
| `stay_check_in`, `stay_check_out`, `nights_stayed` | The guest's stay |
| `traveler_type`, `room_type`, `reviewer_name`, `reviewer_country` | Couple, solo, family and so on; the room; display name and country as Agoda shows them |
| `helpful_votes`, `hotel_response`, `hotel_response_date` | Votes and the hotel's reply |

**Summary row** (`_type: "summary"`, never charged): inputs read and failed, search and review pages read, hotels found, rows delivered and charged, duplicates skipped, hotels filtered out, room type pages read, requests and megabytes, and `per_input`, one entry per city or hotel with what it returned and why it stopped. The same summary is saved as the `OUTPUT` record of the run.

**Error rows** (`_type: "error"`, never charged): one per input that could not be read, with `error_type` (`invalid_input`, `place_not_found`, `not_found`, `blocked`, `fetch_error`), `identifier` and `reason`.

#### Stable fields for automations

These were present in every hotel row of our test runs (885 hotel rows from 6 cities), and their names will not change: `hotel_id`, `name`, `url`, `property_type`, `star_rating`, `city`, `area`, `country`, `latitude`, `longitude`, `image_url`, `available`, `currency`, `price_per_night`, `price_per_night_with_taxes`, `taxes_and_fees_per_night`, `price_total_with_taxes`, `free_cancellation`, `check_in`, `nights`.

Optional, present only when Agoda shows a value: `review_score` and `review_count` (841 of 885: new hotels have no reviews yet), `nearby_landmarks` (731 of 885), `crossed_out_price_per_night` and `discount_percent` (53 of 885, mostly deals sorted to the top of a recommended search), `award_year` (115 of 885), and the room type fields (1 hotel in 40 had prices in search but an empty room grid on its own page).

#### Output examples

One hotel from the "Bangkok" prefill (test run, 12 Nov 2026, trimmed):

```json
{
  "hotel_id": 7451105,
  "name": "Divalux Resort and Spa Bangkok Suvarnabhumi Airport",
  "url": "https://www.agoda.com/divalux-resort-spa-bangkok-by-compass-hospitality/hotel/bangkok-th.html",
  "property_type": "Hotel",
  "star_rating": 5,
  "review_score": 8.2,
  "review_count": 22353,
  "city": "Bangkok",
  "area": "Suvarnabhumi Airport",
  "country": "Thailand",
  "latitude": 13.6934,
  "longitude": 100.793,
  "distance_to_center_km": 22.57,
  "available": true,
  "rooms_left": 1,
  "currency": "USD",
  "price_per_night": 42.74,
  "price_per_night_with_taxes": 50.3,
  "taxes_and_fees_per_night": 7.56,
  "price_total_with_taxes": 50.3,
  "crossed_out_price_per_night": 167.29,
  "discount_percent": 74,
  "free_cancellation": true,
  "free_cancellation_until": "2026-12-10",
  "pay_later": true,
  "check_in": "2026-12-11",
  "nights": 1,
  "search_position": 1
}
```

A room type entry (Kuala Lumpur, includeRoomTypes on, 2 nights, trimmed):

```json
{
  "room_type": "The King Den",
  "max_occupancy": 2,
  "beds": "1 king bed",
  "room_size": "19 m²/205 ft²",
  "view": "Street view",
  "rate_options": 6,
  "currency": "USD",
  "cheapest_price_per_night": 107.07,
  "cheapest_price_per_night_with_taxes": 114.53,
  "cheapest_price_total_with_taxes": 229.06,
  "cheapest_rate_cancellation": "Non-refundable (Low price!)",
  "breakfast_option": true,
  "free_cancellation_option": true,
  "rooms_left": 6
}
```

A review (reviews mode, The Peninsula Bangkok, trimmed):

```json
{
  "hotel_id": 10715,
  "hotel_url": "https://www.agoda.com/the-peninsula-bangkok/hotel/bangkok-th.html",
  "review_id": 1205363899,
  "source": "Agoda",
  "rating": 10,
  "rating_text": "Exceptional",
  "title": "Phenomenal hotel",
  "text": "An absolutely wonderful stay at a classic five-star hotel. The service from the staff was exceptional throughout...",
  "review_date": "2026-11-10",
  "stay_check_in": "2026-11-08",
  "nights_stayed": 2,
  "traveler_type": "Couple",
  "room_type": "Grand Deluxe Twin Room",
  "reviewer_country": "United Kingdom"
}
```

An error row for a place Agoda does not know (nothing charged):

```json
{ "_type": "error", "error_type": "place_not_found", "identifier": "Xqzzvbnm Nowhere", "reason": "Agoda has no city for this name. Try the city name as Agoda spells it, for example \"Ho Chi Minh City\", or paste a search link from agoda.com." }
```

### Pricing

Pay per event: you pay for the hotels or reviews you receive, plus a flat $0.002 per run, whatever memory you choose. Room types cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `hotel-scraped` | Once per hotel row stored in your dataset | $3.60 per 1,000 | $2.85 per 1,000 | $2.10 per 1,000 | $1.35 per 1,000 |
| `review-scraped` | Once per review row stored in your dataset | $5.40 per 1,000 | $4.50 per 1,000 | $3.60 per 1,000 | $2.70 per 1,000 |
| `run-start` | Once per run, just before the first row is delivered | $0.002 | $0.002 | $0.002 | $0.002 |

The price of one row is the price per 1,000 divided by 1,000.

Never charged:

- inputs that are not a place or an Agoda hotel, and places Agoda does not know (each gets an error row);
- hotels dropped by `minStars` or `minReviewScore`;
- a hotel or review that a second input of the same run finds again;
- rows past your `maxHotels` or `maxReviewsPerHotel`;
- the summary, info and error rows;
- a run that delivers no rows: the start fee is charged only when the first row is delivered;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### How it compares

| Actor | Price per 1,000 on the Free plan | Start fee | Login or cookies needed | Hotels with prices | Room types | Reviews |
|---|---|---|---|---|---|---|
| **This actor** | Hotels $3.60, reviews $5.40 | $0.002 per run | None needed | Yes, taxes split out | Yes, included | Yes, same actor |
| [Agoda Hotel Scraper (knagymate)](https://apify.com/knagymate/fast-agoda-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $4.00 | $0.002 per run | not stated | Yes, price per night and per stay | not stated | Separate actor |
| [Fast Agoda Reviews Scraper (knagymate)](https://apify.com/knagymate/fast-agoda-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $6.00 | $0.02 per run | not stated | No | No | Yes |
| [Agoda Hotel Scraper (bovi)](https://apify.com/bovi/agoda-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $5.00 | $0.00005 per GB of memory | No Agoda login (stated) | Yes, by hotel name, link or id | Yes | Optional comments |

Checked 11 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every morning at 07:00, every Monday and so on).
3. Compare runs on `hotel_id`, `check_in` and `price_per_night_with_taxes` to see price changes for the same stay, or on `review_id` to collect only new reviews.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

The same public hotel search, hotel pages and review lists that agoda.com shows anyone who is not logged in. It does not log in, book, or read member only or app only prices.

#### Why can a price differ a little from what I see on agoda.com?

Agoda prices depend on the visitor's country, device, login and the time of the search. This actor searches as a logged out desktop visitor from the United States. Member, app only and coupon prices are not included. Run it close to the moment you need the price.

#### Which currency are room types in?

Hotel prices from a city search follow your `currency`. Agoda's hotel page data, which the room types come from, answers in US dollars, so each room type carries its own `currency` field (USD). Hotels given by link or id are priced from that page data, so their prices are in US dollars too.

#### How many reviews can I get per hotel?

Agoda lists roughly the last three years of reviews for each hotel, from Agoda and from Booking.com. For The Peninsula Bangkok that was 581 Agoda and 660 Booking.com reviews, while the hotel's score counts 5,343. `reviews_available` in the summary says how many a hotel has. Booking.com reviews often have only liked and disliked lines, no main text.

#### How many hotels can I get per city?

Up to 2,000 per city and 50 cities per run. 500 London hotels took 40 seconds in our test. Deep into a big city's results Agoda repeats some hotels across pages; repeats are delivered and charged once.

#### Do I need an account, cookies or an API key?

No account, no cookies and no API key. The actor reads public pages over Apify Proxy, which is included. Nothing to set up.

#### Is it legal to scrape Agoda?

The actor reads only public hotel listings, prices and published reviews that anyone can see without logging in. Reviews carry the display name and country Agoda shows; treat them as personal data under laws such as GDPR. You are responsible for how you use the data, including Agoda's terms. This is general information, not legal advice.

#### Which actor should I use for other hotel sites?

[Booking.com Hotels Scraper](https://apify.com/themineworks/booking-hotels-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) for Booking.com prices and [Google Hotels Prices Scraper](https://apify.com/themineworks/google-hotels-prices-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) to compare the same hotel across booking sites.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has three ready views: Hotels, Prices for your dates, and Reviews. In CSV and Excel, `room_types` and `nearby_landmarks` are flattened into columns such as `room_types/0/room_type`.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/agoda-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http agoda-scraper "https://mcp.apify.com/?tools=themineworks/agoda-scraper"`

### Integrations

- **Google Sheets**: send each run's hotels to a sheet with Apify's Google Sheets integration; one row per hotel fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "competitor prices for next weekend every morning to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a city that returns fewer hotels than the site, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search Agoda by city and dates and get every hotel back as one row, with stars, review score, nightly price with and without taxes, cancellation terms and room types, or every guest review, no login.*

# Actor input Schema

## `mode` (type: `string`):

Hotels: one row per hotel with prices for your dates. Reviews: one row per guest review of each hotel (hotels from hotelUrls, or the top hotels of each location).

## `locations` (type: `array`):

City names as you would type them on agoda.com, one per line, for example Bangkok, Bali, Tokyo, Kuala Lumpur. An Agoda search link with city= in it also works. Up to 50 per run.

## `hotelUrls` (type: `array`):

Agoda hotel links such as https://www.agoda.com/the-peninsula-bangkok/hotel/bangkok-th.html, or Agoda hotel ids such as 10715. In Hotels mode each gets one row with all its room types and rates; in Reviews mode, its reviews. Up to 500.

## `checkIn` (type: `string`):

Date as YYYY-MM-DD, for example 2026-12-20. Leave empty for 30 days from today.

## `nights` (type: `integer`):

Length of stay, 1 to 30. Prices per night and for the whole stay are both returned.

## `adults` (type: `integer`):

Adults in total, across all rooms.

## `children` (type: `integer`):

Children in total. Their ages go in childAges (8 is used for any age not given).

## `childAges` (type: `array`):

One age per child, 0 to 17, for example 4 and 9.

## `rooms` (type: `integer`):

Number of rooms to book.

## `currency` (type: `string`):

Three letter currency code for all prices, for example USD, EUR, THB, INR, SGD, JPY, AUD.

## `sortBy` (type: `string`):

The order Agoda returns the city's hotels in. With maxHotels below the city size, this decides which hotels you get.

## `maxHotels` (type: `integer`):

The most hotels to return for each city, 1 to 2,000. A results page holds 45. In Reviews mode, how many hotels of each city to read reviews for.

## `minStars` (type: `integer`):

Keep only hotels with at least this many stars, 1 to 5. Hotels left out are not charged.

## `minReviewScore` (type: `integer`):

Keep only hotels with at least this guest score out of 10, for example 8. Hotels left out are not charged.

## `includeRoomTypes` (type: `boolean`):

On: each hotel's own page data is read too, for every room type with its cheapest rate, size, beds, view, breakfast and free cancellation options, plus the full address, description, check-in and check-out times and facilities. About 5 seconds more per 5 hotels. Same price per hotel.

## `maxReviewsPerHotel` (type: `integer`):

The most reviews to return for each hotel, 1 to 5,000.

## `reviewSort` (type: `string`):

Which reviews come first.

## `reviewSource` (type: `string`):

Agoda shows reviews written on Agoda and on Booking.com. Pick one or both.

## Actor input object example

```json
{
  "mode": "hotels",
  "locations": [
    "Bangkok"
  ],
  "nights": 1,
  "adults": 2,
  "children": 0,
  "rooms": 1,
  "currency": "USD",
  "sortBy": "recommended",
  "maxHotels": 45,
  "includeRoomTypes": false,
  "maxReviewsPerHotel": 100,
  "reviewSort": "newest",
  "reviewSource": "all"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Bangkok"
    ],
    "maxHotels": 45
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/agoda-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Bangkok"],
    "maxHotels": 45,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/agoda-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 '{
  "locations": [
    "Bangkok"
  ],
  "maxHotels": 45
}' |
apify call themineworks/agoda-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/agoda-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 <APIFY_API_TOKEN>` 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/SBlY5ha5sjVbyf377/builds/bUIkNswg5QymnYfx4/openapi.json
