ETG API V3
[Beta] Sandbox
Hotel search
Sort hotels

Sort hotels

🆕
The Sandbox environment is available exclusively to new partners who begin their integration in Q4 2025. 
https://api-sandbox.worldota.net/api/b2b/v3/search/hotelsort/

The call ranks the hotels in the region. The ranking is made the internal ETG algorithm.

đź’ˇ

Recommendations

Use the call when you want to determine the order of the bookings to display in a third-party product.

Sandbox limitations

⚠️
Use all field values and API keys obtained from the sandbox environment only within the sandbox. Don’t mix them with test or production environments.

Request

  • region_id. The possible field values:
    • 2011.
    • 2395.
    • 2734.
    • 6053839.
  • hotels_limit. The maximum value is 250.

Response

  • hotels. The maximum items’ number is 250.

Request example 

curl --user '<KEY_ID>:<API_KEY>' 'https://api-sandbox.worldota.net/api/b2b/v3/search/hotelsort/' \
--header 'Content-Type: application/json' \
--data '{
  "region_id": 2011,
  "sort_type": "b2b",
  "hotels_limit": 5
}'

Request body

Response

Response example 

{
  "data": {
    "hotels": [
      "1047_hollywood_midcentury_pool_view",
      "brand_new_downtown_la_luxury_penthouse",
      "hollywood_promenade_apartment",
      "villa_sunset_hilltop",
      "1011_beverly_hills_modern_summit"
    ]
  },
  "debug": {
    "request": {
      "region_id": 2011,
      "sort_type": "b2b",
      "hotels_limit": 5
    },
    "key_id": 6,
    "validation_error": null
  },
  "status": "ok",
  "error": null
}

Errors

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

invalid_params

  • The region_id field is required.
  • The region_id field is equal or greater than 0.
  • The hotels_limit field is equal or greater than 0.
  • The sort_type field is incorrect.

hotels_not_found

An internal search error. Has 500 status code.