List hotels
list_hotelsRead-onlyIdempotent
Lists the curated hotel pool by country, area and stars, with facility tags. No supplier call and no price (a price needs dates and guests). city matches area words ("Antalya", "Business Bay"); the free-text argument matches name words. Each hotel carries a hotelId. When nothing matches, the reply lists nearby MBD hotels and a contact link.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name. | |
| limit | No | ||
| stars | No | ||
| cursor | No | cursor from the previous response. | |
| search | No | Words in the hotel name. | |
| country | No | Country name, spelled as in the hotel records. | |
| currency | Yes | ||
| language | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | No | ||
| cursor | Yes | ||
| hotels | Yes | ||
| contact | No | ||
| deepLink | Yes | ||
| disclaimer | No | ||
| emptyReason | No | ||
| generatedAt | No | ||
| alternatives | No | ||
| deepLinkNote | No | ||
| alternativesBasis | No | ||
| catalogueRefreshedAt | No |