📈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 "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"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}")
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
$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": "+1 646-459-6565",
"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": "+1 844-763-7666",
"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": "+1 212-730-0099",
"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": "+1 212-644-1300",
"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": "+1 646-880-1999",
"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": "+1 212-226-6400",
"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": "+1 212-379-0103",
"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": "+1 212-869-1212",
"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": "+1 212-354-8844",
"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": "+1 212-581-3300",
"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": "+1 212-744-1600",
"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": "+1 212-863-0550",
"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": "+1 212-706-6100",
"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": "+1 833-625-4111",
"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": "+1 212-685-7700",
"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": "+1 646-598-0100",
"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": "+1 212-239-9100",
"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": "+1 212-371-4000",
"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": "+1 646-569-6740",
"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": "+1 212-755-1800",
"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": "+1 212-431-2929",
"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": "+1 646-449-7700",
"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": "+1 212-485-2400",
"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": "+1 212-645-0080",
"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": "+1 646-364-1234",
"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": "+1 212-245-5000",
"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": "+1 212-564-4567",
"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": "+1 212-201-2700",
"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": "+1 212-689-5200",
"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": "+1 212-564-3688",
"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": "+1 212-514-6699",
"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": "+1 212-247-2000",
"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": "+1 212-581-1000",
"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": "+1 212-925-2555",
"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": "+1 212-262-8100",
"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": "+1 212-475-5700",
"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.
Last updated