Skip to content

Hotel- und Zimmerdaten von HotellerieSuisse stehen über das Infocenter von discover.swiss zur Verfügung. Diese Seite soll helfen die Daten von HotellerieSuisse abzurufen.

Zugriff

Die Daten können kostenfrei von über die Infocenter API abgerufen werden. Der freie Infocenterzugang ist jedoch in der Funktion eingeschränkt. Folgende Einschränkungen bestehen:

  • Die umfangreichen Suchfunktionen stehen nicht zur Verfügung
  • Wetterdaten können nicht abgerufen werden
  • Der Media Service steht nicht zur Verfügung der z.B. Bilder automatisch zuschneiden kann, die Bilder über einen CDN zur Verfügung stellt sowie automatisch den Bildnachweis in das Bild hinzufügt
  • Die Anzahl Anfragen ist limitiert (60 Anfragen pro Minute und 50'000 Anfragen pro Monat)

Diese Daten stehen auch über das kostenpflichtige Infocenter zur Verfügung. Auf der Seite How to get access ist beschrieben wie ein Subskription-Key erstellt werden kann. Für den kostenfreien Zugang muss das Produkt Infocenter Open verwendet werden.

Der Subskription Key muss bei allen API Anfragen im Header Ocp-Apim-Subscription-Key mitgegeben werden. Zusätzlich zu dem Subskription Key muss das Projekt dsod-hs als Query Parameter mitgegeben werden um nur die HotellerieSuisse spezifsichen Daten zu erhalten.

Hotels abrufen

Über den List-Enpunkt können alle Hotels abgerufen werden: 

  GET /info/v2/lodgingbusinesses/?project=dsod-content HTTP/1.1
  Host: api.discover.swiss
  Ocp-Apim-Subscription-Key: 1234
  Accept-Language: de

Beispiel Antwort 
  {
    "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": "Außenanlagen",
            "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": "Außenanlagen",
            "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"
      }
    ]
  }

Hinweise zu der Datenstruktur:

  • Die Liste amenityFeature enthält die Ausstattungsmerkmale, welche durch HotellerieSuisse standardisiert wurden. Ausstattungsmerkmale, die nicht im Standard enthalten sind, jedoch durch ein System geliefert werden, starten mit einem 3 Stellingen Kürzel wie z.B. tom- frt-.
  • Das Hauptbild ist im Feld image enthalten
  • Das Feld photo enthält alle Bilder sortiert noch der Priorität. Das Hauptbild entspricht dem ersten gelieferten Bild in der Liste.
  • Die Liste award enthält die offiziellen HotellerieSuisse Klassifizierungen sowie Labels wie z.B. von Swisstainable
  • Details zum Datenschema sowie zu den API-Endpunkten sind in der OpenAPI Definition im Developer Portal verfügbar.
  • Die HotellerieSuisse ID ist in der additionalProperty Liste mit der Property ID hsId vorhanden.
  • Hier geht es zur Übersicht der LodgingBusiness-Properties.

Sprache

Die Inhalte werden in der Sprache zurückgeliefert, welche im Accept-Language mitgegeben wird. Default ist Deutsch.

Continuation Token

Beim List Enpunkt wird ein Continuation Token zurückgeliefert, über das die weiteren Seiten abgerufen werden können. Wie das Token verwenden werden kann ist auf folgender Seite erklärt:
How to get access to the API #continuationtoken

Bilder

Die Lizenz und Copyright Informationen in den Daten wie auch Bildern müssen eingehalten werden. Über die Informationen im DataGovernance Objekt können die nötigen Bildnachweis-Informationen zusammengestellt werden. Siehe bibliography

Zugänglichkeits Informationen (Barrierefreiheit)

Die Zugänglichkeitsinformationen können als strukturierte Daten über den Link im Link Array mit dem Typ GintoResource abgerufen werden. Ginto liefert eine fertige HTML Seite auf die referenziert werden kann. Diese Seite ist über den Link mit dem Typ GintoWeb verfügbar.

Beispiel: 

{
    "link": [
        {
            "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"
        }
    ]
}

Zimmerkategorien abrufen

Über /info/v2/accommodations kann eine Liste von allen Zimmern abgerufen werden. Die Hotels enthalten einen Array mit allen Zimmerkategorien. Hier geht es zur Übersicht der 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"
    }
  ]
}

In @id ist die vollständige URL enthalten und identifier enthält die ID des Objektes. Mit diesen Informationen kann das Zimmer anschliessend über den Accommodation Endpunkt abgerufen werden.

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
Beispiel Antwort 
  {
    "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&uuml;gt auch &uuml;ber einen Balkon.<br>Die exklusive Badetasche mit Bademantel, Saunatuch und Badeslipper steht im Zimmer schon f&uuml;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"
  }

Übersicht Eigenschaften

In der nachfolgenden Übersicht werden die einzelnen Properties der Infocenter-Klassen, hinsichtlich der AccommoDataHub-Verwendung ausführlicher erklärt.

Unterkunft (LodgingBusiness)

In der folgenden Tabelle werden die wichtigsten Eigenschaften der Unterkunft (LodgingBusiness) beschrieben:

Property ID Wert Beschreibung
AdditionalProperty.hsId Individuelle HotellerieSuisse Id Offizielle eindeutige ID von HotellerieSuisse.
AdditionalType - Hotel
- ServicedApartments
- swissLodge		 Offizieller Subtyp
starRating Siehe separate Tabelle Offizielle Hotelklassifizierung
Tag Siehe separate Tabelle Enthält eine Liste von Tags wie z.B. die Tourismuszone oder Familienfreundlich etc.
ParentOrganization Siehe separate Tabelle Hotelgruppe
Award Siehe separate Tabelle Spezialisierungslabel HotellerieSuisse
AmenityFeatures Siehe separate Tabelle Unterkunftausstattungsmerkmale

Labels

Labels wie HotellerieSuisse Spezialisierungen, Ibex, Swisstainable etc. sind in der Eigenschaft Awards verfügbar. Mögliche Awards sind:

Id Name Beschreibung
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

Die offiziellen Tourismuszonen des BFS sind als Tag auf dem LodgingBusiness ersichtlich. Folgende Tourismuszonen sind verfügbar:

Id Name
tourismzone-city Grossstadt
tourismzone-town Kleine Stadt
tourismzone-mountains Berg
tourismzone-countryside Land

Tourismusregion

Die offiziellen Tourismusregionen des BFS sind als Tag auf dem LodgingBusiness ersichtlich. Folgende Tourismusregionen sind verfügbar:

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

Hotelgruppen

Hotelgruppen sind in der Eigenschaft parentOrganisation verfügbar. Mögliche Hotelgruppen sind:

Id Gruppenname
loc_rmx BWH Hotel Group
loc_xx49u18 H-Hotels.com
loc_xy1943 Hilton
loc_yxw IHG Hotels & Resorts
loc_0q9q7q Katara Hospitality
loc_2q77y499 Marriott
loc_7qty8843 Radisson Hotel Group
loc_v79_fqdvegqi-rqvf-ecsc-jfaq-dvrrcdsgtiug Swiss Deluxe Hotels
loc_v79_gdsairav-vcjv-esib-rdgq-vgdsevdibebq Swiss Golf Hotels
loc_v79_qfhavtqh-hcuq-erec-iads-efhujhuchree The Leading Hotels of the World

StarRating

Die offizielle Hotelklassifizierung von HotellerieSuisse und GastroSuisse ist in der Eigenschaft starRating verfügbar.

ID Name Beschreibung
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

Ausstattungsmerkmale (amenityFeature)

Die Ausstattungsmerkmale sind in der Eigenschaft amenityFeature verfügbar. Mögliche Ausstattungsmerkmale sind in der folgenden Tabelle ersichtlich (nicht abschliessend):

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

Alle Ausstattungsmerkmale sind in der Datenklassifizierungen von discover.swiss unter AmenityFeatures zu finden: Download

Zimmer (Accommodation)

In der folgenden Tabelle werden die wichtigsten Eigenschaften der Zimmer (Accommodation) beschrieben:

ID Name Beschreibung
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

Zimmerkategorien

Zimmerkategorien sind in der Eigenschaft accommodationCategory verfügbar. Mögliche Zimmerkategorien sind:

Id Name
economy Zimmerkategorie Economy
moderate Zimmerkategorie Moderate
standard Zimmerkategorie Standard
superior Zimmerkategorie Superior
deluxe Zimmerkategorie Deluxe

Betttypen

Die Betttypen sind in der Eigenschaft typeOfBed verfügbar. Mögliche Betttypen sind:

Id Name
single Betttyp Single
twin Betttyp Twin
queen Betttyp Queen
king Betttyp King
double Betttyp Double