MakCorps Hotel API Documentation

Getting Started

MakCorps Hotel API is designed to provide data like prices, reviews, ratings,etc from more than 200 vendors like Booking.com, Agoda.com, Expedia, Hotels.com,etc. A few things to consider before we get started:

How to get JWT Token?

Our API exposes a /auth endpoint to provide the JWT token. Just pass the username and password in the body you used while registering.

Sample Code

Bash

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

Result


        {
            "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1ODU1Nzk2ODMsImlhdCI6MTU4NTU3Nzg4MywibmJmIjoxNTg1NTc3ODgzLCJpZGVudGl0eSI6MTV9.iBk5dWaKrUHvQW3IY0Cah2yAGRvMCNo6uESsXPauxWg"
        }
      

How to use FREE API?

MakCorps Travel API exposes an endpoint which helps you to search for a city for free.

Parameters are
  • City:london

Sample Code

Bash

      curl --request GET \
          --url https://api.makcorps.com/free/london \
          --header 'Authorization: JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U'
      

Result


        {
      "comparison": [
          {
              "Hotel": "SponsorizzatoThe Whitechapel Hotel",
              "Best-price": "€73 Booking.com",
              "vendor1": "Tripadvisor",
              "vendor1-price": "73",
              "vendor2-price": "74",
              "vendor3-price": "73",
              "vendor2": "Hotels.com",
              "vendor3": "HRS"
          },
          {
              "Hotel": "Park Plaza Westminster Bridge London",
              "Best-price": "€199 Booking.com",
              "vendor1": "Agoda.com",
              "vendor1-price": "201",
              "vendor2-price": "200",
              "vendor3-price": "199",
              "vendor2": "Tripadvisor",
              "vendor3": "Booking.com"
          },
          {
              "Hotel": "Amba Hotel Marble Arch",
              "Best-price": "€206 Agoda.com",
              "vendor1": "Agoda.com",
              "vendor1-price": "206",
              "vendor2-price": "210",
              "vendor3-price": "208",
              "vendor2": "HRS",
              "vendor3": "Travelocity"
          },

      ]
  }
      

How to search for particular Hotel.(For premium Users Only)

MakCorps provides API to search for any Hotel in any city around the Hotel. Jus tpass the name of the hotel from our Mapping API and you are good to go. We use our own Hotel Ids and names to search Hotels. You have to Subscribe to use this API.

Parameters are
  • hotel name:LEONARDO LONDON HEATHROW
  • Currency:USD
  • Guest:1
  • Rooms:1
  • checkin:2020-10-03
  • checkout:2020-10-04

Sample Code

Bash

        curl --request GET \
            --url https://api.makcorps.com/LEONARDO LONDON HEATHROW/USD/1/1/2020-10-03/2020-10-04 \
            --header 'Authorization: JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U'
      

Result


        {
      "comparison": [
          {
              "vendor1": "eDreams",
              "price1": "88"
          },
          {
              "vendor2": "Tripadvisor",
              "price2": "88"
          },
          {
              "vendor3": "Nustay.com",
              "price3": "84"
          },
          {
              "vendor4": "Agoda.com",
              "price4": "88"
          },
          {
              "vendor5": "Booking.com",
              "price5": "88"
          },
          {
              "hotel": "Leonardo London Heathrow Airport, West Drayton, Greater London, England"
          },
          {
              "check-in": "2020/10/03",
              "check-out": "2020/10/04"
          }
      ]
  }
      

How to get a complete list of Hotels in a city? (For premium Users Only)

Using this API you will get all the Hotels in a city in JSON format. You can search for any city around the world. We use pagination system in this API. So, for every value of pagination you will get 30 hotels. You have to Subscribe to use this API.

Parameters are
  • City name:London
  • Pagination:0
  • Currency:USD
  • Rooms:1
  • Guests:3
  • checkin:2020-10-03
  • checkout:2020-10-04

Sample Code

Bash

        curl --request GET \
            --url https://api.makcorps.com/London/0/USD/1/3/2020-10-03/2020-10-04 \
            --header 'Authorization: JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U'
      

Result


        {
                  "hotelName": "Hilton London Paddington",
                  "hotelId": "209371"
              },
              [
                  {
                      "price1": "279",
                      "tax1": "70",
                      "vendor1": "Prestigia.com"
                  },
                  {
                      "price2": "253",
                      "tax2": "51",
                      "vendor2": "eDreams"
                  },
                  {
                      "price3": "244",
                      "tax3": "48",
                      "vendor3": "Nustay.com"
                  },
                  {
                      "price4": null,
                      "tax4": null,
                      "vendor4": null
                  },
                  {
                      "price5": "253",
                      "tax5": "51",
                      "vendor5": "Tripadvisor"
                  }
              ]
          ],
          [
              {
                  "hotelName": "Park Grand London Hyde Park",
                  "hotelId": "3164384"
              },
              [
                  {
                      "price1": "263",
                      "tax1": "53",
                      "vendor1": "eDreams"
                  },
                  {
                      "price2": "263",
                      "tax2": "53",
                      "vendor2": "Booking.com"
                  },
                  {
                      "price3": "263",
                      "tax3": "53",
                      "vendor3": "Agoda.com"
                  },
                  {
                      "price4": null,
                      "tax4": null,
                      "vendor4": null
                  },
                  {
                      "price5": "263",
                      "tax5": "53",
                      "vendor5": "Tripadvisor"
                  }
              ]
          ],
          [
              {
                  "hotelName": "Park Plaza Westminster Bridge London",
                  "hotelId": "1657415"
              },
              [
                  {
                      "price1": "426",
                      "tax1": "85",
                      "vendor1": "eDreams"
                  },
                  {
                      "price2": "451",
                      "tax2": "113",
                      "vendor2": "Prestigia.com"
                  },
                  {
                      "price3": "415",
                      "tax3": "82",
                      "vendor3": "Nustay.com"
                  },
                  {
                      "price4": "455",
                      "tax4": "91",
                      "vendor4": "Agoda.com"
                  },
                  {
                      "price5": null,
                      "tax5": null,
                      "vendor5": null
                  }
              ]
          ],
          [
              {
                  "hotelName": "The Darlington Hyde Park",
                  "hotelId": "214639"
              },
              [
                  {
                      "price1": "252",
                      "tax1": "50",
                      "vendor1": "eDreams"
                  },
                  {
                      "price2": "252",
                      "tax2": "50",
                      "vendor2": "Booking.com"
                  },
                  {
                      "price3": "251",
                      "tax3": "50",
                      "vendor3": "Agoda.com"
                  },
                  {
                      "price4": null,
                      "tax4": null,
                      "vendor4": null
                  },
                  {
                      "price5": "252",
                      "tax5": "50",
                      "vendor5": "Tripadvisor"
                  }
              ]
      

How to get all the Room Types offered by the Hotel? (For premium Users Only)

Our API exposes another endpoint to let you search for the different rooms offered by the Hotel. It also provides prices from multiple vendors for each room. You have to Subscribe to use this API.

Parameters are
  • Checkin:2020-02-15
  • Checkout:2020-02-16
  • Currency:USD
  • Rooms:1
  • Guests:3
  • Hotel Name:Nasa Vegas Hotel
  • Hotel Location:Vegas

Sample Code

Bash

        curl --request GET \
            --url https://api.makcorps.com/2020-02-15/2020-02-16/USD/1/3/Nasa_Vegas_Hotel/vegas \
            --header 'Authorization: JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1MTc2NzczNjAsImlkZW50aXR5IjozLCJuYmYiOjE1MTc2NzczNjAsImV4cCI6MTUxNzY3OTE2MH0.ytSqQj3VDymEaJz9EIdskWELwDQZRD1Dbo6TuHaPz9U'
      

Result


        {
      "comparison": [

          {
              "vendor": "Agoda.com",
              "room-type": "Executive Deluxe",
              "room-price": "$42"
          },
          {
              "vendor": "Booking.com",
              "room-type":"Executive Super Deluxe Double Or Twin Room - Non-Refundable - Free Wifi",
              "room-price": "$73"
          },
          {
              "vendor": "ZenHotels.com",
              "room-type": "Executive Double Room (Double Bed) (Bed Type Is Subject To Availability) ",
              "room-price": "$42"
          },
          {
              "vendor": "ZenHotels.com",
              "room-type": "Deluxe Double Room (Double Bed)",
              "room-price": "$42"
          },
          {
              "vendor": "getaroom.com",
              "room-type": "Executive Deluxe",
              "room-price": "$44"
          },
          {
              "vendor": "Agoda.com",
              "room-type": "Deluxe Double",
              "room-price": "$47"
          },
          {
              "vendor": "Agoda.com",
              "room-type": "Executive Super Deluxe",
              "room-price": "$55"
          },
          {
              "vendor": "Agoda.com",
              "room-type": "Room Assigned On Arrival ",
              "room-price": "$56"
          },
          {
              "vendor": "getaroom.com",
              "room-type": "Executive",
              "room-price": "$56"
          },
          {
              "vendor": "Agoda.com",
              "room-type": "Deluxe Double",
              "room-price": "$59"
          },
          {
              "vendor": "getaroom.com",
              "room-type": "Double Or Twin Executive Super Deluxe Double/ Twin",
              "room-price": "$58"
          },
          {
              "vendor": "getaroom.com",
              "room-type": "Deluxe Double",
              "room-price": "$60"
          },
          {
              "vendor": "ZenHotels.com",
              "room-type": "Deluxe Double Room (Double Bed) (Bed Type Is Subject To Availability)",
              "room-price": "$70"
          },
          {
              "vendor": "Expedia.com",
              "room-type": "Executive Super Deluxe Double Or Twin",
              "room-price": "$81"
          },
          {
              "vendor": "ZenHotels.com",
              "room-type": "Deluxe Double Room (Double Bed)",
              "room-price": "$81"
          },
          {
              "vendor": "Hotels.com",
              "room-type": "Executive Super Deluxe Double Or Twin",
              "room-price": "$81"
          },
          {
              "vendor": "Orbitz.com",
              "room-type": "Executive Super Deluxe Double Or Twin",
              "room-price": "$81"
          },
          {
              "vendor": "Travelocity.com",
              "room-type": "Executive Super Deluxe Double Or Twin",
              "room-price": "$81"
          },
          {
              "vendor": "Expedia.com",
              "room-type": "Executive Super Deluxe Double Or Twin",
              "room-price": "$131"
          },
          {
              "vendor": "Hotels.com",
              "room-type": "Executive Super Deluxe Double Or Twin",
              "room-price": "$131"
          },
          {
              "vendor": "getaroom.com",
              "room-type": "Double Or Twin Deluxe Executive",
              "room-price": "$136"
          },
          {
              "vendor": "Orbitz.com",
              "room-type": "Executive Super Deluxe Double Or Twin",
              "room-price": "$131"
          },
          {
              "vendor": "Travelocity.com",
              "room-type": "Executive Super Deluxe Double Or Twin",
              "room-price": "$131"
          }
      ]
  }
      
If you have any questions, you can contact support or email us at [email protected]
Our Story
We are working in this industry for 4 year now with Hotel Price Comparison API. Now we have launched Flight API.
Flight API