### Quick input
Try 20 Kyoto hotels with room offers and full hotel details:
```json
{
"destinations": [
"Kyoto"
],
"maxHotelsPerDestination": 20,
"currency": "EUR",
"includeHotelDetails": true,
"reviewsPerHotel": 0
}
```
[Open actor input](https://console.apify.com/actors/F73ct69HUD5aoRZ9w/input) to choose your destinations and dates. Set hotel details to false for faster price searches. This small trial does not reproduce the bulk speed figure. Hotel prices and available rooms depend on your dates. Recent reviews are optional and charged separately.
| Clearpath hotel research • Hotels, rooms & reviews |
 Agoda Hotels➤ You are here  Agoda ReviewsFull review histories  Expedia HotelsHotel prices & reviews  Booking ReviewsGuest reviews & replies |
**Booking.com**
- [Booking.com Reviews Scraper](https://apify.com/clearpath/booking-reviews-scraper)
- 
**Tripadvisor**
- [Tripadvisor Reviews Scraper](https://apify.com/clearpath/tripadvisor-reviews-scraper)
- 
**Yelp**
- [Yelp Reviews Scraper](https://apify.com/clearpath/yelp-reviews-scraper)
- 
**Expedia & Hotels.com**
- [Expedia & Hotels.com Reviews Scraper](https://apify.com/clearpath/expedia-hotels-com-reviews-scraper)
- **Agoda**
- [Agoda Reviews Scraper](https://apify.com/clearpath/agoda-reviews-scraper)
### Support
- **Bugs**: Issues tab
- **Features**: Email or issues
- **Email**: max@mapa.slmail.me
### Legal Compliance
Extracts publicly available data. Users must comply with Agoda's terms and data protection regulations, including GDPR and CCPA, where applicable.
***
*Turn Agoda hotel search results, prices and room offers into structured data.*
# Actor input Schema
## `destinations` (type: `array`):
Cities or areas to search, one per line. Each returns every hotel Agoda lists there for your dates, or the first ones by your Sort by choice up to Max hotels per destination. Each row's searchRank holds its position in Agoda's results.Kyoto, Bali, New YorkSukhumvit, Shinjuku, Tokyohttps://www.agoda.com/city/kyoto-jp.html, or a search results link such as https://www.agoda.com/search?city=1784https://www.agoda.com/ibis-budapest-city/hotel/budapest-hu.html49487The Fullerton Hotel Singapore. Add the city when the name is common. A name is used only when it points to exactly one Agoda property; otherwise its row asks you for the link.
## `maxHotelsPerDestination` (type: `integer`):
How many hotels to collect from each destination, the first ones in your Sort by order. Leave empty for every hotel Agoda lists there (large cities have several thousand).
## `maxResults` (type: `integer`):
Stops the whole run once this many hotels are collected across all destinations and hotels. Leave empty for no total limit.
## `includeHotelDetails` (type: `boolean`):
Add the full hotel profile to each row: street address, postal code, description, all photos, facilities, check-in and check-out times, policies, category scores and rating distribution, nearby places, and every room offer for your dates (room, size, bedding, occupancy, price, cancellation, breakfast). Room offers are priced in your currency (in US dollars for ISK, NPR, MMK, MOP, CLP, PEN, KES and MAD).\[4, 9]. Children without an age are priced as 8-year-olds.
## `rooms` (type: `integer`):
Rooms needed. Empty means 1.
## `currency` (type: `string`):
Currency of the hotel prices.
## `sortBy` (type: `string`):
The order Agoda ranks the hotels in. With a hotel limit it decides which hotels you get: Lowest price with a limit of 50 returns the 50 cheapest.
## `starRatings` (type: `array`):
Only hotels with these star ratings. Leave empty for all.
## `minReviewScore` (type: `integer`):
Only hotels with at least this guest score on Agoda's 10-point scale, for example 8 for Excellent and above.
## `minPrice` (type: `integer`):
Only hotels whose price per room per night, taxes and fees included, is at least this, in your currency.
## `maxPrice` (type: `integer`):
Only hotels whose price per room per night, taxes and fees included, is at most this, in your currency.
## `propertyType` (type: `string`):
Hotels (hotels, resorts, hostels, ryokans and similar) or homes (apartments, villas, houses).
## `freeCancellationOnly` (type: `boolean`):
Only hotels with a free-cancellation rate for your dates.
## `breakfastIncludedOnly` (type: `boolean`):
Only hotels with a rate that includes breakfast.
## `payAtHotelOnly` (type: `boolean`):
Only hotels that let you pay at the property.
## `language` (type: `string`):
The Agoda language edition to read. It sets the language of descriptions, facilities, photo captions, policies and rating labels. Hotel names stay as Agoda lists them.
## `feedback` (type: `string`):
For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.
## Actor input object example
```json
{
"destinations": [
"Kyoto"
],
"maxHotelsPerDestination": 50,
"includeHotelDetails": true,
"reviewsPerHotel": 0,
"adults": 2,
"currency": "USD",
"sortBy": "best_match",
"propertyType": "all",
"freeCancellationOnly": false,
"breakfastIncludedOnly": false,
"payAtHotelOnly": false,
"language": "en-us"
}
```
# Actor output Schema
## `results` (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 '