POST/hotels

Search Hotels

This API call retrieves a list of all hotels available in the ReviewsAPI database for review retrieval. If a hotel you wish to retrieve reviews for is not listed, please send the request using POST /Hotelmaprequest endpoint. We will make efforts to add the hotel to our database within 24 to 48 business hours.

POST/hotels

Mandatory Fields

country or geoLocationFilter

Optional Fields

hotelsPerPage
pageNumber
body

Parameter Details

Name	In	Type	Required	Description
`hotelsPerPage`	query	`integer`	Optional	The number of items to display in a page
`pageNumber`	query	`integer`	Optional	Indicates the current page number
`body`	body	`hotelsReq`	Optional	none

Responses

Status	Meaning	Description	Schema
200	OK	Ok	`hotelsResp`
400	Bad Request	Bad Request	None
401	Unauthorized	Authorization Failed	None
500	Internal Server Error	Internal Server Error	None

Example Request

# You can also use wget
curl -X POST /hotels \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: API_KEY'

Body parameter

{
  "hotelName": "Ocean Lodge Santa Monica Beach Hotel",
  "city": "Los Angeles",
  "state": "California",
  "country": "United States of America",
  "zip": "90401",
  "geoLocationFilter": {
    "latitude": "34.01",
    "longitude": "-118.49",
    "radius": "50km"
  }
}

Example responses

200 Response

{
  "totalRecords": 10000,
  "fetchedRecords": 10,
  "totalPages": 1000,
  "currentPage": 1,
  "pageSize": 10,
  "hotels": [
    {
      "hotelCode": 1362151,
      "hotelName": "Ocean Lodge Santa Monica Beach Hotel",
      "address": "1667 Ocean Avenue",
      "city": "Los Angeles",
      "state": "California",
      "country": "United States of America",
      "location": [{
        "latitude": "34.01012891",
        "longitude": "-118.49312648"
      }],
      "zip": "90401",
      "matchScore": 72.228226,
      "reviewsCount": 0
    }
  ]
}

PreviousGet Languages

NextSearch by Hotel Code

Need Support?

Our team is here to help you integrate and make the most of our APIs. Get in touch for technical support, custom solutions, or any questions.

Contact Support