Hotel-Factsheet-Lösungen

Das Hotel-Factsheet liefert die Basisinformationen eines Hotels statt in Freitext in separaten, filterbaren Feldern: Anlagentyp, Sterne, Zimmerzahl, Check-in-/Check-out-Zeiten, Strand und Pools, Kinder- und Haustierrichtlinie, Restaurants und Kontaktdaten. Die Informationen aller Anbieter werden unter der HM ID des Hotels zusammengeführt, widersprüchliche Werte markiert; geliefert wird per API und Dump-Dateien.

Ihre Vorteile

  • Bereit zum Filtern

    Check-in-Zeit, Kinderrichtlinie, Strandtyp und Zimmerzahl sind separate Felder und lassen sich direkt in Filtern und Vergleichen nutzen.

  • Ein Hotel, eine Wahrheit

    Die Informationen eines Hotels von allen Anbietern werden unter einer HM ID gesammelt. Die Hotelseite ändert sich nicht danach, von welchem Anbieter Sie kommen.

  • Widersprüche sichtbar

    Liefern Anbieter für dasselbe Feld unterschiedliche Werte, wird das Feld markiert. In der Antwort sehen Sie, welche Angabe noch geprüft wird.

  • Konsistent mit den Beschreibungen

    Hotelbeschreibungen entstehen aus denselben Factsheet-Daten; Text und Felder widersprechen sich nicht.

Vorher und nachher

Rohe Anlagendaten von zwei Anbietern

supplier_facts.txt
[A / HTL-88213]
Check-in 14:00 / Check-out 12:00. 412 rooms. Private sandy
beach 250m. 3 outdoor pools, 1 indoor pool. Kids 0-6.99 free.
Pets not allowed.

[B / 40917]
Giriş: 15.00, Çıkış: 12.00 - 410 oda - Otele ait kum plaj
(250 mt) - Açık havuz x3 - Çocuk 0-7 yaş arası ücretsiz

Standard-Factsheet unter einer HM ID

HM-1048213 Factsheet
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "check_in": "14:00",
    "check_out": "12:00",
    "room_count": 412,
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
    "pets_allowed": false,
    "review_flags": ["check_in", "room_count"]
  }
}

Beispieldaten; Hotel und Codes gehören zu keiner realen Anlage. Felder, bei denen sich Anbieter widersprechen (hier Check-in-Zeit und Zimmerzahl), werden mit review_flags markiert.

So funktioniert es

  1. 1

    Quellen zusammenführen

    Die Hotelinformationen aus allen Anbieterdatensätzen derselben HM ID werden zusammengeführt. Rohdaten bleiben unverändert gespeichert, Änderungen werden versioniert.

  2. 2

    In Felder aufteilen

    Zeiten, Zahlen, Entfernungen und Richtlinien aus Freitext werden in separate Felder überführt; Zeit-, Entfernungs- und Altersformate werden vereinheitlicht.

  3. 3

    Widerspruchsprüfung

    Liefern Quellen unterschiedliche Angaben, werden die Werte verglichen. Unklare Felder werden markiert und landen in der Prüfwarteschlange des Datenteams.

  4. 4

    Lieferung und Aktualisierung

    Das Factsheet kommt über GET /v1/hotels/{hm_id}/content zurück; das gesamte Inventar liegt in täglichen vollständigen und Delta-Dump-Dateien vor.

Warum stehen die Factsheet-Angaben in separaten Feldern?

Anbieter senden Hotelinformationen meist im Freitext. Ein Anbieter schreibt als Check-in 14:00, ein anderer 15:00; der eine nennt 412 Zimmer, der andere 410. Die Strandangabe geht in einem Satz unter, die Altersgrenze für Kinder kommt in unterschiedlichen Formaten. So lässt sich weder ein Filter “Hotels mit eigenem Sandstrand” noch “Kinder von 0 bis 6 Jahren kostenlos” aufbauen.

Das Hotel-Factsheet zieht diese Angaben in separate Felder und bindet sie an die HM ID des Hotels. Voraussetzung ist, dass das Hotel korrekt gematcht wird; die Methode finden Sie im Hotel-Mapping-Leitfaden, das Produkt auf der Seite Hotel-Mapping.

Factsheet-Felder

Gruppe Felder Beispielwert
Anlagendaten Anlagentyp, Sterne, Kette und Marke, Zimmer- und Stockwerkzahl, Eröffnungs- und Renovierungsjahr Resort, 5 Sterne, 412 Zimmer
Richtlinien Check-in-/Check-out-Zeit; Kinder-, Haustier-, Rauch- und Zahlungsrichtlinie 14:00 / 12:00, Alter 0-6,99 kostenlos
Strand und Pool Strandtyp, ob zum Hotel gehörig, Entfernung; Zahl der Außen- und Innenpools Sand, hoteleigen, 250 m; 3 außen, 1 innen
Gastronomie Restaurants, Bars, Küchenarten, Öffnungszeiten Türkisches Restaurant, Poolbar
Kontakt und Adresse Geprüfte Adresse, Telefon, E-Mail, Website [email protected]

Feldnamen und Werte sind sprachunabhängig; in Ihrer Oberfläche zeigen Sie die Bezeichnung in Ihrer eigenen Sprache.

Widersprüchliche Angaben

Liefern Anbieter für dasselbe Hotel unterschiedliche Werte, werden die Werte verglichen. Unklare Felder werden mit review_flags markiert und vom Datenteam geprüft. So erkennen Sie an der Antwort, welche Angabe sicher ist und welche noch geprüft wird.

Beschreibungen und Lieferung

Hotelbeschreibungen entstehen aus denselben Factsheet-Daten; eine im Text genannte Uhrzeit oder Entfernung widerspricht dem Wert im Feld nie. Die Fotogalerie des Hotels liegt im Dienst Hotelbilder; steht im Factsheet ein Strand, gibt es aber kein Bild mit der Kategorie Strand, können Sie Ihr Content-Team warnen lassen.

Das Factsheet wird je Hotel über die REST API geliefert, für das gesamte Inventar über tägliche vollständige und Delta-Dump-Dateien. Der Parameter include und die Feldnamen im Beispiel sind ein Entwurf der API v1; das endgültige Schema wird auf der Entwicklerseite veröffentlicht. Für Umfang und Preis können Sie ein Angebot anfordern.

Was ist Hotel-Mapping? Der ausführliche Ratgeber

API-Beispiel

Anfrage

Factsheet-Anfrage
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
  -H "X-API-Key: $HM_API_KEY"

Antwort

200 OK
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "property": { "type": "resort", "stars": 5, "room_count": 412 },
    "policies": {
      "check_in": "14:00",
      "check_out": "12:00",
      "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
      "pets_allowed": false
    },
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "dining": [
      { "type": "restaurant", "cuisine": "turkish" },
      { "type": "bar", "location": "pool" }
    ],
    "contact": { "email": "[email protected]" },
    "review_flags": ["check_in", "room_count"]
  },
  "updated_at": "2026-11-02T08:14:00Z"
}

Die Codebeispiele sind exemplarisch; Feldnamen können sich mit dem v1-Release ändern.

Häufig gestellte Fragen

Was ist ein Hotel-Factsheet?

Es stellt die Basisinformationen eines Hotels (Anlagentyp, Sterne, Zimmerzahl, Check-in-/Check-out-Zeiten, Richtlinien, Gastronomie, Kontakt) als strukturierte Felder bereit.

Was ist der Unterschied zwischen Factsheet und Hotelbeschreibung?

Die Beschreibung ist ein Text zum Lesen; das Factsheet besteht aus separaten Feldern zum Filtern und Vergleichen. Beide beruhen auf denselben geprüften Daten.

Welcher Wert wird verwendet, wenn Anbieter unterschiedliche Angaben liefern?

Die Werte werden verglichen; unklare Felder werden markiert und vom Datenteam geprüft. In der Antwort sehen Sie über review_flags, welche Felder noch geprüft werden.

In welchen Formaten erhalte ich die Factsheet-Daten?

Je Hotel über die REST API oder für das gesamte Inventar über tägliche vollständige und Delta-Dump-Dateien (CSV, JSON). Ein Webhook für Änderungsbenachrichtigungen ist geplant.

Angebot anfordern

Individuelles Angebot erhalten

Senden Sie Ihre Anfrage in drei Schritten; wir schicken das Angebot an Ihre geschäftliche E-Mail. Die Anfrage ist unverbindlich.

  1. 1 Lösungen wählen
  2. 2 Anbieter wählen
  3. 3 Kontaktdaten hinterlassen