ETG API V3
Affiliate API
Hotel search
Autocomplete

Autocomplete

https://api.worldota.net/api/b2b/v3/search/multicomplete

Autocomplete allows you to find a region or a hotel by just part of its name.

Returns no more than 5 objects for 1 category.

Request example 

curl --location 'https://api.worldota.net/api/b2b/v3/search/multicomplete/' \
--header 'Content-Type: application/json' \
--data '{
    "query": "Ber",
    "language": "en"
}'

Request body

language String optional

The language.

ℹ️

The possible values:

  • ar—Arabic.
  • bg–Bulgarian.
  • cs–Czech.
  • de–German.
  • el–Greek.
  • en–English.
  • es–Spanish.
  • fr–French.
  • he–Hebrew.
  • hu–Hungarian.
  • it–Italian.
  • ja–Japanese.
  • kk–Kazakh.
  • ko–Korean.
  • nl–Dutch.
  • pl–Polish.
  • pt–Portuguese.
  • pt_PT–Portuguese (Portugal).
  • ro–Romanian.
  • ru–Russian.
  • sq–Albanian.
  • sr–Serbian.
  • th–Thai.
  • tr–Turkish.
  • uk–Ukrainian.
  • vi–Vietnamese.
  • zh_CN–Simplified Chinese.
query String required
Part of the hotel’s or region’s name.

Response

hotels Object

The list of hotels and their rates.

id String

The unique hotel ID.

ℹ️
  • Either this field or the hid field is required.
hid Int

The most preferred hotel ID.

ℹ️
  • Either this field or the id field is required.
  • The maximum length is 7 characters.
name String
Hotel’s name.
region_id Int
Unique Emerging Travel Group identifier of the region where the hotel is located.
regions Object

Regions that are meet the request parameters and are available for search.

ℹ️
  • The maximum items number is 5.
country_code String
The region country code in the ISO 3166-1 alpha-2 format.
id Int
Region’s unique ID at Emerging Travel Group.
name String
Region’s name.
type String

Type of the region.

ℹ️
  • The possible values:
    • Airport.
    • Bus Station.
    • City.
    • Continent.
    • Country.
    • Multi-City.
    • Multi-Railway Station.
    • Multi-Region.
    • Neighborhood.
    • Point of Interest.
    • Province.
    • Railway Station.
    • Street.
    • Subway.

Response example 

{
  "data": {
    "hotels": [
      {
        "id": "cityhostel_berlin",
        "name": "Cityhostel Berlin",
        "region_id": 536
      },
      {
        "id": "park_inn_by_radisson_berlin_alexanderplatz_2",
        "name": "Park Inn by Radisson Berlin Alexanderplatz",
        "region_id": 536
      },
      {
        "id": "lazurniy_bereg_2",
        "name": "Lazurnyij Bereg Hotel",
        "region_id": 258
      },
      {
        "id": "hotel_kyriad_paris_bercy_village",
        "name": "Hotel Kyriad Paris Bercy Village",
        "region_id": 2734
      },
      {
        "id": "belmondo_am_kurfurstendamm",
        "name": "AZIMUT Hotel Kurfuerstendamm Berlin",
        "region_id": 536
      }
    ],
    "regions": [
      {
        "id": 536,
        "name": "Berlin",
        "type": "City",
        "country_code": "DE"
      },
      {
        "id": 560,
        "name": "Bergamo",
        "type": "City",
        "country_code": "IT"
      },
      {
        "id": 6052439,
        "name": "Interlaken",
        "type": "City",
        "country_code": "CH"
      },
      {
        "id": 4284,
        "name": "Grindelwald",
        "type": "City",
        "country_code": "CH"
      },
      {
        "id": 684,
        "name": "Bern",
        "type": "City",
        "country_code": "CH"
      }
    ]
  },
  "debug": {
    "request": {
      "query": "Ber",
      "language": "en"
    },
    "key_id": 1234
  },
  "status": "ok",
  "error": null
}
HotelsortHotelpage