📈Hotel API - Search by City ID

In a single API request to this API will return all the hotels in a city with top 4 cheapest vendors.

In this API you will get a complete list of hotels in a city with the top 4 cheapest vendors.

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

Parameters

Parameter	Description
api_key required	Your personal API key.
cityid required	ID of the city
pagination required	It is a page number. It starts with 0 and each page will provide you almost 30 hotels.
cur required	It could be any currency like USD, INR, EUR, etc.
rooms required	It is the number of rooms.
adults required	It is the number of adults.
checkin required	It is the check-in date. Format - YYYY-MM-DD
checkout required	It is the check-out date. Format - YYYY-MM-DD
tax	It is a boolean. If it is set as true then you will get prices including tax otherwise without tax.
children	It represents the number of children. It has a maximum value of 10 and a minimum value of 0.

To get the ID of the city refer to our Mapping API.

API Example

cURL

curl "https://api.makcorps.com/city?cityid=60763&pagination=0&cur=USD&rooms=1&adults=2&checkin=2023-12-25&checkout=2023-12-26&api_key=6576a85d9796563d73e34228401"

Python

import requests

url = "https://api.makcorps.com/city"
params = {
    'cityid': '60763',
    'pagination': '0',
    'cur': 'USD',
    'rooms': '1',
    'adults': '2',
    'checkin': '2023-12-25',
    'checkout': '2023-12-26',
    'api_key': '6576a85d9796563d73e34228401'
}

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

# Check if the request was successful (status code 200)
if response.status_code == 200:
    # Parse JSON response
    json_data = response.json()
    
    # Print or use the parsed JSON data
    print(json_data)
else:
    # Print an error message if the request was not successful
    print(f"Error: {response.status_code}, {response.text}")

Nodejs

const axios = require('axios');

const url = 'https://api.makcorps.com/city';
const params = {
    cityid: '60763',
    pagination: '0',
    cur: 'USD',
    rooms: '1',
    adults: '2',
    checkin: '2023-12-25',
    checkout: '2023-12-26',
    api_key: '6576a85d9796563d73e34228401'
};

axios.get(url, { params })
    .then(response => {
        // Log or process the response data
        console.log(response.data);
    })
    .catch(error => {
        // Log or handle the error
        console.error(`Error: ${error.message}`);
    });

PHP

<?php

$url = 'https://api.makcorps.com/city';
$params = array(
    'cityid' => '60763',
    'pagination' => '0',
    'cur' => 'USD',
    'rooms' => '1',
    'adults' => '2',
    'checkin' => '2023-12-25',
    'checkout' => '2023-12-26',
    'api_key' => '6576a85d9796563d73e34228401'
);

$queryString = http_build_query($params);
$fullUrl = $url . '?' . $queryString;

$response = file_get_contents($fullUrl);

// Check if the request was successful
if ($response !== false) {
    // Parse JSON response
    $json_data = json_decode($response, true);

    // Print or use the parsed JSON data
    print_r($json_data);
} else {
    // Handle the error
    echo "Error: Unable to fetch data.";
}
?>

Response

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

[
  {
    "geocode": {
      "latitude": 40.762447,
      "longitude": -73.97927
    },
    "telephone": "[phone]",
    "name": "Hilton Club The Residences New York",
    "hotelId": 14013137,
    "reviews": {
      "rating": 4.5,
      "count": 193
    },
    "vendor1": "Hilton",
    "price1": "$1,443"
  },
  {
    "geocode": {
      "latitude": 40.755814,
      "longitude": -73.96907
    },
    "telephone": "[phone]",
    "name": "Pod 51 Hotel",
    "hotelId": 93358,
    "reviews": {
      "rating": 4,
      "count": 6176
    },
    "vendor1": "Expedia.com",
    "price1": "$215",
    "vendor2": "Booking.com",
    "price2": "$215",
    "vendor3": "Hotels.com",
    "price3": "$215",
    "vendor4": "Priceline",
    "price4": "$161"
  },
  {
    "geocode": {
      "latitude": 40.754547,
      "longitude": -73.98559
    },
    "telephone": "[phone]",
    "name": "Luma Hotel Time Square",
    "hotelId": 10679074,
    "reviews": {
      "rating": 5,
      "count": 2583
    },
    "vendor1": "Expedia.com",
    "price1": "$375",
    "vendor2": "Booking.com",
    "price2": "$395",
    "vendor3": "Hotels.com",
    "price3": "$375",
    "vendor4": "Vio.com",
    "price4": "$359"
  },
  {
    "geocode": {
      "latitude": 40.75743,
      "longitude": -73.96978
    },
    "telephone": "[phone]",
    "name": "Courtyard by Marriott New York Manhattan / Midtown East",
    "hotelId": 99371,
    "reviews": {
      "rating": 4.5,
      "count": 3041
    },
    "vendor1": "Expedia.com",
    "price1": "$467",
    "vendor2": "Hotels.com",
    "price2": "$467",
    "vendor3": "ZenHotels.com",
    "price3": "$478",
    "vendor4": "Algotels",
    "price4": "$419"
  },
  {
    "geocode": {
      "latitude": 40.71263,
      "longitude": -74.00919
    },
    "telephone": "[phone]",
    "name": "Four Seasons Hotel New York Downtown",
    "hotelId": 10330604,
    "reviews": {
      "rating": 4.5,
      "count": 768
    },
    "vendor1": "Expedia.com",
    "price1": "$970",
    "vendor2": "Hotels.com",
    "price2": "$970",
    "vendor3": "FourSeasons.com",
    "price3": "$970",
    "vendor4": "Skyscanner.com",
    "price4": "$911"
  },
  {
    "geocode": {
      "latitude": 40.722992,
      "longitude": -73.997345
    },
    "telephone": "[phone]",
    "name": "Crosby Street Hotel",
    "hotelId": 1572980,
    "reviews": {
      "rating": 5,
      "count": 916
    },
    "vendor1": "Design Hotels",
    "price1": "$965",
    "vendor2": "Booking.com",
    "price2": "$965",
    "vendor3": "Priceline",
    "price3": "$965",
    "vendor4": "Skyscanner.com",
    "price4": "$965"
  },
  {
    "geocode": {
      "latitude": 40.76444,
      "longitude": -73.978035
    },
    "telephone": "[phone]",
    "name": "Hilton Club West 57th Street New York",
    "hotelId": 1308397,
    "reviews": {
      "rating": 4.5,
      "count": 1930
    },
    "vendor1": "Hilton",
    "price1": "$637"
  },
  {
    "geocode": {
      "latitude": 40.75642,
      "longitude": -73.98555
    },
    "telephone": "[phone]",
    "name": "Casablanca Hotel by Library Hotel Collection",
    "hotelId": 113317,
    "reviews": {
      "rating": 5,
      "count": 7421
    },
    "vendor1": "Expedia.com",
    "price1": "$332",
    "vendor2": "Hotels.com",
    "price2": "$332",
    "vendor3": "Orbitz.com",
    "price3": "$332",
    "vendor4": "ZenHotels.com",
    "price4": "$324"
  },
  {
    "geocode": {
      "latitude": 40.7552,
      "longitude": -73.9815
    },
    "telephone": "[phone]",
    "name": "Sofitel New York",
    "hotelId": 208454,
    "reviews": {
      "rating": 4.5,
      "count": 7856
    },
    "vendor1": "Expedia.com",
    "price1": "$569",
    "vendor2": "Hotels.com",
    "price2": "$569",
    "vendor3": "travelup.com",
    "price3": "$601",
    "vendor4": "Algotels",
    "price4": "$450"
  },
  {
    "geocode": {
      "latitude": 40.762115,
      "longitude": -73.98277
    },
    "telephone": "[phone]",
    "name": "The Manhattan at Times Square Hotel",
    "hotelId": 93545,
    "reviews": {
      "rating": 3.5,
      "count": 12624
    },
    "vendor1": "Expedia.com",
    "price1": "$192",
    "vendor2": "Booking.com",
    "price2": "$263",
    "vendor3": "Trip.com",
    "price3": "$359",
    "vendor4": "Vio.com",
    "price4": "$177"
  },
  {
    "geocode": {
      "latitude": 40.77442,
      "longitude": -73.96312
    },
    "telephone": "[phone]",
    "name": "The Carlyle, A Rosewood Hotel",
    "hotelId": 93419,
    "reviews": {
      "rating": 4.5,
      "count": 93
    },
    "vendor1": "Expedia.com",
    "price1": "$1,275",
    "vendor2": "Official Site",
    "price2": "$1,275",
    "vendor3": "Hotels.com",
    "price3": "$1,275",
    "vendor4": "Skyscanner.com",
    "price4": "$828"
  },
  {
    "geocode": {
      "latitude": 40.759712,
      "longitude": -73.977776
    },
    "telephone": "[phone]",
    "name": "The Jewel Hotel",
    "hotelId": 1913413,
    "reviews": {
      "rating": 4.5,
      "count": 3371
    },
    "vendor1": "Expedia.com",
    "price1": "$342",
    "vendor2": "Hotels.com",
    "price2": "$342",
    "vendor3": "Trip.com",
    "price3": "$350",
    "vendor4": "Algotels",
    "price4": "$301"
  },
  {
    "geocode": {
      "latitude": 40.756653,
      "longitude": -73.9926
    },
    "telephone": "[phone]",
    "name": "Distrikt Hotel New York City",
    "hotelId": 1503474,
    "reviews": {
      "rating": 4.5,
      "count": 6517
    },
    "vendor1": "Tapestry",
    "price1": "$212"
  },
  {
    "geocode": {
      "latitude": 40.764847,
      "longitude": -73.976456
    },
    "telephone": "[phone]",
    "name": "1 Hotel Central Park",
    "hotelId": 6883205,
    "reviews": {
      "rating": 4.5,
      "count": 2629
    },
    "vendor1": "Expedia.com",
    "price1": "$499",
    "vendor2": "Booking.com",
    "price2": "$499",
    "vendor3": "Hotels.com",
    "price3": "$499",
    "vendor4": "Vio.com",
    "price4": "$470"
  },
  {
    "geocode": {
      "latitude": 40.742035,
      "longitude": -73.984634
    },
    "telephone": "[phone]",
    "name": "Hotel Giraffe by Library Hotel Collection",
    "hotelId": 99762,
    "reviews": {
      "rating": 5,
      "count": 5228
    },
    "vendor1": "Expedia.com",
    "price1": "$302",
    "vendor2": "Hotels.com",
    "price2": "$302",
    "vendor3": "Priceline",
    "price3": "$365",
    "vendor4": "Booking.com",
    "price4": "$328"
  },
  {
    "geocode": {
      "latitude": 40.706505,
      "longitude": -74.007774
    },
    "telephone": "[phone]",
    "name": "Mint House at 70 Pine",
    "hotelId": 8501479,
    "reviews": {
      "rating": 5,
      "count": 1361
    },
    "vendor1": "Expedia.com",
    "price1": "$274",
    "vendor2": "Hotels.com",
    "price2": "$274",
    "vendor3": "Prestigia.com",
    "price3": "$310",
    "vendor4": "Official Hotel",
    "price4": "$274"
  },
  {
    "geocode": {
      "latitude": 40.75043,
      "longitude": -73.98583
    },
    "telephone": "[phone]",
    "name": "Hyatt Place New York / Midtown - South",
    "hotelId": 2554351,
    "reviews": {
      "rating": 4,
      "count": 3211
    },
    "vendor1": "Expedia.com",
    "price1": "$290",
    "vendor2": "Hotels.com",
    "price2": "$290",
    "vendor3": "ZenHotels.com",
    "price3": "$352",
    "vendor4": "StayForLong",
    "price4": "$277"
  },
  {
    "geocode": {
      "latitude": 40.76507,
      "longitude": -73.975266
    },
    "telephone": "[phone]",
    "name": "Park Lane Hotel NY",
    "hotelId": 93579,
    "reviews": {
      "rating": 4,
      "count": 466
    },
    "vendor1": "Expedia.com",
    "price1": "$516",
    "vendor2": "Hotels.com",
    "price2": "$516",
    "vendor3": "Priceline",
    "price3": "$549",
    "vendor4": "ZenHotels.com",
    "price4": "$422"
  },
  {
    "geocode": {
      "latitude": 40.75643,
      "longitude": -73.98067
    },
    "telephone": "[phone]",
    "name": "Hilton Garden Inn New York Times Square North",
    "hotelId": 23753245,
    "reviews": {
      "rating": 4.5,
      "count": 1383
    },
    "vendor1": "Hilton Garden Inn",
    "price1": "$291"
  },
  {
    "geocode": {
      "latitude": 40.756016,
      "longitude": -73.97144
    },
    "telephone": "[phone]",
    "name": "San Carlos Hotel",
    "hotelId": 80112,
    "reviews": {
      "rating": 4.5,
      "count": 2117
    },
    "vendor1": "Expedia.com",
    "price1": "$319",
    "vendor2": "Booking.com",
    "price2": "$319",
    "vendor3": "travelup.com",
    "price3": "$320",
    "vendor4": "Algotels",
    "price4": "$255"
  },
  {
    "geocode": {
      "latitude": 40.72143,
      "longitude": -73.99933
    },
    "telephone": "[phone]",
    "name": "The Broome",
    "hotelId": 5072714,
    "reviews": {
      "rating": 5,
      "count": 697
    },
    "vendor1": "Expedia.com",
    "price1": "$309",
    "vendor2": "Hotels.com",
    "price2": "$309",
    "vendor3": "Trip.com",
    "price3": "$1,026",
    "vendor4": "Orbitz.com",
    "price4": "$309"
  },
  {
    "geocode": {
      "latitude": 40.759163,
      "longitude": -73.99547
    },
    "telephone": "[phone]",
    "name": "YOTEL New York Times Square",
    "hotelId": 2079052,
    "reviews": {
      "rating": 4,
      "count": 14858
    },
    "vendor1": "Expedia.com",
    "price1": "$191",
    "vendor2": "Hotels.com",
    "price2": "$191",
    "vendor3": "ZenHotels.com",
    "price3": "$203",
    "vendor4": "Algotels",
    "price4": "$168"
  },
  {
    "geocode": {
      "latitude": 40.758045,
      "longitude": -73.983574
    },
    "telephone": "[phone]",
    "name": "The Muse New York",
    "hotelId": 217616,
    "reviews": {
      "rating": 4.5,
      "count": 3864
    },
    "vendor1": "Expedia.com",
    "price1": "$325",
    "vendor2": "Hotels.com",
    "price2": "$325",
    "vendor3": "travelup.com",
    "price3": "$448",
    "vendor4": "Algotels",
    "price4": "$273"
  },
  {
    "geocode": {
      "latitude": 40.72203,
      "longitude": -73.98859
    },
    "telephone": "1.877.460.8888",
    "name": "Sixty LES",
    "hotelId": 1128769,
    "reviews": {
      "rating": 4,
      "count": 1564
    },
    "vendor1": "Expedia.com",
    "price1": "$259",
    "vendor2": "Hotels.com",
    "price2": "$259",
    "vendor3": "Algotels",
    "price3": "$322",
    "vendor4": "ZenHotels.com",
    "price4": "$232"
  },
  {
    "geocode": {
      "latitude": 40.75048,
      "longitude": -73.983925
    },
    "telephone": "[phone]",
    "name": "The Draper New York, Tapestry Collection by Hilton",
    "hotelId": 20021058,
    "reviews": {
      "rating": 4.5,
      "count": 559
    },
    "vendor1": "Tapestry",
    "price1": "$228"
  },
  {
    "geocode": {
      "latitude": 40.75747,
      "longitude": -73.98409
    },
    "telephone": "[phone]",
    "name": "Hyatt Centric Times Square New York",
    "hotelId": 4799063,
    "reviews": {
      "rating": 4.5,
      "count": 6727
    },
    "vendor1": "Expedia.com",
    "price1": "$359",
    "vendor2": "Booking.com",
    "price2": "$359",
    "vendor3": "Lol.travel",
    "price3": "$1,285",
    "vendor4": "Hotels.com",
    "price4": "$359"
  },
  {
    "geocode": {
      "latitude": 40.764202,
      "longitude": -73.97852
    },
    "telephone": "[phone]",
    "name": "Thompson Central Park New York",
    "hotelId": 93464,
    "reviews": {
      "rating": 4.5,
      "count": 486
    },
    "vendor1": "Booking.com",
    "price1": "$506",
    "vendor2": "Expedia.com",
    "price2": "$506",
    "vendor3": "ZenHotels.com",
    "price3": "$527",
    "vendor4": "Algotels",
    "price4": "$448"
  },
  {
    "geocode": {
      "latitude": 40.747093,
      "longitude": -73.98998
    },
    "telephone": "[phone]",
    "name": "Kimpton Hotel Eventi",
    "hotelId": 1456560,
    "reviews": {
      "rating": 4.5,
      "count": 4205
    },
    "vendor1": "Expedia.com",
    "price1": "$288",
    "vendor2": "Hotels.com",
    "price2": "$288",
    "vendor3": "Trip.com",
    "price3": "$317",
    "vendor4": "Algotels",
    "price4": "$206"
  },
  {
    "geocode": {
      "latitude": 40.75757,
      "longitude": -73.9891
    },
    "telephone": "[phone]",
    "name": "The Westin New York at Times Square",
    "hotelId": 249712,
    "reviews": {
      "rating": 4,
      "count": 4099
    },
    "vendor1": "Expedia.com",
    "price1": "$381",
    "vendor2": "Hotels.com",
    "price2": "$381",
    "vendor3": "travelup.com",
    "price3": "$439",
    "vendor4": "Algotels",
    "price4": "$302"
  },
  {
    "geocode": {
      "latitude": 40.748455,
      "longitude": -73.97804
    },
    "telephone": "[phone]",
    "name": "The Shelburne Sonesta New York",
    "hotelId": 93543,
    "reviews": {
      "rating": 4.5,
      "count": 5813
    },
    "vendor1": "Expedia.com",
    "price1": "$240",
    "vendor2": "Booking.com",
    "price2": "$194",
    "vendor3": "Lol.travel",
    "price3": "$363",
    "vendor4": "ZenHotels.com",
    "price4": "$167"
  },
  {
    "geocode": {
      "latitude": 40.750298,
      "longitude": -73.986435
    },
    "telephone": "[phone]",
    "name": "Hampton Inn Manhattan-35th St/Empire State Bldg",
    "hotelId": 1158763,
    "reviews": {
      "rating": 4,
      "count": 2968
    },
    "vendor1": "Hampton",
    "price1": "$257"
  },
  {
    "geocode": {
      "latitude": 40.746418,
      "longitude": -73.99081
    },
    "telephone": "[phone]",
    "name": "Moxy NYC Chelsea",
    "hotelId": 14149815,
    "reviews": {
      "rating": 4.5,
      "count": 1202
    },
    "vendor1": "Moxy Hotels",
    "price1": "$229",
    "vendor2": "Expedia.com",
    "price2": "$229",
    "vendor3": "Algotels",
    "price3": "$253",
    "vendor4": "Booking.com",
    "price4": "$229"
  },
  {
    "geocode": {
      "latitude": 40.76442,
      "longitude": -73.98197
    },
    "telephone": "[phone]",
    "name": "Dream Midtown",
    "hotelId": 75688,
    "reviews": {
      "rating": 4,
      "count": 1295
    },
    "vendor1": "Expedia.com",
    "price1": "$200",
    "vendor2": "Booking.com",
    "price2": "$235",
    "vendor3": "Hotels.com",
    "price3": "$200",
    "vendor4": "Orbitz.com",
    "price4": "$200"
  },
  {
    "geocode": {
      "latitude": 40.76242,
      "longitude": -73.981804
    },
    "telephone": "[phone]",
    "name": "Sheraton New York Times Square Hotel",
    "hotelId": 93555,
    "reviews": {
      "rating": 4,
      "count": 11794
    },
    "vendor1": "Expedia.com",
    "price1": "$305",
    "vendor2": "Sheraton.com",
    "price2": "$305",
    "vendor3": "ZenHotels.com",
    "price3": "$364",
    "vendor4": "Algotels",
    "price4": "$290"
  },
  {
    "geocode": {
      "latitude": 40.720634,
      "longitude": -73.99511
    },
    "telephone": "[phone]",
    "name": "The Nolitan Hotel",
    "hotelId": 1746459,
    "reviews": {
      "rating": 4.5,
      "count": 1100
    },
    "vendor1": "Expedia.com",
    "price1": "$187",
    "vendor2": "Hotels.com",
    "price2": "$187",
    "vendor3": "Booking.com",
    "price3": "$187",
    "vendor4": "Orbitz.com",
    "price4": "$187"
  },
  {
    "geocode": {
      "latitude": 40.75894,
      "longitude": -73.98448
    },
    "telephone": "[phone]",
    "name": "Tempo by Hilton New York Times Square",
    "hotelId": 25364031,
    "reviews": {
      "rating": 4.5,
      "count": 157
    },
    "vendor1": "Tempo",
    "price1": "$276",
    "vendor2": "Expedia.com",
    "price2": "$276",
    "vendor3": "Booking.com",
    "price3": "$310",
    "vendor4": "Hotels.com",
    "price4": "$276"
  },
  {
    "geocode": {
      "latitude": 40.72794,
      "longitude": -73.99078
    },
    "telephone": "[phone]",
    "name": "The Standard, East Village",
    "hotelId": 1149402,
    "reviews": {
      "rating": 4.5,
      "count": 1440
    },
    "vendor1": "Expedia.com",
    "price1": "$295",
    "vendor2": "Hotels.com",
    "price2": "$295",
    "vendor3": "Priceline",
    "price3": "$329",
    "vendor4": "Agoda.com",
    "price4": "$247"
  },
  [
    {
      "totalHotelCount": 910,
      "totalpageCount": 30,
      "currentPageHotelsCount": 37,
      "currentPageNumber": 1
    }
  ]
]

Understand the Response

Properties	Description
price	Price offered by the vendor
vendor	Name of the vendor
telephone	Telephone number of the hotel
geocode	Geolocation of the hotel
rating	Average rating of the hotel
count	Number of reviews
hotelId	ID of the hotel
name	Name of the hotel
totalHotelCount	Total Number of Hotels in this city
totalpageCount	Total Pages
currentPageHotelsCount	Total hotels returned with this API call.
currentPageNumber	This is the current page number.

Each call in this pattern to our API will be counted as 1 API request. That means for every request to our API you will get 30 hotels in that target city.