Search room

This endpoint is used to find rooms base on condition: destination (province, city, state,...), room attribute (price, sale off status, bed rooms,...), checkin date - checkout date,..., coordinates.

Endpoint

Method	URI	Headers
GET	/api/search	Accept: application/json Accept-Language: <language>

Data Params

Param	Description	Type	Required
stype	Type search	String	No
sid	Id of destination	String	No
property_type	Search room by property	String	No
is_instant_book	search instant book or not 0:1	Integer	No
order_by_price	Type order asc:desc	String	No
bedrooms	Minimum number of bed rooms	Integer	No
checkin	Date checkin in format dd-MM-yyyy	String	No
checkout	Date checkout in format dd-MM-yyyy	String	No
limit	Limit of result	Integer	No
min_price	Min price of room	String	No
max_price	Max price of room	String	No
guests	Number of guest	Integer	No
latitude	Search by latitude and longitude	String	No
longitude	Search by latitude and longitude	String	No
radius	Radius for search by latitude and longitude	String	No
include	Include field	String	No
has_promotion	Search by room has promotion	Interger	No

Request & Response Examples

Successful Response

201

Example request

curl -X POST \
  'http://127.0.0.1:8088/api/search?page=1' \
  -H 'Accept: application/json' \
  -H 'Accept-Language: en' \
  -H 'Authorization: Bearer' \
  -H 'Content-Currency: VND' \
  -H 'Mobile-Client: android' \
  -H 'Postman-Token: 00a15e14-13b6-4943-b56a-f71e7f625baf' \
  -H 'cache-control: no-cache' \
  -d 'stype=state&sid=2'

1
2
3
4
5
6
7
8
9
10

Example response

{
  "data": [
    {
      "id": 16551,
      "name": "Cloudy View",
      "summary": "",
      "introduction": "",
      "apartment_rules": "Ban v\u00e0 t\u00f4i s\u1ebd c\u00f9ng nhau \u0111\u1ec3 gi\u1eef g\u00ecn c\u1ea3nh quan v\u00e0 m\u00f4i tr\u01b0\u1eddng \u0111\u01b0\u1ee3c xanh, s\u1ea1ch \u0111\u1eb9p b\u1eb1ng c\u00e1ch kh\u00f4ng x\u1ea3 r\u00e1c b\u1eeba b\u00e3i, kh\u00f4ng s\u1eed d\u1ee5ng c\u00e1c ch\u1ea5t k\u00edch th\u00edch v\u00e0 t\u00f4n tr\u1ecdng nh\u1eefng ng\u01b0\u1eddi xung quanh. Kh\u00f4ng h\u00e1t karaoke qu\u00e1 11h30.",
      "apartment_manual": null,
      "direction_manual": "Qu\u00fd kh\u00e1ch c\u00f3 th\u1ec3 d\u00f9ng google map \u0111\u1ec3 t\u00ecm \u0111\u01b0\u1eddng\nSearch BiGC- c\u1ea7u mu\u1ed7i- CV garden",
      "num_bedrooms": 2,
      "num_bathrooms": 2,
      "num_beds": 8,
      "maximum_guests": 20,
      "booking_type": "instant_book",
      "status": "Listed",
      "popular": true,
      "url": "https:\/\/www2.luxstay.com\/rooms\/16551",
      "reviews_count": 2,
      "rating": 5,
      "price": {
        "data": {
          "room_id": 16551,
          "nightly_price": 3500000,
          "monthly_price": 1000000,
          "weekend_price": 4500000,
          "cleaning_fee": 300000,
          "security_fee": 0,
          "nightly_price_formatted": "3,500,000\u20ab",
          "cleaning_fee_formatted": "300,000\u20ab",
          "security_fee_formatted": "0\u20ab",
          "additional_guests_fee": 200000,
          "currency_code": "VND",
          "standard_guests": 15,
          "cancellation_policy": null,
          "booking_type": "instant_book",
          "checkin_time": "2:0 PM",
          "checkout_time": "12:00 PM",
          "minimum_stay": 1,
          "maximum_stay": null,
          "nightly_price_usd": 148.95119209894784,
          "nightly_price_vnd": 3500000
        }
      },
      "photos": {
        "data": {
          "thumbnail": "https:\/\/cdn.luxstay.com\/rooms\/16551\/thumbnail\/1541565141_41052059_2186901398234138_4993492045352927232_njpg",
          "original": "https:\/\/cdn.luxstay.com\/rooms\/16551\/large\/1541565141_41052059_2186901398234138_4993492045352927232_njpg",
          "count": 22,
          "slides": 22
        }
      },
      "property_type": {
        "data": {
          "id": 9,
          "name": "Bi\u1ec7t Th\u1ef1",
          "description": "Villa"
        }
      },
      "address": {
        "data": {
          "address_line_1": "CV Garden, Y\u00ean B\u00e0i, Ba V\u00ec, H\u00e0 N\u1ed9i, Vi\u1ec7t Nam",
          "address_line_2": "Th\u00f4n mu\u1ed7i, x\u00e3 Y\u00ean B\u00e0i, Ba V\u00ec, h\u00e0 n\u1ed9i",
          "area": "Y\u00ean B\u00e0i",
          "city": "Ba V\u00ec",
          "state": "Ha\u0300 N\u00f4\u0323i",
          "country": "Vietnam",
          "latitude": "21.0546242",
          "longitude": "105.4331427",
          "full_address": "Th\u00f4n mu\u1ed7i, x\u00e3 Y\u00ean B\u00e0i, Ba V\u00ec, h\u00e0 n\u1ed9i, CV Garden, Y\u00ean B\u00e0i, Ba V\u00ec, H\u00e0 N\u1ed9i, Vi\u1ec7t Nam"
        }
      },
      "host": {
        "data": {
          "id": 25455,
          "full_name": "\u0110\u1eb7ngthanhb\u00ecnh Binh",
          "avatar": "https:\/\/graph.facebook.com\/2040456472677874\/picture?type=small",
          "subscribe_url": "\/api\/me\/subscriptions\/user\/25455"
        }
      }
    }
  ],
  "meta": {
    "destination_name": "H\u00e0 N\u1ed9i",
    "promotions": [
      
    ],
    "pagination": {
      "total": 1075,
      "count": 18,
      "per_page": 18,
      "current_page": 1,
      "total_pages": 60,
      "links": {
        "next": "http:\/\/www2.luxstay.com\/api\/search\/destination?page=2"
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

Error Response

Reason validation errors

Example response

# Search room

# Endpoint

# Data Params

# Request & Response Examples

# Successful Response

# 201