NAV Navbar
Logo
shell

Introduction

Welcome to Hotel price Comparison API Documentation. Our API is organized around GET Requests. You can use our API to get information for International Hotel Prices in dollars

Authentication

curl --request POST \
  --url 'https://api.makcorps.com/auth' \
  --header 'Content-Type: application/json' \
  --data '{
	"username":"franklin",
	"password":"[email protected]"
}'

JSON Response:

{
"access_token": 

{"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U"}

You must have an JWT Token to use the API functions. Complete the registration to get your JWT token.

Your JWT token will expire after every 30 min.So, you have to request for new JWT token after every 30 min.Your JWT token must be included in the every request.

API Functions

Price Status

Purpose

Get Live Prices of hotels in different cities.

Request URL

curl --request GET \ --url https://api.makcorps.com/king/v2/city/check_in/check_out \ --header 'Authorization: JWT jwt_token'

URL Parameters

Parameter Description
city The city name (ex. london)
jwt_token The access token
check_in and check_out ex. check_in = 2018-05-10 and check_out = 2018-05-11.
you can replace "city" with any area of he city restricted to paid users only ex-(https://api.makcorps.com/king/v2/new york airport/2018-05-10/2018-05-11).
curl --request GET \
  --url https://api.makcorps.com/king/v2/jakarta/2018-06-10/2018-06-11 \
  --header 'Authorization: JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U'

JSON Response:

{
  "comparison":[ ,
  
    {
    "Hotel": Hotel Borobudur Jakarta,
    "vendor 1": Expedia.com US $62,
    "latitude": -6.17511,
    "check-in": 2018/05/10,
    "check-out": 2018/05/11,
    "features": free parking, wifi and breakfast,
    "vendor 2": Booking.com US $67,
    "amenities(Executive)": "Conference Facilities, Pool",,
    "room-available": 37,
    "review-highlights": "We loved our stay at Hotel Borobudur.  hotel and casino is22 June 2018",
    "amenities": "Room service, Restaurant, Air conditioning ,Dry cleaning, Meeting rooms, Air Port Transportation",
    "best vendor": Expedia,
    "vendor 3": Hotels.com US $63,
    "ratings": 5,
    "discount-price": SAVE US$33 ,
    "image": "https://media-cdn.tripadvisor.com/media/photo-i/12/6e/29/21/junior-suite.jpg",
    "best-price": Expedia.com,
    "city and state": "jakarta, jakarta",
    "longitude": "106.8650395"
    "reviews": "1,431 reviews",
    },
    {
    "Hotel": JW Marriott Hotel Jakarta,
    "vendor 1": Expedia.comUS$ 146,
    "latitude": -6.17511,
    "check-in": "2018/05/10",,
    "features": "Free WiFi",,
    "longitude": 106.8650395,,
    "reviews": "1,412 reviews",,
    "vendor 2": "Booking.comUS$ 148",,
    "amenities(Executive)": "Bar, Pool",,
    "room-available": 13,
    "review-highlights": "not attentive but it’s the way New York hôtel are . Typical food nice23 April 2018",
    "amenities": "Room service, Restaurant, Air conditioning ,Dry cleaning, Meeting rooms, Air Port Transportation",    
    "ratings": "3.2,,
    "discount-price": null,,
    "image": "https://media-cdn.tripadvisor.com/media/photo-i/06/82/5f/8c/hyatt-regency-mumbai.jpg",,
    "best-price": "Expedia.com",,
    "city and state":  "jakarta,Jakarta",,
    "check-out": "2018/05/11",,
    "best-vendor": "Expedia",
    "vendor 3": Orbitz.com US $147,
    },
    {
    "Hotel": Shangri-La Hotel Jakarta,
    "vendor 1": "Booking.com US $152",,
    "latitude": -6.17511,,
    "check-in": "2018/05/10",,
    "features": "free parking, wifi and breakfast",
    "longitude": 106.8650395,,
    "review": "8Very good (200 reviews)",,
    "vendor 2": "Expedia.com US $155",,
    "amenities(Executive)": "Bar, Pool",,
    "room-available": 27,
    "review-highlights": "Its my dream hotel to stay during summer",
    "amenities": "Room service, Restaurant, Air conditioning ,Dry cleaning, Meeting rooms, Air Port Transportation",
    "discount-price": null,,
    "image": "https://media-cdn.tripadvisor.com/media/photo-i/11/db/b2/c2/exterior.jpg",,
    "ratings": 4.7,,
    "best-price": "Booking.com",,
    "city and state": "jakarta,Jakarta",,
    "check-out": "2018/05/11",,
    "best-vendor":  "Hotels.com",
    "vendor 3": "Shangri-La.com US $154",
    },
    

Response Codes

The response_code key included in each response contains the status of the result returned.

Codes and their meanings:

Code Description
200 Success.
400 Bad request.A user with that email or username already exists
401 Unauthorized or invalid token.
404 Data couldn’t be loaded on our servers. No data available.
405 Data couldn’t be loaded on our servers. Request couldn’t go through.
500 Unauthorized API Token.
501 Account Expired.
502 Invalid arguments passed.