Hotel and room data from HotellerieSuisse is available via the discover.swiss infocenter. This page is intended to help you access the data from HotellerieSuisse.
Access¶
The data can be accessed free of charge via the Infocenter API. However, free access to the Infocenter is limited in functionality. The following restrictions apply:
- The extensive search functions are not available
- Weather data cannot be accessed
- The media service, which can, for example, automatically crop images, provide images via a CDN, and automatically add the image credit to the image, is not available
- The number of requests is limited (60 requests per minute and 50,000 requests per month)
This data is also available via the fee-based Infocenter. On the page How to get access describes how to create a subscription key. For free access, the product 'Infocenter Open' must be used.
The subscription key must be included in all API requests in the Ocp-Apim-Subscription-Key header. In addition to the subscription key, the dsod-hs project must be included as a query parameter to obtain only HotellerieSuisse-specific data.
Retrieve hotels¶
All hotels can be accessed via the list endpoint:
GET /info/v2/lodgingbusinesses/?project=dsod-content HTTP/1.1
Host: api.discover.swiss
Ocp-Apim-Subscription-Key: 1234
Accept-Language: de
Example answer hotels
{
"hasNextPage": true,
"nextPageToken": "[{\"token\":\"+RID:~TJwCAIyDkDgshAAAAAAAAA==#RT:1#TRC:10#ISV:2#IEO:65567#QCF:8#FPC:AgECBwIMACQEALAJLGd3AQB/hgQCAIO9BQIAx5AHJgDhhlKEkRIU+BNAXwMIAIAfa4AGwAAoAAJAgVRUFaBCADSHPokBgA==\",\"range\":{\"min\":\"\",\"max\":\"FF\"}}]",
"data": [
{
"amenityFeature": [
{
"propertyId": "general-lounge",
"typeName": "Allgemein",
"additionalType": "general",
"name": "Gesellschaftsraum"
},
{
"propertyId": "outdoor-terracebalcony",
"typeName": "Aussenanlagen",
"additionalType": "outdoor",
"name": "Terrasse/Balkon"
},
{
"propertyId": "food-bar",
"typeName": "Essen",
"additionalType": "food",
"name": "Stab"
},
{
"propertyId": "sport-gym",
"typeName": "Sport und Freizeit",
"additionalType": "sport",
"name": "Fitnessstudio"
},
{
"propertyId": "outdoor-garden",
"typeName": "Aussenanlagen",
"additionalType": "outdoor",
"name": "Garten"
},
{
"propertyId": "general-elevator",
"typeName": "Allgemein",
"additionalType": "general",
"name": "Aufzug"
},
{
"propertyId": "food-restaurant",
"typeName": "Essen",
"additionalType": "food",
"name": "Restaurant"
},
{
"propertyId": "wellness-sauna",
"typeName": "Wellness-Dienstleistungen",
"additionalType": "wellness",
"name": "Sauna"
},
{
"propertyId": "entertainment-playroom",
"typeName": "Unterhaltung und Lifestyle",
"additionalType": "entertainment",
"name": "Spielzimmer"
},
{
"propertyId": "wellness-whirlpoolorjacuzzi",
"typeName": "Wellness-Dienstleistungen",
"additionalType": "wellness",
"name": "Whirlpool oder Jacuzzi"
},
{
"propertyId": "general-wifi",
"typeName": "Allgemein",
"additionalType": "general",
"name": "WLAN"
},
{
"propertyId": "wellness-steambath",
"typeName": "Wellness-Dienstleistungen",
"additionalType": "wellness",
"name": "Dampfbad"
},
{
"propertyId": "sport-golfcourse",
"typeName": "Sport und Freizeit",
"additionalType": "sport",
"name": "Golfplatz"
},
{
"propertyId": "sport-indoorswimmingpool",
"typeName": "Sport und Freizeit",
"additionalType": "sport",
"name": "Hallenbad"
},
{
"propertyId": "sport-minigolf",
"typeName": "Sport und Freizeit",
"additionalType": "sport",
"name": "Minigolf"
},
{
"propertyId": "tom-sportAndFreetime-tbx00020010001909371",
"typeName": "Sport und freizeit",
"additionalType": "tom-sportAndFreetime",
"name": "Wellness/Spa"
},
{
"propertyId": "tom-services-tbx00020010001908819",
"typeName": "Dienstleistungen",
"additionalType": "tom-services",
"name": "Haustiere auf Anfrage"
},
{
"propertyId": "tom-theme-tbx00020010001909609",
"typeName": "Thema",
"additionalType": "tom-theme",
"name": "Aktiv und Sport"
},
{
"propertyId": "tom-theme-tbx00020010001909611",
"typeName": "Thema",
"additionalType": "tom-theme",
"name": "Familien"
},
{
"propertyId": "tom-theme-tbx00020010001909616",
"typeName": "Thema",
"additionalType": "tom-theme",
"name": "Romantik"
},
{
"propertyId": "tom-theme-tbx00020010001909607",
"typeName": "Thema",
"additionalType": "tom-theme",
"name": "Wellness"
}
],
"starRating": {
"name": "4 Stern Superior"
},
"accommodation": [
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdajffb",
"identifier": "acc_942_9t8aaacaabdgjgdajffb"
},
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdafega",
"identifier": "acc_942_9t8aaacaabdgjgdafega"
},
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdbbcgf",
"identifier": "acc_942_9t8aaacaabdgjgdbbcgf"
}
],
"award": [
{
"award": {
"name": {
"de": "HotellerieSuisse Spezialisierung Medical Wellness & Spa",
"it": "HotellerieSuisse Spécialisation Medical Wellness & Spa",
"fr": "HotellerieSuisse Specializzazione Medical Wellness & Spa",
"en": "HotellerieSuisse Specialization Medical Wellness & Spa"
},
"logo": {
"contentUrl": "https://hotelclass-uploads.s3-eu-west-1.amazonaws.com/Specialization62c82f0268c77Medical_Wellness_Spa_Hotel_eine_Hand_eine_Welle.jpg",
"dataGovernance": {
"provider": {
"acronym": "hcl",
"name": "Hotelclass",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_14w4",
"identifier": "img_xs1_14w4"
},
"identifier": "hcl"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_cb_14w4",
"identifier": "img_xs1_cb_14w4"
},
"@id": "https://api.discover.swiss/test/info/v2/awards/hs_21_medicalwellnessspa",
"identifier": "hs_21_medicalwellnessspa"
}
},
{
"award": {
"name": {
"de": "HotellerieSuisse Spezialisierung Seminars",
"it": "HotellerieSuisse Spécialisation Seminars",
"fr": "HotellerieSuisse Specializzazione Seminars",
"en": "HotellerieSuisse Specialization Seminars"
},
"logo": {
"contentUrl": "https://hotelclass-uploads.s3-eu-west-1.amazonaws.com/Specialization62c82e26dbc53Seminar-Hotel.jpg",
"dataGovernance": {
"provider": {
"acronym": "hcl",
"name": "Hotelclass",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_14w4",
"identifier": "img_xs1_14w4"
},
"identifier": "hcl"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_be_14w4",
"identifier": "img_xs1_be_14w4"
},
"@id": "https://api.discover.swiss/test/info/v2/awards/hs_14_seminars",
"identifier": "hs_14_seminars"
}
},
{
"award": {
"name": {
"en": "Swisstainable Level II - engaged",
"de": "Swisstainable Level II - engaged",
"fr": "Swisstainable Niveau II - engaged",
"it": "Swisstainable Livello II - engaged"
},
"logo": {
"contentUrl": "https://cdn.discover.swiss/img/stb-level-2.png",
"dataGovernance": {
"provider": {
"acronym": "stb",
"name": "Swisstainable",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/stb.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89r_14w4",
"identifier": "img_89r_14w4"
},
"link": [
{
"url": "https://www.stv-fst.ch/",
"type": "WebHomepage"
}
],
"identifier": "stb"
},
"source": {
"acronym": "stb",
"name": "Swisstainable",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/stb.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89r_14w4",
"identifier": "img_89r_14w4"
},
"link": [
{
"url": "https://www.stv-fst.ch/",
"type": "WebHomepage"
}
],
"identifier": "stb"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89r_1ulu1-c-14w4",
"identifier": "img_89r_1ulu1-c-14w4"
},
"@id": "https://api.discover.swiss/test/info/v2/awards/stb_level-2",
"identifier": "stb_level-2"
}
}
],
"address": {
"addressCountry": "CH",
"addressLocality": "Bad Zurzach",
"addressRegion": "Aargau",
"postalCode": "5330",
"streetAddress": "Badstrasse 44",
"email": "info@parkhotel-bad-zurzach.ch",
"telephone": "+41 56 269 88 11"
},
"geo": {
"latitude": 47.5916,
"longitude": 8.28914
},
"photo": [
{
"contentUrl": "http://cdn.tomas-travel.com/tds/repository/TDS00020013694873623/TDS00020010010367324/TDS00020013694881441.jpg",
"caption": "Parkhotel",
"encodingFormat": "image/jpeg",
"dataGovernance": {
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_9t8aaacaabdgjeiibeeb",
"identifier": "img_942_9t8aaacaabdgjeiibeeb"
}
],
"telephone": "+41 56 269 88 11",
"detailedInformation": ["Hotel"],
"category": [
{
"@id": "https://api.discover.swiss/test/info/v2/categories/ch_root",
"identifier": "ch_root"
},
{
"@id": "https://api.discover.swiss/test/info/v2/categories/ch_0708",
"identifier": "ch_0708"
},
{
"@id": "https://api.discover.swiss/test/info/v2/categories/ch_07",
"identifier": "ch_07"
}
],
"containedInPlace": [
{
"@id": "https://api.discover.swiss/test/info/v2/areas/osm_13623634",
"identifier": "osm_13623634"
},
{
"@id": "https://api.discover.swiss/test/info/v2/areas/osm_51701",
"identifier": "osm_51701"
},
{
"@id": "https://api.discover.swiss/test/info/v2/areas/osm_1685443",
"identifier": "osm_1685443"
},
{
"@id": "https://api.discover.swiss/test/info/v2/areas/osm_1686359",
"identifier": "osm_1686359"
},
{
"@id": "https://api.discover.swiss/test/info/v2/areas/plz_5330_0",
"identifier": "plz_5330_0"
}
],
"tag": [
{
"@id": "https://api.discover.swiss/test/info/v2/tags/tourismzone-countryside",
"identifier": "tourismzone-countryside"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/tourismregion-aarauregion",
"identifier": "tourismregion-aarauregion"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/okgo-externally-verified",
"identifier": "okgo-externally-verified"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/profile-season-summer",
"identifier": "profile-season-summer"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/profile-season-winter",
"identifier": "profile-season-winter"
}
],
"campaignTag": [
{
"@id": "https://api.discover.swiss/test/info/v2/tags/okgo-externally-verified",
"identifier": "okgo-externally-verified"
}
],
"profileTag": [
{
"@id": "https://api.discover.swiss/test/info/v2/tags/profile-season-summer",
"identifier": "profile-season-summer"
},
{
"@id": "https://api.discover.swiss/test/info/v2/tags/profile-season-winter",
"identifier": "profile-season-winter"
}
],
"@id": "https://api.discover.swiss/test/info/v2/lodgingbusinesses/log_942_9t8aaacaabdgjeihdgcd",
"identifier": "log_942_9t8aaacaabdgjeihdgcd",
"removed": false,
"dataGovernance": {
"origin": [
{
"datasource": "hs-d365",
"sourceId": "10189",
"created": "2021-12-07T20:46:47+00:00",
"lastModified": "2023-01-13T20:28:15+00:00",
"license": "CC BY-SA",
"provider": {
"acronym": "hs-d365"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
},
{
"datasource": "tom",
"sourceId": "TDS00020013694873623",
"lastModified": "2022-06-15T22:00:00+00:00",
"license": "CC BY-ND",
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
{
"datasource": "hs",
"sourceId": "10189",
"license": "CC BY-SA",
"provider": {
"acronym": "hs"
},
"source": {
"acronym": "hs"
}
},
{
"datasource": "st",
"sourceId": "567",
"created": "2010-05-15T06:31:37.093+00:00",
"lastModified": "2023-01-24T15:53:27.49+00:00",
"license": "CC BY-NC-SA 4.0",
"provider": {
"acronym": "st",
"name": "Schweiz Tourismus",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89_14w4",
"identifier": "img_89_14w4"
},
"link": [
{
"url": "https://www.myswitzerland.com/",
"type": "WebHomepage"
}
],
"identifier": "st"
},
"source": {
"acronym": "st",
"name": "Schweiz Tourismus",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_89_14w4",
"identifier": "img_89_14w4"
},
"link": [
{
"url": "https://www.myswitzerland.com/",
"type": "WebHomepage"
}
],
"identifier": "st"
}
},
{
"datasource": "gin",
"sourceId": "bc9ad59a-7c5a-4413-b634-02f253c14461",
"created": "2021-11-01T20:45:58.507+00:00",
"lastModified": "2022-04-12T17:24:21.916+00:00",
"license": "ODbL v1.0",
"provider": {
"acronym": "gin",
"name": "Ginto",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/gin.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_wy3_14w4",
"identifier": "img_wy3_14w4"
},
"link": [
{
"url": "https://www.ginto.guide/",
"type": "WebHomepage"
}
],
"identifier": "gin"
},
"source": {
"acronym": "pi",
"name": "Pro Infirmis",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/pi.jpg",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_5y_14w4",
"identifier": "img_5y_14w4"
},
"link": [
{
"url": "https://www.proinfirmis.ch/",
"type": "WebHomepage"
}
],
"identifier": "pi"
}
},
{
"datasource": "hcl",
"sourceId": "32610",
"created": "2017-12-22T10:00:35+00:00",
"lastModified": "2023-08-19T11:08:49+00:00",
"license": "CC BY-SA",
"provider": {
"acronym": "hcl",
"name": "Hotelclass",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_xs1_14w4",
"identifier": "img_xs1_14w4"
},
"identifier": "hcl"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
}
],
"provider": {
"acronym": "hs-d365"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
}
},
"additionalProperty": [
{
"value": "17800",
"propertyId": "hsId",
"valueType": "string",
"name": "HotellerieSuisse Identifizierung"
},
{
"value": "ChIJnenVwedokEcRDDsUy6W4nds",
"valueStr": "ChIJnenVwedokEcRDDsUy6W4nds",
"propertyId": "google_place_id",
"valueType": "string"
}
],
"lastModified": "2024-01-10T17:43:52.9816453+00:00",
"availableDataLanguage": ["de", "en", "fr", "it"],
"autoTranslatedData": false,
"license": "CC BY-SA",
"disambiguatingDescription": "«Erleben, Geniessen und Erholen» – das sind die drei Erfahrungswelten, die Sie bei uns im Parkhotel auf verschiedene Weise entdecken können. Erleben: Wandern, Fahrradfahren, Museum-Besuche oder einfach Spazieren - Ihr Erlebnis-Highlight in Bad Zurzach startet genau hier. Geniessen: Saisonale und gesunde Speisen, zubereitet mit regionalen Zutaten, erwarten Sie in unserem Restaurant. Erholen: Das Parkhotel gehört zu den grössten Bäder- und Gesundheitshotels schweizweit. Als Gast können Sie das hoteleigene Solebad nutzen, haben aber ebenso freien Zutritt zu einem der grössten Thermalbäder der Schweiz – direkt über einen Verbindungstrakt. Wir setzen alles daran, Ihren Aufenthalt maximal erholsam zu gestalten und Ihr Wohlbefinden zu beflügeln. Wir freuen uns schon Sie bei uns begrüssen und verwöhnen zu dürfen.",
"image": {
"contentUrl": "http://cdn.tomas-travel.com/tds/repository/TDS00020013694873623/TDS00020010010367324/TDS00020013694881441.jpg",
"caption": "Parkhotel",
"encodingFormat": "image/jpeg",
"dataGovernance": {
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_9t8aaacaabdgjeiibeeb",
"identifier": "img_942_9t8aaacaabdgjeiibeeb"
},
"additionalType": "Hotel",
"link": [
{
"url": "https://www.parkhotel-bad-zurzach.ch",
"type": "WebHomepage"
},
{
"url": "http://www.parkhotel-bad-zurzach.ch",
"type": "WebHomepage"
},
{
"url": "https://www.ginto.guide/entries/bc9ad59a-7c5a-4413-b634-02f253c14461?lnk_src=business",
"title": "Zugänglichkeitsinformationen anzeigen",
"type": "GintoWeb"
},
{
"url": "https://api.ginto.guide/entries/bc9ad59a-7c5a-4413-b634-02f253c14461",
"type": "GintoResource"
}
],
"name": "Parkhotel Bad Zurzach",
"type": "schema.org/LodgingBusiness"
}
]
}
Notes on the data structure:
- The
amenityFeaturelist contains the amenities standardized by HotellerieSuisse. Amenity features that are not included in the standard but are provided by a system begin with a 3-character abbreviation, such as tom- frt-. - The main image is contained in the
imagefield. - The
photofield contains all images sorted by priority. The main image corresponds to the first image provided in the list. - The
awardlist contains the official HotellerieSuisse classifications and labels, such as Swisstainable. - Details on the data schema and API endpoints can be found in the OpenAPI definition in Developer Portal.
- The HotellerieSuisse ID is present in the
additionalPropertylist with the property IDhsId. - Click here for an overview of LodgingBusiness properties.
Query changes¶
Using the query parameter updatedSince, you can retrieve all hotels that have changed since a certain date via the list endpoint.
Example call:
GET /info/v2/lodgingbusinesses?project=dsod-content&includeCount=true&updatedSince=2024-07-20T07:00:00 HTTP/1.1
Host: api.discover.swiss
Ocp-Apim-Subscription-Key: 1234
Accept-Language: de
{
"count": 1,
"hasNextPage": false,
"data": [
{
"identifier": "log_x8-tdgf_bbhcb",
"name": "Steigenberger Icon Grandhotel Belvédère",
"type": "schema.org/LodgingBusiness"
}
]
}
If the query parameter deleted=true is specified in addition to the parameter updatedSince, all hotels that have been deleted since this date are returned.
Language¶
The content is returned in the language specified in the Accept-Language. The default is German.
Continuation Token¶
At the end of the list, a continuation token is returned, which can be used to access the subsequent pages. How to use the token is explained on the following page:
How to get access to the API #continuationtoken
Pictures¶
The license and copyright information in both data and images must be adhered to. The necessary image credit information can be compiled using the information in the DataGovernance object.
Bibliography
Images can be tagged with various topics. These can be queried using tagToQuery.
Example
{
"tagToQuery": [
"image-amenity-bed",
"image-amenity-sitting-area",
"image-amenity-desk"
],
"contentUrl": "https://media-v2.discover.swiss/rawmedia/hs/00092590_5c2af1fd6833a05c56bc522de431460f_m.jpg",
"copyrightNotice": "Tschuggen Grand Hotel, HotellerieSuisse",
"dataGovernance": {
"provider": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"copyrightNotice": "discover.swiss",
"@id": "https://api.discover.swiss/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
},
"source": {
"acronym": "hs",
"name": "HotellerieSuisse",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/hs.png",
"copyrightNotice": "discover.swiss",
"@id": "https://api.discover.swiss/info/v2/imageObjects/img_x8_14w4",
"identifier": "img_x8_14w4"
},
"link": [
{
"url": "https://www.hotelleriesuisse.ch/de/",
"type": "WebHomepage"
}
],
"identifier": "hs"
},
"author": {
"familyName": "Tschuggen Grand Hotel"
}
},
"@id": "https://api.discover.swiss/info/v2/imageObjects/img_x8_y2w_jcfja",
"identifier": "img_x8_y2w_jcfja"
}
Accessibility information¶
Ginto provides a ready-made HTML page that can be referenced. This page is available via the link with the type GintoWeb.
Example:
{
"link": [
{
"url": "https://www.ginto.guide/entries/bc9ad59a-7c5a-4413-b634-02f253c14461?lnk_src=business",
"title": "Zugänglichkeitsinformationen anzeigen",
"type": "GintoWeb"
}
]
}
View room categories¶
A list of all rooms can be retrieved via /info/v2/accommodations. Hotels contain an array with all room categories. Click here for an overview of the accommodation properties.
{
"accommodation": [
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdajffb",
"identifier": "acc_942_9t8aaacaabdgjgdajffb"
},
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdafega",
"identifier": "acc_942_9t8aaacaabdgjgdafega"
},
{
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdbbcgf",
"identifier": "acc_942_9t8aaacaabdgjgdbbcgf"
}
]
}
The @id contains the full URL, and the identifier contains the property's ID. This information can then be used to retrieve the room via the Accommodation endpoint.
GET /info/v2/accommodations/acc_942_9t8aaacaabdgjgdajffb?project=dsod-content HTTP/1.1
Host: api.discover.swiss
Ocp-Apim-Subscription-Key: 1234
Accept-Language: de
Example answer room category
{
"numberOfRooms": [
{
"valueDescription": "Doppelzimmer"
}
],
"occupancy": [
{
"validFrom": "2022-05-18T22:00:00+00:00",
"validThrough": "2028-12-10T23:00:00+00:00",
"maxValue": 3.0,
"minValue": 1.0,
"valueDescription": "Person"
},
{
"validFrom": "2022-05-18T22:00:00+00:00",
"validThrough": "2028-12-10T23:00:00+00:00",
"maxValue": 3.0,
"minValue": 1.0,
"valueDescription": "Erwachsener"
},
{
"validFrom": "2022-05-18T22:00:00+00:00",
"validThrough": "2028-12-10T23:00:00+00:00",
"maxValue": 2.0,
"minValue": 0.0,
"valueDescription": "Kind"
}
],
"leaseLength": [
{
"validFrom": "2023-04-08T22:00:00+00:00",
"validThrough": "2023-12-21T23:00:00+00:00",
"minValue": 1.0,
"unitCode": "day"
},
{
"validFrom": "2023-12-21T23:00:00+00:00",
"validThrough": "2023-12-31T23:00:00+00:00",
"minValue": 2.0,
"unitCode": "day"
},
{
"validFrom": "2023-12-31T23:00:00+00:00",
"validThrough": "2025-01-18T23:00:00+00:00",
"minValue": 1.0,
"unitCode": "day"
}
],
"address": {
"addressCountry": "CH",
"addressLocality": "Bad Zurzach",
"postalCode": "5330",
"streetAddress": "Badstrasse 44 ",
"availableLanguage": ["de"],
"email": "info@parkhotel-bad-zurzach.ch",
"telephone": "+41 56 269 88 11"
},
"geo": {
"latitude": 47.5915333,
"longitude": 8.2888411
},
"photo": [
{
"contentUrl": "http://cdn.tomas-travel.com/tds/repository/TDS00020013696309551/TDS00020010010367324/TDS00020013696323308.jpg",
"caption": "Parkhotel Bad Zurzach",
"encodingFormat": "image/jpeg",
"dataGovernance": {
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"thumbnailUrl": "https://media-test-v2.discover.swiss/image/img_942_9t8aaacaabdgjgdcddai",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_9t8aaacaabdgjgdcddai",
"identifier": "img_942_9t8aaacaabdgjgdcddai"
}
],
"@id": "https://api.discover.swiss/test/info/v2//acc_942_9t8aaacaabdgjgdajffb",
"identifier": "acc_942_9t8aaacaabdgjgdajffb",
"removed": false,
"dataGovernance": {
"origin": [
{
"datasource": "tom",
"sourceId": "TDS00020013696309551",
"lastModified": "2023-05-09T22:00:00+00:00",
"license": "CC BY-ND",
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
}
],
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"lastModified": "2023-12-10T03:14:36.9306816+00:00",
"availableDataLanguage": ["de", "en", "es", "fr", "it"],
"autoTranslatedData": false,
"license": "CC BY-ND",
"disambiguatingDescription": "<p>Das komfortable und moderne Superior Zimmer ist mit einem TV, einer HiFI-Anlage, einer Nespresso-Minibar sowie einem Badezimmer mit Dusche ausgestattet. Das Zimmer verfügt auch über einen Balkon.<br>Die exklusive Badetasche mit Bademantel, Saunatuch und Badeslipper steht im Zimmer schon für Sie bereit.<br>Alle Hotelzimmer sind Nichtraucherzimmer.</p>",
"image": {
"contentUrl": "http://cdn.tomas-travel.com/tds/repository/TDS00020013696309551/TDS00020010010367324/TDS00020013696323308.jpg",
"caption": "Parkhotel Bad Zurzach",
"encodingFormat": "image/jpeg",
"dataGovernance": {
"provider": {
"acronym": "tom",
"name": "TOMAS",
"logo": {
"contentUrl": "https://cdn.discover.swiss/logos/tom.png",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_14w4",
"identifier": "img_942_14w4"
},
"link": [
{
"url": "https://www.tomas.ch",
"type": "WebHomepage"
}
],
"identifier": "tom"
},
"source": {
"acronym": "rgrbr",
"name": "Rhein Genuss Route (admin), (Bad Ragaz)",
"logo": {
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_7w7r7_14w4",
"identifier": "img_7w7r7_14w4"
},
"link": [
{
"url": "https://www.rheinwelten.com/#",
"type": "WebHomepage"
}
],
"identifier": "rgrbr"
}
},
"thumbnailUrl": "https://media-test-v2.discover.swiss/image/img_942_9t8aaacaabdgjgdcddai",
"@id": "https://api.discover.swiss/test/info/v2/imageObjects/img_942_9t8aaacaabdgjgdcddai",
"identifier": "img_942_9t8aaacaabdgjgdcddai"
},
"additionalType": "HotelRoom",
"name": "Superior Doppelzimmer mit Balkon",
"type": "schema.org/Accommodation"
}
Number of Rooms¶
We strive to harmonize the number of rooms by category from various sources. We currently support the following categories: 1. single 2. double 3. triple 4. suite 5. total
A property ID has been specified to support categories. However, not all data can be structured. If no category can be defined, only the value and name are provided without a property ID.
Example answer numberOfRooms
{
"numberOfRooms": [
{
"propertyId": "single",
"unitCode": "count",
"value": "4",
"name": "Einzelzimmer"
},
{
"propertyId": "double",
"unitCode": "count",
"value": "362",
"name": "Doppelzimmer"
},
{
"propertyId": "suite",
"unitCode": "count",
"value": "11",
"name": "Suiten"
},
{
"propertyId": "total",
"unitCode": "count",
"value": "366",
"name": "Zimmer insgesamt"
}
]
}
Overview of properties¶
The following overview explains the individual properties of the Infocenter classes in more detail with regard to the AccommoDataHub usage.
LodgingBusiness¶
The following table describes the main features of the LodgingBusiness:
| Property ID | Value | Description |
|---|---|---|
| AdditionalProperty.hsId | Individual HotellerieSuisse ID | Official unique ID from HotellerieSuisse. |
| starRating | See separate table | Official hotel classification |
| Tag | See separate table | Contains a list of tags such as tourist zone or family-friendly, etc. |
| ParentOrganization | See separate table | Hotel group |
| Award | See separate table | HotellerieSuisse specialization label |
| Amenity Features | See separate table | Accommodation Amenity Features |
Labels¶
Labels such as HotellerieSuisse Specializations, Ibex, Swisstainable, etc. are available in the 'Awards' feature. Possible awards include:
| Property ID | Value | Description |
|---|---|---|
| hs_19_wellnessspa | HotellerieSuisse Specialisation Wellness & Spa | Spezialisierungslabel Hotelclass |
| hs_22_aparthotel | HotellerieSuisse Specialization Aparthotel | Spezialisierungslabel Hotelclass |
| hs_1_biking | HotellerieSuisse Specialization Biking | Spezialisierungslabel Hotelclass |
| hs_28_boutique | HotellerieSuisse Specialization Boutique | Spezialisierungslabel Hotelclass |
| hs_6_business | HotellerieSuisse Specialization Business | Spezialisierungslabel Hotelclass |
| hs_13_congresses | HotellerieSuisse Specialization Congresses | Spezialisierungslabel Hotelclass |
| hs_4_design | HotellerieSuisse Specialization Design | Spezialisierungslabel Hotelclass |
| hs_15_excellentcuisine | HotellerieSuisse Specialization Excellent Cuisine | Spezialisierungslabel Hotelclass |
| hs_11_familymore | HotellerieSuisse Spezialisierung Family & More | Spezialisierungslabel Hotelclass |
| hs_10_familyfriendly | HotellerieSuisse Spezialisierung Family-friendly | Spezialisierungslabel Hotelclass |
| hs_27_gasthof | HotellerieSuisse Spezialisierung Gasthof | Spezialisierungslabel Hotelclass |
| hs_17_golf | HotellerieSuisse Spezialisierung Golf | Spezialisierungslabel Hotelclass |
| hs_8_greenliving | HotellerieSuisse Spezialisierung Green Living | Spezialisierungslabel Hotelclass |
| hs_16_hiking | HotellerieSuisse Spezialisierung Hiking | Spezialisierungslabel Hotelclass |
| hs_12_historic | HotellerieSuisse Spezialisierung Historic | Spezialisierungslabel Hotelclass |
| hs_26_internationalchainhotel | HotellerieSuisse Spezialisierung International Chain Hotel | Spezialisierungslabel Hotelclass |
| hs_29_kurhaus | HotellerieSuisse Spezialisierung Kurhaus | Spezialisierungslabel Hotelclass |
| hs_23_landgasthof | HotellerieSuisse Spezialisierung Landgasthof | Spezialisierungslabel Hotelclass |
| hs_20_medicalwellness | HotellerieSuisse Spezialisierung Medical Wellness | Spezialisierungslabel Hotelclass |
| hs_21_medicalwellnessspa | HotellerieSuisse Spezialisierung Medical Wellness & Spa | Spezialisierungslabel Hotelclass |
| hs_14_seminars | HotellerieSuisse Spezialisierung Seminars | Spezialisierungslabel Hotelclass |
| hs_5_snowsports | HotellerieSuisse Spezialisierung Snowsports | Spezialisierungslabel Hotelclass |
| hs_3_suitehotel | HotellerieSuisse Spezialisierung Suitehotel | Spezialisierungslabel Hotelclass |
| hs_9_sustainableliving | HotellerieSuisse Spezialisierung Sustainable Living | Spezialisierungslabel Hotelclass |
| hs_7_unique | HotellerieSuisse Spezialisierung Unique | Spezialisierungslabel Hotelclass |
| hs_18_wellness | HotellerieSuisse Spezialisierung Wellness | Spezialisierungslabel Hotelclass |
| hs_19_wellnessspa | HotellerieSuisse Spezialisierung Wellness & Spa | Spezialisierungslabel Hotelclass |
| stb_level-1 | Swisstainable Level I - committed | Nachhaltigkeitsprogramm STV-FST |
| stb_level-2 | Swisstainable Level II - engaged | Nachhaltigkeitsprogramm STV-FST |
| stb_level-3 | Swisstainable Level III - leading | Nachhaltigkeitsprogramm STV-FST |
| ibex_bronze | ibex fairstay bronze | Nachhaltigkeitslabel für Beherbergungsbetriebe |
| ibex_gold | ibex fairstay gold | Nachhaltigkeitslabel für Beherbergungsbetriebe |
| ibex_platinum | ibex fairstay platinum | Nachhaltigkeitslabel für Beherbergungsbetriebe |
| ibex_silver | ibex fairstay silver | Nachhaltigkeitslabel für Beherbergungsbetriebe |
Tourismuszone¶
The official tourism zones of the Federal Office (BFS) are indicated by a tag on the LodgingBusiness website. The following tourism zones are available:
| Id | Name |
|---|---|
| tourismzone-city | Grossstadt |
| tourismzone-town | Kleine Stadt |
| tourismzone-mountains | Berg |
| tourismzone-countryside | Land |
Tourismusregion¶
The official tourism regions of the Federal Office (BFS) are displayed as a tag on LodgingBusiness. The following tourism regions are available:
| Id | Name |
|---|---|
| tourismregion-aarauregion | Aarau Region |
| tourismregion-baselregion | Basel RegionRegion |
| tourismregion-bernregion | Bern Region |
| tourismregion-fribourgregion | Fribourg Region |
| tourismregion-genf | Genf |
| tourismregion-genferseegebiet | Genferseegebiet |
| tourismregion-graubunden | Graubünden |
| tourismregion-jura | Jura & Drei-Seen-Land |
| tourismregion-luzern | Luzern / Vierwaldstättersee |
| tourismregion-ostschweiz | Ostschweiz |
| tourismregion-tessin | Tessin |
| tourismregion-wallis | Wallis |
| tourismregion-zuerichregion | Zürich Region |
Hotel groups¶
Hotel groups are available in the property parentOrganization with the additional type HotelGroup. Possible hotel groups are:
| Id | Group name |
|---|---|
| loc_rmx | BWH Hotel Group |
| loc_xx49u18 | H-Hotels.com |
| loc_xy1943 | Hilton |
To query all hotel groups:
GET info/v2/localbusinesses?select=identifier,name&additionalType=HotelGroup
Host: api.discover.swiss
Ocp-Apim-Subscription-Key: 1234
Accept-Language: de
StarRating¶
The official hotel classification of HotellerieSuisse and GastroSuisse is available in the property starRating.
| ID | Name | Description |
|---|---|---|
| AdditionalType | - Hotel - ServicedApartments - swissLodge - Hostel |
Offizieller Subtyp |
| garni | true, false | Hotelclass Klassifikation |
| superior | true, false | Hotelclass Klassifikation |
| name | 1 Stern | Hotelclass Klassifikation |
| name | 2 Sterne | Hotelclass Klassifikation |
| name | 3 Sterne | Hotelclass Klassifikation |
| name | 4 Sterne | Hotelclass Klassifikation |
| name | 5 Sterne | Hotelclass Klassifikation |
| author | HS | Quellpartner HotellerieSuisse |
| author | GS | Quellpartner GastroSuisse |
Features (amenityFeature)¶
The amenity features are available in the property amenityFeature. Possible features are shown in the following table (not exhaustive):
| Id | Name |
|---|---|
| bathroom | Badezimmer |
| bed | Betttype |
| breakfast | Frühstück |
| characteristics | Charaktereigenschaften |
| Conference and events | events |
| entertainment | Unterhaltung und Lifestyle |
| family | Dienstleistungen für Familien |
| food | Essen |
| furnishing | Ausstattung |
| general | Allgemein |
| location | Ort |
| media | Medien |
| meetings | Meetings |
| view | Aussenbereich und Aussicht |
| outdoor | Aussenanlagen |
| security | Sicherheit und Schutz |
| ski | Ski |
| sport | Sport und Freizeit |
| wellness | Wellness-Dienstleistungen |
Info
All amenities can be found in the discover.swiss data classifications under AmenityFeatures: Download
Rooms and meeting rooms (Accommodation)¶
The following table describes the most important properties of the room types (Accommodation):
| ID | Name | Description |
|---|---|---|
| additionalType | Zimmertyp | Art der Accommodation, z.B. HotelRoom oder MeetingRoom |
| branchCode | Zimmercode (STC) | Offizieller Zimmercode STC |
| accommodationCategory | Siehe separate Tabelle | Offizielle Zimmerkategorie HotellerieSuisse |
| typeOfBed | Siehe separate Tabelle | offizieller Bettyp HotellerieSuisse |
| amenityFeatures | Siehe separate Tabelle | Zimmer Ausstattungsmerkmale |
Room categories¶
Room categories are available in the 'accommodation category' property. Possible room categories are:
| Id | Name |
|---|---|
| economy | Zimmerkategorie Economy |
| moderate | Zimmerkategorie Moderate |
| standard | Zimmerkategorie Standard |
| superior | Zimmerkategorie Superior |
| deluxe | Zimmerkategorie Deluxe |
Bed types¶
The bed types are available in the typeOfBed property. Possible bed types are:
| Id | Name |
|---|---|
| single | Betttyp Single |
| twin | Betttyp Twin |
| queen | Betttyp Queen |
| king | Betttyp King |
| double | Betttyp Double |