{"info":{"_postman_id":"e447c8de-f4c0-f994-df51-d29581ce3fa4","name":"hotels","description":"

This is an API endpoint for hotels available in Nigeria.

\n

Created by crawling hotels.ng using\nweb-crawljs.

\n

The API endpoint :\nhttps://hotels-apis.herokuapp.com/

\n

This a play project. Read this medium post to know more\nhttps://medium.com/@badewakayode/how-i-scraped-8000-hotels-from-hotels-ng-abdc4fa2510f

\n

Response

\n

The content-type header of the response is application/json.

\n

The data returned is an array Objects that has the following attribute.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
AtributeTypeDescription
_idStringThe _id of the hotel
hotel_nameStringThe name of the hotel
locationStringThe location of the hotel
cityStringThe city of the hotel
stateStringThe state of the hotel
present_priceStringThe price of the hotel when it was last crawled (not up to date)
hotelsNg_linkStringThe link to description on hotels.ng
featuresString[]the list of features in the hotel
\n

Example Data returned

\n
[\n  {\n    _id: \"5a0075853438c300122bbda0\",\n    hotel_name: \"Arede Hotels Limited\",\n    location: \"87, Agbado Road, Iju Ishaga, Agege, Lagos\",\n    city: \"Agege\",\n    state: \"Lagos\",\n    present_price: \"₦4,000\",\n    hotelsNg_link: \"https://hotels.ng/hotel/47885-arede-hotels-limited-lagos\",\n    features: [\"Restaurant\", \"Bar\"]\n  },\n  {\n    _id: \"5a0075853438c300122bbda1\",\n    hotel_name: \"Offshoreroomz Hotel\",\n    location: \"1, Odumosu Street, Off Iju Road\",\n    city: \"Agege\",\n    state: \"Lagos\",\n    present_price: \"₦5,500\",\n    hotelsNg_link: \"https://hotels.ng/hotel/1006144-offshore-roomz-hotel-lagos\",\n    features: [\"Internet\", \"Restaurant\", \"Bar\"]\n  }\n];\n
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"2909688","collectionId":"e447c8de-f4c0-f994-df51-d29581ce3fa4","publishedId":"77iaMwv","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2017-11-06T18:41:13.000Z"},"item":[{"name":"API V1 Get Hotel List","id":"113c2ecf-3971-a4ba-22e2-364aeba72215","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://hotels-apis.herokuapp.com/","description":"

This endpoint responsd with a list of hotels.

\n

https://hotels-apis.herokuapp.com/api/v1/:page

\n

Request Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
parameterrequiredDescription
pagefalsepagination of hotel
\n
","urlObject":{"protocol":"https","path":[""],"host":["hotels-apis","herokuapp","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"113c2ecf-3971-a4ba-22e2-364aeba72215"},{"name":"Search Hotels By Name","id":"9d507d27-d07a-ed3a-ac8f-dba12804a583","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://hotels-apis.herokuapp.com/name/hotel/","description":"

This endpoint returns an array of hotels that matches the name searched.

\n

https://hotels-apis.herokuapp.com/name/:nameToSearch/:pageNum

\n

Request Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
parameterrequiredDescription
nameToSearchtrueThe name used to serch for the hotels
pageNumfalseused to load the nth array of hotels
\n
","urlObject":{"protocol":"https","path":["name","hotel",""],"host":["hotels-apis","herokuapp","com"],"query":[],"variable":[]}},"response":[{"id":"c1c569cc-374b-76b6-94a9-71190d9de44b","name":"named hotels","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://hotels-apis.herokuapp.com/name/hotel/"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[],"cookie":[],"responseTime":"0","body":""}],"_postman_id":"9d507d27-d07a-ed3a-ac8f-dba12804a583"},{"name":"Get Hotels In A City","id":"c432b59d-74ff-c5ed-264f-76cd1068d5f1","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://hotels-apis.herokuapp.com/city/ikoyi","description":"

This endpoint returns hotels in a particular city.

\n

https://hotels-apis.herokuapp.com/city/:city/:pageNum

\n

Request Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
parameterrequiredDescription
citytrueThe city to get the array of hotels from
pageNumfalseused to load the nth array of hotels
\n
","urlObject":{"protocol":"https","path":["city","ikoyi"],"host":["hotels-apis","herokuapp","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c432b59d-74ff-c5ed-264f-76cd1068d5f1"},{"name":"Get Hotels In a State","id":"573b8a8a-db00-d9d1-2577-2683312f2223","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"https://hotels-apis.herokuapp.com/state/lagos","description":"

This endpoint returns hotels in a particular state

\n

https://hotels-apis.herokuapp.com/state/:state/:pageNum

\n

Request Parameters

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
parameterrequiredDescription
statetrueThe state to get the array of hotels from
pageNumfalseused to load the nth array of hotels
\n
","urlObject":{"protocol":"https","path":["state","lagos"],"host":["hotels-apis","herokuapp","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"573b8a8a-db00-d9d1-2577-2683312f2223"}]}