ETG API V3
B2B 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": "bergs_hotel_2",
        "hid": 9974510,
        "name": "Bergs Spa and Сonference Hotel",
        "region_id": 5580
      },
      {
        "id": "gostinitsa_berlin",
        "hid": 8066022,
        "name": "Berlin Hotel",
        "region_id": 1798
      },
      {
        "id": "rp_bergamo_hotel",
        "hid": 10575679,
        "name": "Bergamo Eco Hotel",
        "region_id": 6057804
      },
      {
        "id": "hotel_bereg_svyatoy_sofii",
        "hid": 11329575,
        "name": "Hotel  Bereg Svyatoy Sofii",
        "region_id": 965821599
      },
      {
        "id": "guest_house_na_berezovoy_",
        "hid": 6509094,
        "name": "Na Berezovoi Bashnya Guest House",
        "region_id": 965858884
      }
    ],
    "regions": [
      {
        "id": 536,
        "name": "Berlin",
        "type": "City",
        "country_code": "DE"
      },
      {
        "id": 965888340,
        "name": "Saint-Philbert-de-Grand-Lieu",
        "type": "City",
        "country_code": "FR"
      },
      {
        "id": 6055144,
        "name": "Berrias-et-Casteljau",
        "type": "City",
        "country_code": "FR"
      },
      {
        "id": 6340759,
        "name": "Montalbert",
        "type": "City",
        "country_code": "FR"
      },
      {
        "id": 966047519,
        "name": "Saint-Philbert-sur-Orne, Normandy",
        "type": "City",
        "country_code": "FR"
      }
    ]
  },
  "debug": {
    "request": {
      "query": "Ber",
      "language": "en"
    },
    "key_id": 7705,
    "validation_error": null
  },
  "status": "ok",
  "error": null
}
HotelsortHotelpage