💻Free Hotel API

This is the free hotel API that anyone can access. Using this Hotel API you will get JSON data with hotel pricing from multiple vendors for any random future date.

API endpoint for this API is: https://api.makcorps.com/free

Guide

You can pass the name of any city from any country to this API and our API will respond results according to that.

This API has some limitations which has been discussed at the bottom of this page.

Here is the list of parameters you have to pass to this API:

Parameters

Description

city

Name of the city

Usage

You have to send a GET request to https://api.makcorps.com/auth along with the name of the city and the JWT token you might have received from the JWT Token API.

curl -X GET \
  -H "Authorization: JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U" \
  https://api.makcorps.com/free/london

import requests

url = 'https://api.makcorps.com/free/london'
headers = {
    'Authorization': 'JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U'
}

response = requests.get(url, headers=headers)

# Print the response
print(response.json())

const axios = require('axios');

const url = 'https://api.makcorps.com/free/london';
const headers = {
  'Authorization': 'JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U'
};

axios.get(url, { headers })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

Response

The sample response of the API will look somewhat like this.

[
      {
        "hotelName": "ITC Grand Central, Mumbai - a Luxury Collection Hotel",
        "hotelId": "503409"
      },
      [
        {
          "price1": "180",
          "tax1": "27",
          "vendor1": "Booking.com"
        },
        {
          "price2": "180",
          "tax2": "27",
          "vendor2": "Hotels.com"
        },
        {
          "price3": "182",
          "tax3": "29",
          "vendor3": "StayForLong"
        },
        {
          "price4": "153",
          "tax4": "0",
          "vendor4": "Priceline"
        }
      ]
    ],
    [
      {
        "hotelName": "Bloom Hotel - Worli",
        "hotelId": "23526565"
      },
      [
        {
          "price1": "78",
          "tax1": "8",
          "vendor1": "Booking.com"
        },
        {
          "price2": "77",
          "tax2": "0",
          "vendor2": "Priceline"
        },
        {
          "price3": "86",
          "tax3": "9",
          "vendor3": "Trip.com"
        },
        {
          "price4": null,
          "tax4": null,
          "vendor4": "Vio.com"
        }
      ]
    ],
    [
      {
        "hotelName": "Bloom Hotel - Juhu",
        "hotelId": "23337279"
      },
      [
        {
          "price1": "72",
          "tax1": "8",
          "vendor1": "Booking.com"
        },
        {
          "price2": "90",
          "tax2": "10",
          "vendor2": "Hotels.com"
        },
        {
          "price3": "94",
          "tax3": "13",
          "vendor3": "StayForLong"
        },
        {
          "price4": "79",
          "tax4": "8",
          "vendor4": "Trip.com"
        }
      ]
    ],
    [
      {
        "hotelName": "The Oberoi Mumbai",
        "hotelId": "304225"
      },
      [
        {
          "price1": "204",
          "tax1": "31",
          "vendor1": "Booking.com"
        },
        {
          "price2": "204",
          "tax2": "31",
          "vendor2": "Hotels.com"
        },
        {
          "price3": "209",
          "tax3": "35",
          "vendor3": "StayForLong"
        },
        {
          "price4": "173",
          "tax4": "0",
          "vendor4": "Priceline"
        }
      ]
    ],
    [
      {
        "hotelName": "Radisson Blu Mumbai International Airport",
        "hotelId": "21362523"
      },
      [
        {
          "price1": "202",
          "tax1": "31",
          "vendor1": "Booking.com"
        },
        {
          "price2": "202",
          "tax2": "31",
          "vendor2": "Hotels.com"
        },
        {
          "price3": "202",
          "tax3": "31",
          "vendor3": "Expedia.com"
        },
        {
          "price4": "171",
          "tax4": "0",
          "vendor4": "Priceline"
        }
      ]
    ],
    [
      {
        "hotelName": "The Fern - Goregaon",
        "hotelId": "11774410"
      },
      [
        {
          "price1": "223",
          "tax1": "34",
          "vendor1": "Hotels.com"
        },
        {
          "price2": "220",
          "tax2": "20",
          "vendor2": "StayForLong"
        },
        {
          "price3": "180",
          "tax3": "28",
          "vendor3": "Trip.com"
        },
        {
          "price4": "165",
          "tax4": "25",
          "vendor4": "Agoda.com"
        }
      ]
    ],

Understand the Response

Properties

Description

price

Price offered by the vendor

vendor

Name of the vendor

tax

Tax you will be charged at the booking

hotelName

Name of the hotel

hoteId

Id of the hotel in our system

Limitations of this API

Since this is the free version of our API therefore this API has some limitations.

You will get rates for any random future dates because users will not be able to pass check-in and check-out dates to this API.
You will only get 30 hotels for any city.
You cannot pass pax count like the number of adults or the number of rooms in this API.

If you want to bypass these limitations then you have to gain access to our premium APIs. You can sign up for our premium APIs or if you want to test those APIs before signing up then you can contact us here. Remember we provide access to companies only.

PreviousJWT Token API NextHotel API - Search by City Name