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/classic/v2/hotel name/city/check_in/check_out \ --header 'Authorization: JWT jwt_token'

URL Parameters

Parameter Description
city The city name (ex. Jakarta)
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/classic/v2/Hotel Borobudur Jakarta/jakarta/2018-05-10/2018-05-11).
curl --request GET \
  --url https://api.makcorps.com/classic/v2/Hotel Borobudur Jakarta/jakarta/2018-06-10/2018-06-11 \
  --header 'Authorization: JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U'

JSON Response:

{
  "comparison":[ ,
  
    {
    "Hotel": Hotel Borobudur Jakarta,
    "Address": Jl. Lapangan Banteng Selatan, Jakarta 10710, Indonesia,
    "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",
    },
    
    
    

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.