📈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 |
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