Hotels
Create Search
POST https://affiliate-api.wego.com/metasearch/hotels/searches
Query Params
| Property | Required? | Data Type | Description |
|---|---|---|---|
| locale | No | String | The language that the response will be in. en as default |
| currencyCode | No | String | Currency code in which you want the rates to be in. USD as default. Must be ISO currency code format. |
Request Body
| Property | Required? | Data Type | Description |
|---|---|---|---|
| cityCode | Yes | String | The code of the searched city e.g. "SIN", "DXB" |
| roomsCount | Yes | Number | The number of rooms. roomsCount and guestsCount are optional if rooms is present |
| guestsCount | Yes | Number | The number of guests. roomsCount and guestsCount are optional if rooms is present |
| rooms | Yes | Array | The list of rooms. For example this is an array with 1 room: [{"adultsCount": 3, "childrenCount": 2, "childrenAges": [10, 12]}]. rooms is optional if both roomsCount and guestsCount are present |
| checkIn | Yes | Date | Checkin date, in YYYY-MM-DD format e.g. "2021-09-26" |
| checkOut | Yes | Date | Checkout date, in YYYY-MM-DD format e.g. "2021-09-27" |
| siteCode | Yes | String | Country Code of the user. Must be in ISO country code format. List of supported site codes: "DZ", "AR", "AU", "BH", "BD", "BR", "CA", "CL", "CN", "CO", "EG", "FR", "DE", "GH", "HK", "IN", "ID", "IR", "IR", "IQ", "IE", "IT", "JP", "JO", "KW", "MY", "MX", "MA", "NL", "NZ", "NG", "OM", "PK", "PS", "PH", "PL", "PT", "QA", "RU", "SA", "SG", "ZA", "KR", "ES", "LK", "SE", "CH", "SY", "TW", "TH", "TN", "TR", "AE", "GB", "US", "VN", "LY", "SD", "LB", "MO", "KE", "TZ", "ET", "UG", "ML", "CI", "SN", "ZW", "CD", "ZM", "AO", "MZ", "CM", "RW", "NA", "GA", "BW", "MU" |
| locale | Yes | String | The language that the response will be in. List of supported locales "en", "ar", "id", "fa", "zh-cn", "zh-tw", "zh-hk", "de", "es-419", "es", "fr", "it", "ja", "ko", "ms", "nl", "pl", "pt", "pt-br", "ru", "sv", "th", "tr", "vi", "ur", "te", "ta", "pa", "or", "mr", "ml", "kn", "hi", "gu", "bn" |
| currencyCode | Yes | String | Currency code in which you want the rates to be in. USD as default. Must be ISO currency code format e.g. "AED", "USD" |
| deviceType | Yes | String | The device type of the originating request. List of supported device types: UNDEFINED_DEVICE_TYPE, DESKTOP, TABLET, MOBILE, WATCH |
| appType | Yes | String | The application type of the originating request. List of supported app types: UNDEFINED_APP_TYPE, IOS_APP, IOS_TABLET_APP, ANDROID_APP, ANDROID_TABLET_APP, WEB_APP, MOBILE_WEB_APP, AFFILIATES, API_APP |
| userCountryCode | No | String | The country code of the user e.g. "SG", "MY" |
| searchType | No | String | The type of the search. For logging purpose. List of supported search types: HOTEL, HOTEL_LIST, CITY, DISTRICT, REGION, GEO_LOCATION |
Supported Amenities
| id | Name |
|---|---|
| 1 | Highspeed Internet |
| 2 | Swimming Pool |
| 3 | Parking |
| 4 | Restaurant |
| 5 | Facilities for Disabled |
| 6 | Airconditioning |
| 7 | Non-smoking Rooms |
| 8 | Pet-friendly |
| 9 | Safe/Vault |
| 10 | Babysitting/Child Services |
| 11 | Meeting/Banquet Facilities |
| 12 | Business Centre |
| 13 | Car Rental |
| 14 | Casino |
| 15 | Breakfast Buffet |
| 16 | Airport Shuttle |
| 17 | Golfcourse |
| 18 | Spa & Wellness Centre |
| 19 | Fitness Centre |
| 20 | Bar/Lounge |
| 21 | Ski-In Ski-Out |
| 22 | Kids Activities |
| 23 | Tennis Court |
| 24 | Beach Access |
| 25 | Game Room |
| 26 | Adult Pool |
| 27 | Indoor Pool |
| 28 | Room Service |
| 29 | Dry Cleaning |
| 30 | Valet Parking |
Sample request
{
"search": {
"cityCode": "TBB",
"checkIn": "2021-11-26",
"checkOut": "2021-11-30",
"locale": "en",
"siteCode": "SG",
"currencyCode": "SGD",
"deviceType": "desktop",
"appType": "WEB_APP",
"userCountryCode": "SG",
"rooms": [
{
"adultsCount": 2,
"childrenAges": [
10,
12
],
"childrenCount": 2
}
]
}
}
Sample response
{
"search": {
"id": "adb138d7772726f2",
"searchType": "CITY",
"city": {
"code": "TBB",
"name": "Tuy Hoa"
},
"worldRegion": {
"code": "i",
"name": "Asia"
},
"country": {
"code": "VN",
"name": "Vietnam"
},
"roomsCount": 1,
"guestsCount": 4,
"checkIn": "2021-11-26",
"checkOut": "2021-11-30",
"createdAt": "2021-06-30T16:13:13.072Z",
"locale": "en",
"siteCode": "SG",
"currencyCode": "SGD",
"deviceType": "DESKTOP",
"appType": "WEB_APP",
"userCountryCode": "SG",
"key": "TBB~CITY~2021-11-26~2021-11-30~1~4~SG~en~DESKTOP~WEB_APP",
"cityCode": "TBB",
"cityName": "Tuy Hoa",
"countryCode": "VN",
"countryName": "Vietnam",
"crossSell": false,
"scoreTesting": {
"variant": "BASELINE"
},
"rooms": [
{
"adultsCount": 2,
"childrenCount": 2,
"childrenAges": [
10,
12
],
"guestsCount": 4
}
]
},
"hotels": [
{
"id": 1007903,
"name": "Hung Vuong Hotel",
"star": 3,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1620707879/Partner/hotels/1007903/567608691.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251235/Partner/hotels/1007903/374683205.jpg",
"description": "Buffet"
},
{
"url": "https://assets.wego.com/image/upload/v1610251236/Partner/hotels/1007903/374683207.png",
"description": "Bedroom"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4878,
"imagesCount": 50,
"amenityIds": [
2,
3,
4,
6,
11,
12,
19,
28,
30
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [
{
"count": 198,
"score": 71.0,
"percentage": 100.0,
"reviewerGroup": "ALL"
}
],
"longitude": 109.30831,
"latitude": 13.10107,
"distanceToCityCentre": 1.52858,
"distanceToNearestAirport": 6.37517,
"nameI18n": {
"de": "Hung Vuong Hotel Tuy Hoa",
"pt": "Hung Vuong Hotel Tuy Hoa",
"fr": "Hung Vuong Hotel Tuy Hoa",
"zh-cn": "雄王酒店",
"id": "Hung Vuong Hotel Tuy Hoa",
"sv": "Hung Vuong Hotel Tuy Hoa",
"ko": "훙 부옹 호텔",
"zh-hk": "雄王酒店",
"zh-tw": "雄王酒店",
"en": "Hung Vuong Hotel",
"ar": "فندق هانج فونج",
"vi": "Khách sạn Hùng Vương",
"th": "โรงแรมฮุงวง",
"ja": "フン ヴォン ホテル",
"pl": "Hung Vuong Hotel Tuy Hoa",
"tr": "Hung Vuong Hotel Tuy Hoa"
},
"latestPositiveComment": "",
"similarHotelIds": [
648085,
944684,
944683,
1840524,
1898615,
277477,
1007906,
1952203,
1864663,
1046180
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1840524,
"name": "Kim Ngoc Khanh Hotel",
"star": 2,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251284/Partner/hotels/1840524/453545951.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251283/Partner/hotels/1840524/468069517.jpg",
"description": "Quadruple Room with Balcony"
},
{
"url": "https://assets.wego.com/image/upload/v1610251283/Partner/hotels/1840524/406573201.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4878,
"imagesCount": 46,
"amenityIds": [
1,
6,
9,
28,
29
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [
{
"count": 105,
"score": 89.0,
"percentage": 100.0,
"reviewerGroup": "ALL"
}
],
"longitude": 109.29396,
"latitude": 13.11891,
"distanceToCityCentre": 1.47145,
"distanceToNearestAirport": 8.85088,
"nameI18n": {
"zh-cn": "金玉庆酒店",
"zh-hk": "金玉庆酒店",
"zh-tw": "金玉慶酒店",
"en": "Kim Ngoc Khanh Hotel",
"vi": "Khách sạn Kim Ngọc Khánh"
},
"latestPositiveComment": "",
"similarHotelIds": [
1007903,
1774827,
1952203,
1007906,
1939242,
1864663,
1046180,
983416,
1898615,
1859664
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 2270348,
"name": "Goc Phu Yen Backpacker & Photographer",
"star": 0,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251314/Partner/hotels/2270348/462871907.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251314/Partner/hotels/2270348/462871913.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251314/Partner/hotels/2270348/440264282.jpg"
}
],
"badges": [],
"propertyTypeId": 2,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4877,
"imagesCount": 26,
"amenityIds": [],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [
{
"count": 57,
"score": 84.0,
"percentage": 100.0,
"reviewerGroup": "ALL"
},
{
"count": 57,
"score": 87.0,
"percentage": 100.0,
"reviewerGroup": "SOLO"
}
],
"longitude": 109.31621,
"latitude": 13.09441,
"distanceToCityCentre": 2.6142,
"distanceToNearestAirport": 5.35577,
"nameI18n": {
"en": "Goc Phu Yen Backpacker & Photographer"
},
"latestPositiveComment": "Fantastic service",
"similarHotelIds": [
1840524,
1846221
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 944684,
"name": "Saigon Phu Yen Hotel",
"star": 4,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251236/Partner/hotels/944684/491292108.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251236/Partner/hotels/944684/515634049.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707882/Partner/hotels/944684/554920231.jpg",
"description": "Meeting room / ballrooms"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4877,
"imagesCount": 50,
"amenityIds": [
1,
2,
4,
6,
9,
11,
12,
19,
20,
28,
29
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [
{
"count": 39,
"score": 68.0,
"percentage": 100.0,
"reviewerGroup": "ALL"
}
],
"longitude": 109.320496,
"latitude": 13.090114,
"distanceToCityCentre": 3.25542,
"distanceToNearestAirport": 4.7513,
"nameI18n": {
"zh-cn": "西贡富安酒店",
"ko": "사이공 푸 옌 호텔",
"zh-hk": "西贡富安酒店",
"zh-tw": "西貢富安酒店",
"en": "Saigon Phu Yen Hotel",
"ar": "فندق سيجون فو ين",
"vi": "Khách sạn Sài Gòn Phú Yên",
"th": "โรงแรมไซง่อน ภูเยน",
"ja": "サイゴン プー イェン ホテル"
},
"latestPositiveComment": "",
"similarHotelIds": [
944683,
1007903,
648085,
277477,
1898615,
1007906,
1840524,
1952203,
1859664,
983416
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 648083,
"name": "VietStar Resort & Spa",
"star": 4,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1604994887/Partner/hotels/648083/389704732.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1604994887/Partner/hotels/648083/491299948.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707880/Partner/hotels/648083/532254787.jpg",
"description": "Lobby"
}
],
"badges": [],
"propertyTypeId": 19,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4878,
"imagesCount": 50,
"amenityIds": [
1,
2,
4,
6,
9,
11,
16,
18,
22,
23,
28,
29
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [
{
"count": 353,
"score": 82.0,
"percentage": 100.0,
"reviewerGroup": "ALL"
}
],
"longitude": 109.28426,
"latitude": 13.173045,
"distanceToCityCentre": 7.56836,
"distanceToNearestAirport": 14.7461,
"nameI18n": {
"zh-cn": "越星度假酒店及水疗中心",
"ko": "비엣스타 리조트 앤드 스파",
"zh-hk": "越星度假酒店及水疗中心",
"zh-tw": "越星度假酒店及水療中心",
"en": "VietStar Resort & Spa",
"ar": "منتجع وسبا فيتستار",
"th": "เวียตสตาร์ รีสอร์ทแอนด์ส ปา",
"ja": "ビエスター リゾート & スパ"
},
"latestPositiveComment": "Friendly service",
"similarHotelIds": [
2875041,
277477,
1840524,
944684,
1007903,
944683
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 277477,
"name": "Cendeluxe Hotel - Managed by H & K Hospitality",
"star": 5,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1604675069/Partner/hotels/277477/491635598.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1604675069/Partner/hotels/277477/380460958.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707879/Partner/hotels/277477/567620259.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4878,
"imagesCount": 50,
"amenityIds": [
2,
3,
4,
6,
9,
10,
11,
12,
16,
18,
19,
23,
27,
28,
29,
30
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [
{
"count": 454,
"score": 80.0,
"percentage": 100.0,
"reviewerGroup": "ALL"
}
],
"longitude": 109.29415,
"latitude": 13.08309,
"distanceToCityCentre": 2.51241,
"distanceToNearestAirport": 5.70762,
"nameI18n": {
"de": "Cendeluxe Hotel –Managed by H&K Hospitality",
"pt": "Cendeluxe Hotel –Managed by H&K Hospitality",
"fr": "Cendeluxe Hotel –Managed by H&K Hospitality",
"zh-cn": "吉恩豪华酒店",
"id": "Cendeluxe Hotel –Managed by H&K Hospitality",
"sv": "Cendeluxe Hotel –Managed by H&K Hospitality",
"ko": "첸들룩스 호텔 - H&K 호스피탈리티",
"zh-hk": "吉恩豪华酒店",
"zh-tw": "吉恩豪華酒店",
"ms": "Cendeluxe Hotel –Managed by H&K Hospitality",
"en": "Cendeluxe Hotel - Managed by H & K Hospitality",
"it": "Cendeluxe Hotel –Managed by H&K Hospitality",
"es": "Cendeluxe Hotel –Managed by H&K Hospitality",
"ar": "فندق سيندلوكس - بإدارة إتش آند كيه هوسبيتاليتي",
"vi": "Cendeluxe Hotel –Managed by H&K Hospitality",
"th": "เซนเดลักซ์ โฮเต็ล แมเนจ บาย เอชเค ฮฮสปิตาลิตี้",
"ja": "センデラックス ホテル",
"pl": "Cendeluxe Hotel –Managed by H&K Hospitality",
"tr": "Cendeluxe Hotel –Managed by H&K Hospitality",
"nl": "Cendeluxe Hotel –Managed by H&K Hospitality"
},
"latestPositiveComment": "Friendly service",
"similarHotelIds": [
944684,
944683,
1007903,
648085,
1840524,
1898615,
1952203,
1007906,
648083,
2572639
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 2875041,
"name": "Stelia Beach Resort",
"star": 0,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1597026265/Partner/hotels/2875041/356567802.jpg",
"description": "Villa"
},
{
"url": "https://assets.wego.com/image/upload/v1610251314/Partner/hotels/2875041/413590612.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251315/Partner/hotels/2875041/491652989.jpg",
"description": "Room"
}
],
"badges": [
{
"text": "Excellent Overall Ranking",
"subText": "Top 1% in city"
},
{
"text": "Excellent Rooms",
"subText": "Top 6% in city"
}
],
"propertyTypeId": 19,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4877,
"imagesCount": 50,
"amenityIds": [
1,
4,
5,
7,
8,
11,
13,
15,
16,
20,
28,
29
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [
{
"count": 109,
"score": 92.0,
"percentage": 100.0,
"reviewerGroup": "ALL"
},
{
"count": 68,
"score": 94.0,
"percentage": 63.0,
"reviewerGroup": "COUPLE"
},
{
"count": 40,
"score": 89.0,
"percentage": 37.0,
"reviewerGroup": "FAMILY"
}
],
"longitude": 109.30812,
"latitude": 13.11424,
"distanceToCityCentre": 1.70666,
"distanceToNearestAirport": 7.72516,
"nameI18n": {
"zh-cn": "斯特里亚海滩度假村",
"ko": "스텔리아 비치 리조트",
"zh-hk": "斯特裡亞海灘度假村",
"zh-tw": "斯特裡亞海灘度假村",
"en": "Stelia Beach Resort",
"ar": "منتجع ستيليا بيتش",
"vi": "Khu Nghỉ Dưỡng Bãi Biển Stelia",
"th": "สเตเลีย บีช รีสอร์ต",
"ja": "ステリア ビーチ リゾート"
},
"latestPositiveComment": "Friendly service",
"similarHotelIds": [
648083,
1840524,
2270348,
277477
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": true,
"newlyRenovated": true
},
{
"id": 1844275,
"name": "Hoa Vang Hotel",
"star": 1,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251280/Partner/hotels/1844275/280003080.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251280/Partner/hotels/1844275/280003082.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251280/Partner/hotels/1844275/280003092.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 0,
"imagesCount": 12,
"amenityIds": [
3,
6
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.29766,
"latitude": 13.11246,
"distanceToCityCentre": 0.803902,
"distanceToNearestAirport": 8.03026,
"nameI18n": {
"en": "Hoa Vang Hotel"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1046458,
"name": "Scandia Resort",
"star": 3,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1620707892/Partner/hotels/1046458/529003336.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251263/Partner/hotels/1046458/285841216.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707892/Partner/hotels/1046458/529003341.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4877,
"imagesCount": 5,
"amenityIds": [
1,
4,
6,
9,
20,
28,
29
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [
{
"count": 22,
"score": 52.0,
"percentage": 100.0,
"reviewerGroup": "ALL"
}
],
"longitude": 109.29579,
"latitude": 13.13362,
"distanceToCityCentre": 3.10162,
"distanceToNearestAirport": 10.2247,
"nameI18n": {
"en": "Scandia Resort"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1813408,
"name": "Thy Hung Hotel",
"star": 1,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251280/Partner/hotels/1813408/419498213.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707906/Partner/hotels/1813408/570301119.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251280/Partner/hotels/1813408/419498252.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4878,
"imagesCount": 49,
"amenityIds": [
3,
12
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.29776,
"latitude": 13.11526,
"distanceToCityCentre": 1.17858,
"distanceToNearestAirport": 6.84998,
"nameI18n": {
"en": "Thy Hung Hotel"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1934775,
"name": "Joy House Hostel 2",
"star": 0,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251304/Partner/hotels/1934775/545492114.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251304/Partner/hotels/1934775/545492116.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251305/Partner/hotels/1934775/545492118.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 0,
"imagesCount": 42,
"amenityIds": [
3,
6,
29
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.29834,
"latitude": 13.11234,
"distanceToCityCentre": 0.821068,
"distanceToNearestAirport": 7.98285,
"nameI18n": {
"de": "Joy House Hostel 1",
"pt": "Joy House Hostel 1",
"fr": "Joy House Hostel 1",
"id": "Joy House Hostel 1",
"sv": "Joy House Hostel 1",
"ms": "Joy House Hostel 1",
"en": "Joy House Hostel 2",
"it": "Joy House Hostel 1",
"es": "Joy House Hostel 1",
"vi": "Joy House Hostel 1",
"pl": "Joy House Hostel 1",
"tr": "Joy House Hostel 1",
"nl": "Joy House Hostel 1"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1916154,
"name": "Vinh Thuan Hotel",
"star": 2,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251288/Partner/hotels/1916154/516137914.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251288/Partner/hotels/1916154/178656828.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707912/Partner/hotels/1916154/553067019.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4878,
"imagesCount": 17,
"amenityIds": [
4,
6,
28,
29
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.29391,
"latitude": 13.09348,
"distanceToCityCentre": 1.36252,
"distanceToNearestAirport": 6.53945,
"nameI18n": {
"en": "Vinh Thuan Hotel"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 900577,
"name": "Yasaka Huong Sen Restaurant & Hotel",
"star": 3,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251229/Partner/hotels/900577/516332863.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251229/Partner/hotels/900577/545496101.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251229/Partner/hotels/900577/545496104.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4878,
"imagesCount": 22,
"amenityIds": [
1,
4,
6,
9,
11,
12,
28,
29
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.2893,
"latitude": 13.10389,
"distanceToCityCentre": 0.648497,
"distanceToNearestAirport": 7.74531,
"nameI18n": {
"en": "Yasaka Huong Sen Restaurant & Hotel",
"ar": "ياساكا هونج سين ريستورانت آند هوتل"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1898615,
"name": "Thanh Kim Anh",
"star": 3,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251291/Partner/hotels/1898615/491380095.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707913/Partner/hotels/1898615/567609438.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707913/Partner/hotels/1898615/586116724.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4877,
"imagesCount": 33,
"amenityIds": [
3,
6,
13,
29
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.31338,
"latitude": 13.09248,
"distanceToCityCentre": 2.4712,
"distanceToNearestAirport": 5.27823,
"nameI18n": {
"en": "Thanh Kim Anh",
"ar": "كان كيم أنه",
"vi": "Khách sạn Thanh Kim Anh Tuy Hòa (Thích hợp cho thú cưng)"
},
"latestPositiveComment": "",
"similarHotelIds": [
1007903,
648085,
1007906,
1952203,
944683,
944684,
983416,
1046180,
1859664,
1864663
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1952160,
"name": "Huyen Tram Hotel",
"star": 1,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/1952160/280001302.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/1952160/280001325.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/1952160/280001297.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 0,
"imagesCount": 11,
"amenityIds": [
3,
6
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.282646,
"latitude": 13.148699,
"distanceToCityCentre": 4.95815,
"distanceToNearestAirport": 12.3464,
"nameI18n": {
"en": "Huyen Tram Hotel"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1863247,
"name": "Bon Homestay",
"star": 0,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1620707913/Partner/hotels/1863247/407214729.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707913/Partner/hotels/1863247/407214851.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707913/Partner/hotels/1863247/407214857.jpg"
}
],
"badges": [],
"propertyTypeId": 25,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4877,
"imagesCount": 49,
"amenityIds": [],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.31456,
"latitude": 13.09368,
"distanceToCityCentre": 2.5014,
"distanceToNearestAirport": 5.3481,
"nameI18n": {
"zh-cn": "邦民宿",
"zh-hk": "邦民宿",
"zh-tw": "邦民宿",
"en": "Bon Homestay"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1815244,
"name": "Tien Phat Hotel",
"star": 2,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1620707906/Partner/hotels/1815244/584913078.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707906/Partner/hotels/1815244/568810691.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707906/Partner/hotels/1815244/552453379.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4877,
"imagesCount": 17,
"amenityIds": [
3
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.283005,
"latitude": 13.143009,
"distanceToCityCentre": 4.34144,
"distanceToNearestAirport": 11.7676,
"nameI18n": {
"en": "Tien Phat Hotel"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1774827,
"name": "Hoàng Hà Hotel",
"star": 1,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1620707893/Partner/hotels/1774827/587502862.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251267/Partner/hotels/1774827/414397753.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1620707892/Partner/hotels/1774827/567670111.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 4877,
"imagesCount": 50,
"amenityIds": [
3,
8,
30
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.29834,
"latitude": 13.11492,
"distanceToCityCentre": 1.08357,
"distanceToNearestAirport": 8.28014,
"nameI18n": {
"zh-cn": "黄河酒店",
"zh-hk": "黃河酒店",
"zh-tw": "黃河飯店",
"en": "Hoàng Hà Hotel",
"vi": "Hoang Ha Hotel",
"th": "ฮวงฮา โฮเต็ล",
"ja": "ホアン ハ ホテル"
},
"latestPositiveComment": "",
"similarHotelIds": [
1864663,
1939242,
1046180,
983416,
1840524,
1859664,
1952203,
1007906,
1007903,
1898615
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 1764298,
"name": "King Hotel",
"star": 1,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251263/Partner/hotels/1764298/279994464.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251263/Partner/hotels/1764298/279994466.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251263/Partner/hotels/1764298/279994468.jpg"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 0,
"imagesCount": 12,
"amenityIds": [
3,
6,
13,
28,
29,
30
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.29793,
"latitude": 13.11253,
"distanceToCityCentre": 0.821872,
"distanceToNearestAirport": 8.02289,
"nameI18n": {
"en": "King Hotel"
},
"latestPositiveComment": "",
"similarHotelIds": [],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
},
{
"id": 2572639,
"name": "Thanh Nga Hotel",
"star": 0,
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251314/Partner/hotels/2572639/491361574.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251314/Partner/hotels/2572639/292416665.jpg"
},
{
"url": "https://assets.wego.com/image/upload/v1610251314/Partner/hotels/2572639/491361582.jpg",
"description": "Room"
}
],
"badges": [],
"propertyTypeId": 1,
"brandId": 0,
"chainId": 0,
"cityCode": "TBB",
"districtId": 0,
"imagesCount": 29,
"amenityIds": [
1,
3,
4,
7
],
"roomAmenityIds": [],
"themeIds": [],
"reviews": [],
"longitude": 109.30941,
"latitude": 13.100068,
"distanceToCityCentre": 1.6795,
"distanceToNearestAirport": 6.22335,
"nameI18n": {
"en": "Thanh Nga Hotel",
"ar": "تان نجا هوتل"
},
"latestPositiveComment": "",
"similarHotelIds": [
1007903,
1779749,
1864663,
1046180,
1898615,
1939242,
1007906,
983416,
648085,
1952203
],
"reviewsScore": 0.0,
"capacity": 0,
"bedroomsCount": 0,
"bedsCount": 0,
"bathroomsCount": 0,
"newHotel": false,
"newlyRenovated": false
}
],
"propertyTypes": [
{
"id": 1,
"name": "Hotel"
},
{
"id": 2,
"name": "Hostel / Backpacker"
},
{
"id": 19,
"name": "Resort"
},
{
"id": 25,
"name": "Homestay"
}
],
"brands": [],
"chains": [],
"cities": [
{
"code": "TBB",
"name": "Tuy Hoa"
}
],
"districts": [
{
"id": 4877,
"name": "Tuy Hoa Beach"
},
{
"id": 4878,
"name": "Tuy Hoa City Center"
}
],
"amenities": [
{
"id": 1,
"name": "Highspeed Internet"
},
{
"id": 2,
"name": "Swimming Pool"
},
{
"id": 3,
"name": "Parking"
},
{
"id": 4,
"name": "Restaurant"
},
{
"id": 5,
"name": "Facilities for Disabled"
},
{
"id": 6,
"name": "Airconditioning"
},
{
"id": 7,
"name": "Non-smoking Rooms"
},
{
"id": 8,
"name": "Pet-friendly"
},
{
"id": 9,
"name": "Safe/Vault"
},
{
"id": 10,
"name": "Babysitting/Child Services"
},
{
"id": 11,
"name": "Meeting/Banquet Facilities"
},
{
"id": 12,
"name": "Business Centre"
},
{
"id": 13,
"name": "Car Rental"
},
{
"id": 15,
"name": "Breakfast Buffet"
},
{
"id": 16,
"name": "Airport Shuttle"
},
{
"id": 18,
"name": "Spa & Wellness Centre"
},
{
"id": 19,
"name": "Fitness Centre"
},
{
"id": 20,
"name": "Bar/Lounge"
},
{
"id": 22,
"name": "Kids Activities"
},
{
"id": 23,
"name": "Tennis Court"
},
{
"id": 27,
"name": "Indoor Pool"
},
{
"id": 28,
"name": "Room Service"
},
{
"id": 29,
"name": "Dry Cleaning"
},
{
"id": 30,
"name": "Valet Parking"
}
],
"roomAmenities": [],
"themes": [],
"roomTypeCategories": [],
"destinationInfo": {
"hotelCount": 54
}
}
The first response for the search only contains the list of hotels - without the rates yet. Giving you a change to render list of hotels while polling for the rates.
Get search results
GET https://affiliate-api.wego.com/metasearch/hotels/searches/:searchId/results?offset=0&locale=EN¤cyCode=SGD
replace the searchId with the value you've gotten from the previous post request.
URL Params (optional)
offset- use the value for thecountfrom the previous response for the next call, so that it will return only the delta.locale- The language that the response will be in. Default value is "en".currencyCode- Currency code in which you want the rates to be in. USD as default. Must be ISO currency code format.
You will need to poll this endpoint to get the hotel rates and other dependant
data: filter, scores, brands, chains, propertyTypes, etc
Sample Request
Include searchId and offset as count from previous response
By including the offset as count value from previous response, API will only
return new data that was not returned in previous pollings.
GET https://affiliate-api.wego.com/metasearch/hotels/searches/53c294a30e31a797/results?locale=en¤cyCode=SGD&offset=120
Keep calling this endpoint until the offset is same for 3 consecutive calls.
Sample Response
{
"search": {
"id": "53c294a30e31a797",
"searchType": "CITY",
"city": {
"code": "TBB",
"name": "Tuy Hoa"
},
"worldRegion": {
"code": "i",
"name": "Asia"
},
"country": {
"code": "VN",
"name": "Vietnam"
},
"roomsCount": 1,
"guestsCount": 4,
"checkIn": "2021-11-26",
"checkOut": "2021-11-30",
"createdAt": "2021-06-30T16:13:13.072Z",
"locale": "en",
"siteCode": "SG",
"currencyCode": "SGD",
"deviceType": "DESKTOP",
"appType": "WEB_APP",
"userCountryCode": "SG",
"key": "TBB~CITY~2021-11-26~2021-11-30~1~4~SG~en~DESKTOP~WEB_APP",
"cityCode": "TBB",
"cityName": "Tuy Hoa",
"countryCode": "VN",
"countryName": "Vietnam",
"crossSell": false,
"scoreTesting": {
"variant": "BASELINE"
},
"rooms": [
{
"adultsCount": 2,
"childrenCount": 2,
"childrenAges": [
10,
12
],
"guestsCount": 4
}
]
},
"rates": [
{
"id": "adb138d7772726f2:booking.com:2875041:d092d7c8:24",
"hotelId": 2875041,
"providerHotelId": "4480747",
"providerCode": "booking.com",
"description": "Premier Garden View",
"price": {
"amount": 184.0,
"currencyCode": "SGD",
"amountUsd": 136.52367,
"taxAmount": 17.0,
"taxAmountUsd": 12.411242,
"taxInclusive": true,
"ecpc": 0.27,
"localTaxAmount": 0.0,
"localTaxAmountUsd": 0.0,
"totalLocalTaxAmount": 0.0,
"totalLocalTaxAmountUsd": 0.0,
"totalAmount": 736.0,
"totalAmountUsd": 546.09467,
"totalTaxAmount": 68.0,
"totalTaxAmountUsd": 49.644966
},
"rateAmenityIds": [
1,
2
],
"remainingRoomsCount": 2,
"roomSizeInM2": 50,
"handoffUrl": "https://handoff.wego.com/hotels/continue?search_id=adb138d7772726f2&rate_id=adb138d7772726f2%3Abooking.com%3A2875041%3Ad092d7c8%3A24&site=www.wego.com.sg&locale=en&version=2&device_type=DESKTOP&app_type=WEB_APP",
"roomIds": [
"f87139a6d9d21bfa"
],
"roomsCount": 1
},
{
"id": "adb138d7772726f2:booking.com:1007906:d092d7c8:43",
"hotelId": 1007906,
"providerHotelId": "6841819",
"providerCode": "booking.com",
"description": "Superior Single Room",
"price": {
"amount": 21.0,
"currencyCode": "SGD",
"amountUsd": 15.299318,
"taxAmount": 2.0,
"taxAmountUsd": 1.3908471,
"taxInclusive": true,
"ecpc": 0.27,
"localTaxAmount": 0.0,
"localTaxAmountUsd": 0.0,
"totalLocalTaxAmount": 0.0,
"totalLocalTaxAmountUsd": 0.0,
"totalAmount": 84.0,
"totalAmountUsd": 61.197273,
"totalTaxAmount": 8.0,
"totalTaxAmountUsd": 5.5633883
},
"rateAmenityIds": [
5,
2
],
"remainingRoomsCount": 4,
"roomSizeInM2": 16,
"handoffUrl": "https://handoff.wego.com/hotels/continue?search_id=adb138d7772726f2&rate_id=adb138d7772726f2%3Abooking.com%3A1007906%3Ad092d7c8%3A43&site=www.wego.com.sg&locale=en&version=2&device_type=DESKTOP&app_type=WEB_APP",
"roomIds": [
"f9a32f9281ae6449"
],
"roomsCount": 1
}
],
"rooms": {
"f9a32f9281ae6449": {
"id": "f9a32f9281ae6449",
"description": "Superior Single Room",
"roomSizeInM2": 16.0,
"maxOccupancy": 1
},
"f87139a6d9d21bfa": {
"id": "f87139a6d9d21bfa",
"description": "Premier Garden View",
"roomSizeInM2": 50.0,
"maxOccupancy": 2
}
},
"hotels": [],
"filter": {
"minPrice": {
"amount": 5.0,
"currencyCode": "SGD",
"amountUsd": 3.900676,
"taxAmount": 1.0,
"taxAmountUsd": 0.5234673,
"taxInclusive": true,
"ecpc": 0.27,
"localTaxAmount": 0.0,
"localTaxAmountUsd": 0.0,
"totalLocalTaxAmount": 0.0,
"totalLocalTaxAmountUsd": 0.0,
"totalAmount": 20.0,
"totalAmountUsd": 15.602704,
"totalTaxAmount": 4.0,
"totalTaxAmountUsd": 2.0938692
},
"maxPrice": {
"amount": 487.0,
"currencyCode": "SGD",
"amountUsd": 362.13293,
"taxAmount": 65.0,
"taxAmountUsd": 48.60301,
"taxInclusive": true,
"ecpc": 0.43,
"localTaxAmount": 0.0,
"localTaxAmountUsd": 0.0,
"totalLocalTaxAmount": 0.0,
"totalLocalTaxAmountUsd": 0.0,
"totalAmount": 1948.0,
"totalAmountUsd": 1448.5317,
"totalTaxAmount": 260.0,
"totalTaxAmountUsd": 194.41203
},
"stars": [
{
"code": "0",
"count": 6
},
{
"code": "1",
"count": 4
},
{
"code": "2",
"count": 3
},
{
"code": "3",
"count": 2
},
{
"code": "4",
"count": 1
}
],
"rateAmenities": [
{
"code": "1",
"count": 3
},
{
"code": "2",
"count": 15
},
{
"code": "3",
"count": 1
},
{
"code": "4",
"count": 5
},
{
"code": "5",
"count": 14
},
{
"code": "14",
"count": 4
}
],
"brands": [],
"chains": [],
"propertyTypes": [
{
"code": "1",
"count": 12
},
{
"code": "2",
"count": 2
},
{
"code": "19",
"count": 1
},
{
"code": "25",
"count": 1
}
],
"districts": [
{
"code": "4877",
"count": 11
},
{
"code": "4878",
"count": 3
}
],
"cities": [
{
"code": "TBB",
"count": 16
}
],
"amenities": [
{
"code": "1",
"count": 7
},
{
"code": "2",
"count": 1
},
{
"code": "3",
"count": 6
},
{
"code": "4",
"count": 5
},
{
"code": "5",
"count": 1
},
{
"code": "6",
"count": 7
},
{
"code": "7",
"count": 3
},
{
"code": "8",
"count": 2
},
{
"code": "9",
"count": 5
},
{
"code": "11",
"count": 3
},
{
"code": "12",
"count": 3
},
{
"code": "13",
"count": 2
},
{
"code": "15",
"count": 1
},
{
"code": "16",
"count": 2
},
{
"code": "18",
"count": 1
},
{
"code": "19",
"count": 1
},
{
"code": "20",
"count": 2
},
{
"code": "28",
"count": 7
},
{
"code": "29",
"count": 8
},
{
"code": "30",
"count": 3
}
],
"themes": [],
"reviewerGroups": [
{
"code": "ALL",
"count": 2
}
],
"bookingOptions": [
{
"code": "TRAVEL_AGENCY",
"count": 16
}
]
},
"providerRatesCounts": [
{
"hotelId": 2875041,
"providerCode": "hotels.com-hotel",
"ratesCount": 7
},
{
"hotelId": 2875041,
"providerCode": "expedia.com-hotels",
"ratesCount": 1
},
{
"hotelId": 1007906,
"providerCode": "hotels.com-hotel",
"ratesCount": 1
}
],
"scores": {
"2875041": 2.0989636E7,
"1007906": 1.0989914E7
},
"propertyTypes": [],
"stars": [
{
"id": 1,
"name": "1"
},
{
"id": 2,
"name": "2"
},
{
"id": 3,
"name": "3"
},
{
"id": 4,
"name": "4"
},
{
"id": 5,
"name": "5"
}
],
"brands": [],
"chains": [],
"cities": [
{
"code": "TBB",
"name": "Tuy Hoa"
}
],
"districts": [],
"amenities": [],
"roomAmenities": [],
"themes": [],
"rateAmenities": [
{
"id": 2,
"code": "FREE_CANCELLATION",
"type": "PAYMENT",
"name": "Free Cancellation"
},
{
"id": 1,
"code": "BREAKFAST_INCLUDED",
"type": "AMENITY",
"name": "Breakfast Included"
}
],
"roomTypeCategories": [],
"providers": [
{
"code": "hotels.com-hotel",
"name": "hotels.com",
"type": "OTA",
"id": 729,
"directBooking": false,
"isMobileFriendly": true,
"isHotelWebsite": false,
"bookingOptions": [
"TRAVEL_AGENCY"
]
},
{
"code": "expedia.com-hotels",
"name": "Expedia",
"type": "OTA",
"id": 707,
"directBooking": false,
"isMobileFriendly": true,
"isHotelWebsite": false,
"bookingOptions": [
"TRAVEL_AGENCY"
]
}
],
"groupSearch": false,
"count": 129,
"done": false
}
Get Hotel Rates
GET https://affiliate-api.wego.com/metasearch/hotels/:hotelId/rates
Parameters
| Property | Required? | Data Type | Description |
|---|---|---|---|
| searchId | Yes | String | Search ID from the previous endpoint. |
| locale | No | String | The language that the response will be in. en as default |
| currencyCode | No | String | Currency code in which you want the rates to be in. USD as default. Must be ISO currency code format |
Sample Request
https://affiliate-api.wego.com/metasearch/hotels/2220805/rates?searchId=adb138d7772726f2
Sample Response
{
"search": {
"id": "adb138d7772726f2",
"searchType": "CITY",
"city": {
"code": "TBB",
"name": "Tuy Hoa"
},
"worldRegion": {
"code": "i",
"name": "Asia"
},
"country": {
"code": "VN",
"name": "Vietnam"
},
"roomsCount": 1,
"guestsCount": 4,
"checkIn": "2021-11-26",
"checkOut": "2021-11-30",
"createdAt": "2021-06-30T16:13:13.072Z",
"locale": "en",
"siteCode": "SG",
"currencyCode": "SGD",
"deviceType": "DESKTOP",
"appType": "WEB_APP",
"userCountryCode": "SG",
"key": "TBB~CITY~2021-11-26~2021-11-30~1~4~SG~en~DESKTOP~WEB_APP",
"cityCode": "TBB",
"cityName": "Tuy Hoa",
"countryCode": "VN",
"countryName": "Vietnam",
"crossSell": false,
"scoreTesting": {
"variant": "BASELINE"
},
"rooms": [
{
"adultsCount": 2,
"childrenCount": 2,
"childrenAges": [
10,
12
],
"guestsCount": 4
}
]
},
"score": 1.0989938E7,
"rates": [
{
"id": "adb138d7772726f2:booking.com:2220805:d092d7c8:59",
"hotelId": 2220805,
"providerHotelId": "4653855",
"description": "Deluxe Double Room",
"price": {
"amount": 10.0,
"currencyCode": "USD",
"amountUsd": 9.534986,
"taxAmount": 0.0,
"taxAmountUsd": 0.0,
"taxInclusive": true,
"ecpc": 0.27,
"localTaxAmount": 0.0,
"localTaxAmountUsd": 0.0,
"totalLocalTaxAmount": 0.0,
"totalLocalTaxAmountUsd": 0.0,
"totalAmount": 40.0,
"totalAmountUsd": 38.139942,
"totalTaxAmount": 0.0,
"totalTaxAmountUsd": 0.0
},
"rateAmenityIds": [
5,
2
],
"provider": {
"code": "booking.com",
"name": "Booking.com",
"type": "OTA",
"id": 6,
"directBooking": false,
"isMobileFriendly": true,
"isHotelWebsite": false,
"bookingOptions": [
"TRAVEL_AGENCY"
]
},
"roomSizeInM2": 15,
"rateClassification": {
"id": "3zz79OLs8I9fWqZTaLt8JNnGpD0=",
"roomTypeId": 26484,
"bedType": "double",
"rateAmenityIds": [
2,
5
],
"occupancy": 2,
"roomTypeTag": "DOUBLE",
"roomsCount": 1
},
"handoffUrl": "https://handoff.wego.com/hotels/continue?search_id=adb138d7772726f2&rate_id=adb138d7772726f2%3Abooking.com%3A2220805%3Ad092d7c8%3A59&site=www.wego.com.sg&locale=en&version=2&device_type=DESKTOP&app_type=WEB_APP",
"occupancy": 2,
"params": {
"bucket": "0.0",
"agreement_term_id": "9270"
},
"siteConfig": {
"siteCode": "SG",
"locale": "en",
"host": "www.wego.com.sg"
},
"roomIds": [
"f50d48fc85841560"
],
"roomsCount": 1,
"checkIn": "2021-11-26",
"checkOut": "2021-11-30",
"isMobile": false
},
{
"id": "adb138d7772726f2:booking.com:2220805:35afd8a5:4",
"hotelId": 2220805,
"providerHotelId": "4653855",
"description": "Deluxe Double Room",
"price": {
"amount": 10.0,
"currencyCode": "USD",
"amountUsd": 9.554851,
"taxAmount": 0.0,
"taxAmountUsd": 0.0,
"taxInclusive": true,
"ecpc": 0.27,
"localTaxAmount": 0.0,
"localTaxAmountUsd": 0.0,
"totalLocalTaxAmount": 0.0,
"totalLocalTaxAmountUsd": 0.0,
"totalAmount": 80.0,
"totalAmountUsd": 76.438805,
"totalTaxAmount": 0.0,
"totalTaxAmountUsd": 0.0
},
"rateAmenityIds": [
2,
3,
4,
5,
13
],
"provider": {
"code": "booking.com",
"name": "Booking.com",
"type": "OTA",
"id": 6,
"directBooking": false,
"isMobileFriendly": true,
"isHotelWebsite": false,
"bookingOptions": [
"TRAVEL_AGENCY"
]
},
"rateClassification": {
"id": "3zz79OLs8I9fWqZTaLt8JNnGpD0=",
"roomTypeId": 26484,
"bedType": "double",
"rateAmenityIds": [
2,
3,
4,
5,
13
],
"occupancy": 2,
"roomTypeTag": "DOUBLE",
"roomsCount": 1
},
"handoffUrl": "https://handoff.wego.com/hotels/continue?search_id=adb138d7772726f2&rate_id=adb138d7772726f2%3Abooking.com%3A2220805%3A35afd8a5%3A4&site=www.wego.com.sg&locale=en&version=2&device_type=DESKTOP&app_type=WEB_APP",
"occupancy": 0,
"params": {
"bucket": "0.0",
"agreement_term_id": "9270"
},
"siteConfig": {
"siteCode": "SG",
"locale": "en",
"host": "www.wego.com.sg"
},
"roomIds": [
"11d0f6577d7c6d5c",
"11d0f6577d7c6d5c"
],
"roomsCount": 2,
"checkIn": "2021-11-26",
"checkOut": "2021-11-30",
"isMobile": false
}
],
"rooms": {
"11d0f6577d7c6d5c": {
"id": "11d0f6577d7c6d5c",
"description": "Deluxe Double Room"
},
"f50d48fc85841560": {
"id": "f50d48fc85841560",
"description": "Deluxe Double Room",
"roomSizeInM2": 15.0,
"maxOccupancy": 2
}
},
"rateAmenities": {
"2": {
"id": 2,
"code": "FREE_CANCELLATION",
"type": "PAYMENT",
"name": "Free Cancellation"
},
"3": {
"id": 3,
"code": "FREE_PARKING",
"type": "AMENITY",
"name": "Free Parking"
},
"4": {
"id": 4,
"code": "FREE_WIFI",
"type": "AMENITY",
"name": "Free WiFi"
},
"5": {
"id": 5,
"code": "PAY_LATER",
"type": "PAYMENT",
"name": "Pay Later"
},
"13": {
"id": 13,
"code": "NO_CREDIT_CARD_NEEDED",
"type": "PAYMENT",
"name": "No credit card needed"
}
},
"orderedRateIdsByBasePrice": [
"adb138d7772726f2:booking.com:2220805:d092d7c8:59",
"adb138d7772726f2:booking.com:2220805:35afd8a5:4"
],
"similarHotels": [],
"similarHotelProviders": [],
"groupSearch": false,
"roomTypes": [
{
"id": 26484,
"name": "Deluxe Room",
"occupancy": 2,
"genericType": true,
"roomTypeTag": "TWIN_DOUBLE",
"rateIds": [
"adb138d7772726f2:booking.com:2220805:d092d7c8:59",
"adb138d7772726f2:booking.com:2220805:35afd8a5:4"
],
"bestPrice": {
"amount": 10.0,
"currencyCode": "USD",
"amountUsd": 9.534986,
"taxAmount": 0.0,
"taxAmountUsd": 0.0,
"taxInclusive": true,
"ecpc": 0.27,
"localTaxAmount": 0.0,
"localTaxAmountUsd": 0.0,
"totalLocalTaxAmount": 0.0,
"totalLocalTaxAmountUsd": 0.0,
"totalAmount": 40.0,
"totalAmountUsd": 38.139942,
"totalTaxAmount": 0.0,
"totalTaxAmountUsd": 0.0
}
}
],
"newRateIds": []
}
Get Hotel Details
GET hotels/v1/hotels/:hotelId
Parameters
| Property | Required? | Data Type | Description |
|---|---|---|---|
| language | No | String | The language that the response will be in. En as default |
| deviceType | No | String | The device type of the originating request |
| siteCode | No | String | Country Code of the user. Must be in ISO country code format. |
| keyTransform | Yes | String | underscore |
Sample request
/hotels/hotels/2220805?language=en&deviceType=mobile&siteCode=SG&keyTransform=underscore
Sample response
{
"id": 2220805,
"check_in": "12:00 PM",
"check_out": "12:00 PM",
"gmt_offset": "7",
"latitude": 13.10831,
"longitude": 109.29832,
"native_currency": "VND",
"rooms_count": 18,
"time_zone": "Asia/Ho_Chi_Minh",
"website": "http://khach-san-ngan-ha-tuy-hoa-vn.book.direct",
"updated_at": "2021-06-09T00:46:45.000Z",
"permalink": "khach-s-n-ngan-ha-2220805",
"name_en": "khách sạn Ngân Hà",
"distance_to_city_centre": 0.461441,
"distance_to_nearest_airport": 7.59523,
"nearest_airport": {
"code": "TBB",
"name": "Tuyhoa Airport"
},
"name": "khách sạn Ngân Hà",
"address": "68 trần Suyền tuy Hòa, Phú Yên 68, 5",
"description": "Facing the beachfront in Tuy Hoa khách sạn Ngân Hà has a garden and a terrace. The air-conditioned rooms provide a garden view and come with a desk and free WiFi. All guest rooms at the hotel come with a seating area a flat-screen TV with satellite channels and a private bathroom with free toiletries and a bidet. All units will provide guests with a fridge. Guests at khách sạn Ngân Hà will be able to enjoy activities in and around Tuy Hoa like hiking and cycling. Staff at the accommodation are available to provide information at the 24-hour front desk. The nearest airport is Tuy Hoa 21 km from khách sạn Ngân Hà and the property offers a paid airport shuttle service.",
"similar_hotels": [
1774827,
1840524,
1939242,
1864663,
1046180,
1779749,
2572639,
983416,
1952203,
1007903
],
"images": [
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093938.jpg",
"source": "priceline.com"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093897.jpg",
"source": "priceline.com"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093943.jpg",
"source": "priceline.com"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093949.jpg",
"source": "priceline.com"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093915.jpg",
"source": "priceline.com"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093904.jpg",
"source": "priceline.com"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093906.jpg",
"source": "priceline.com"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093920.jpg",
"source": "priceline.com"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093925.jpg",
"source": "priceline.com"
},
{
"url": "https://assets.wego.com/image/upload/v1610251301/Partner/hotels/2220805/414093933.jpg",
"source": "priceline.com"
}
],
"property_type": {
"id": 1,
"name": "Hotel"
},
"city": {
"id": 24923,
"code": "TBB",
"name": "Tuy Hoa",
"en_name": "Tuy Hoa",
"permalink": "tuy-hoa",
"country_code": "VN",
"country_name": "Vietnam",
"country_permalink": "vietnam"
},
"district": {
"id": 4878,
"name": "Tuy Hoa City Center",
"permalink": "tuy-hoa-city-center"
}
}