ETG API V3
Content API
Retrieve hotels review by IDs

Retrieve hotels review by IDs

#content-api

https://api.worldota.net/api/content/v1/hotel_reviews_by_ids/

In this call can get reviews on the requested hotel IDs.

ℹ️

Request example

ℹ️
Only one of HIDs or IDs can be specified in the request. 
curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/content/v1/hotel_reviews_by_ids/' \
--header 'Content-Type: application/json' \
--data '{
    "hids": [6291688,
            6296387,
            6296716,
            6303545,
            6303742,
            6304320,
            6304603,
            6304886,
            6304887,
            6314064,
            6314532,
            6315546,
            6317902,
            6333750,
            6334068,
            6344525,
            6352359,
            6353673,
            6374316],
    "language": "en"
}'
curl --user '<KEY_ID>:<API_KEY>' 'https://api.worldota.net/api/content/v1/hotel_content_by_ids/' \
--header 'Content-Type: application/json' \
--data '{
  "ids": [
      "hotel_1",
      "hotel_2",
      "hotel_3",
      "hotel_4",
      "hotel_5"
    ]
  "language": "en"
}'

Request body

hids [Int]

A list of hotel IDs filtered by the criteria specified in the request.

ℹ️
ids [String]
A list of unique hotel ID.
language String required

The language.

ℹ️

Response

id String
The unique hotel ID.
hid Int

The most preferred hotel ID.

ℹ️
  • Either this field or the id field is required.
  • The maximum length is 10 characters.
review [Object]

A list of user reviews about the hotel.

id int
Unique review identifier.
review_plus String
Positive comment, highlighting what the guest liked during their stay.
review_minus String
Negative comment, describing what the guest disliked during their stay.
created String
Date and time when the review was submitted.
author String
Name of the guest who left the review.
adults Int
Number of adults staying in the room for the reviewed booking.
children Int
Number of children staying in the room for the reviewed booking.
room_name String
The name and description of the room that was booked.
nights Int
Number of nights the guest stayed.
images [String]

The list of the URLs for the hotel images.

Each URL has the {size} placeholder. Meaning, the size of the image you can get.

ℹ️
  • The possible size meanings:
    • crop — the image is fit by the width and is cut equally from the bottom and top till the middle part of the height.
    • fit-h — the image is fit into the rectangle by the height.
    • fit — the image is fit into the rectangle by the size in question.
  • The possible values:
    • 100x100 — crop.
    • 1024x768 — fit.
    • 120x120 — crop.
    • 240x240 — crop.
    • x220 — fit-h.
    • x500 — fit-h.
detailed_review [Object]

Detailed ratings for different aspects of the stay (see subfields below).

cleanness Int

Guest rating of the cleanliness.

ℹ️
  • The minimum value is 0.
  • The maximum value is 10.
location Int

Guest rating of the location.

ℹ️
  • The minimum value is 0.
  • The maximum value is 10.
price Int

Value for money rating.

ℹ️
  • The minimum value is 0.
  • The maximum value is 10.
services Int

Rating of the provided services.

ℹ️
  • The minimum value is 0.
  • The maximum value is 10.
room Int

Rating of the room itself.

ℹ️
  • The minimum value is 0.
  • The maximum value is 10.
meal Int

Rating of the meals.

ℹ️
  • The minimum value is 0.
  • The maximum value is 10.
wifi String
Guest’s feedback on the Wi-Fi; may be unspecified if not reviewed.
hygiene String
Guest’s feedback on hygiene; may be unspecified if not reviewed.
traveller_type String
Type of traveller (e.g., solo, couple, family, or unspecified if not provided).
trip_type String
Type of trip, such as leisure or business.
rating Int

The hotel rating on a scale from 1 to 5. Has the 0 value for no available rating.

ℹ️
  • The minimum value is 0.
  • The maximum value is 5.

Response example 

{
  "data": [
    {
      "id": "hotel_1",
      "hid": 6302348,
      "reviews": [
        {
          "id": 280527,
          "review_plus": "Plenty of space . good room size .",
          "review_minus": "Parking is hard .",
          "created": "2019-03-06 00:17:57.609789+00",
          "author": "Gary",
          "adults": 2,
          "children": 0,
          "room_name": "Double Apartment (Double bed) (2 bedrooms)",
          "nights": 1,
          "images": null,
          "detailed_review": {
            "cleanness": 10,
            "location": 6,
            "price": 8,
            "services": 10,
            "room": 0,
            "meal": 0,
            "wifi": "unspecified",
            "hygiene": "unspecified"
          },
          "traveller_type": "unspecified",
          "trip_type": "leisure",
          "rating": 8.5
        }
      ]
    },
    {
      "id": "hotel_2",
      "hid": 6304782,
      "reviews": [
        {
          "id": 356735,
          "review_plus": "Um... It had a pub attached.",
          "review_minus": "The smell was rank. Absolutely horrendous stink! I wasted my money as I left at 2am because the smell was so disgusting I couldn’t sleep.",
          "created": "2020-07-06 07:49:30.029243+00",
          "author": "Kieran",
          "adults": 1,
          "children": 0,
          "room_name": "Standard Double Suite (double bed) (queen size double bed)",
          "nights": 1,
          "images": null,
          "detailed_review": {
            "cleanness": 2,
            "location": 8,
            "price": 4,
            "services": 6,
            "room": 0,
            "meal": 0,
            "wifi": "unspecified",
            "hygiene": "unspecified"
          },
          "traveller_type": "unspecified",
          "trip_type": "leisure",
          "rating": 5
        }
      ]
    }
  }
    "debug": {
      "request": {
        "id": [
          "hotel_1",
          "hotel_2"
        ],
        "hids": [
          6302348,
          6304782
        ],
        "language": "en"
      },
      "key_id": 1234,
      "validation_error": null
    },
    "status": "ok",
    "error": null
    }

Errors

The error field has the value specified in the headers below.

invalid_params

One or more input parameters are incorrect. For more details, see the response field debug validation_error.

no_hotel_reviews

An internal search error. Has 500 status code.