| Search hotels or vacation rentals with your own dates, guests and currency, filter by price, guest rating, star class and free cancellation, then add the Hotels.com rate, every booking site's price, room rates, full address, phone and typical price range for each property. |
Paris, Las Vegas Strip or Hotel Arts Barcelona).
## `propertyTokens` (type: `array`):
Look up exact hotels by the propertyToken value from an earlier run (Google Hotels property links also work). Each hotel is returned with its Hotels.com rate and competitor prices. Leave empty to search by location only.
## `maxResults` (type: `integer`):
Maximum number of hotels to save from the location search. Results come in pages of about 20 hotels.
## `enrichDetails` (type: `boolean`):
Open each hotel's page to add the Hotels.com nightly rate, prices from every other booking site, room rates, full address, typical price range, the full amenity list and third-party review scores. Charged as an extra event per hotel.
## `checkInDate` (type: `string`):
Leave empty to use a 2-night stay starting 30 days from today. Stays can be up to 30 nights.
## `checkOutDate` (type: `string`):
Leave empty for a 2-night stay after the check-in date.
## `adults` (type: `integer`):
Number of adult guests.
## `children` (type: `integer`):
Number of children. Add their ages below for accurate prices; children without an age are counted as 10 years old.
## `childrenAges` (type: `array`):
Age of each child (1 to 17), one per line.
## `currency` (type: `string`):
Currency for all prices.
## `sortBy` (type: `string`):
Order of the search results.
## `minPrice` (type: `integer`):
Only show hotels from this nightly price, in the selected currency.
## `maxPrice` (type: `integer`):
Only show hotels up to this nightly price, in the selected currency.
## `minRating` (type: `string`):
Only show hotels with at least this guest rating (out of 5).
## `hotelClasses` (type: `array`):
Only show hotels with these star classes. Leave empty for all.
## `freeCancellation` (type: `boolean`):
Only show hotels that offer a free-cancellation rate for your dates.
## `vacationRentals` (type: `boolean`):
Search vacation rentals (apartments, houses, villas) instead of hotels. Hotel class and free-cancellation filters don't apply to rentals.
## `countryCode` (type: `string`):
Two-letter country code of the market to search from (for example us, gb, de). Booking sites and their local domains can differ by market.
## `language` (type: `string`):
Language code for text such as descriptions, amenities and review themes (for example en, fr, de).
## Actor input object example
```json
{
"location": "Paris",
"maxResults": 20,
"enrichDetails": false,
"adults": 2,
"children": 0,
"currency": "USD",
"sortBy": "Relevance",
"freeCancellation": false,
"vacationRentals": false,
"countryCode": "us",
"language": "en"
}
```
# Actor output Schema
## `dataset` (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 '