Hotel descriptions solutions

Hotel descriptions deliver multilingual, sales-ready marketing copy for every HM ID. Each hotel has three versions: short, medium and long; the first languages are Turkish, English, German, Russian and Arabic. Texts are generated from the hotel's factsheet data and supplier texts, checked by editors, and delivered through the API and dump files.

What you gain

  • Three text lengths

    The short text fits a search result card, the medium text the top of a hotel page, and the long text the detail section. You do not have to trim the text separately for each screen.

  • Same facts in five languages

    Turkish, English, German, Russian and Arabic descriptions rest on the same verified information. When you open a new market, you do not have to commission the content from scratch.

  • AI and editors

    AI produces the draft; editors check it for accuracy and style. Details such as times, numbers and policies come from factsheet fields.

  • Tied to the matched hotel

    Every description is tied to an HM ID. Even if you switch suppliers or add a new one, the text stays with the same hotel.

Before and after

Hotel text arriving from three suppliers

supplier_descriptions.txt
[A / HTL-88213]  lang=en
Nice hotel near the beach. Great pools!! Check-in 14:00.
Great pools and great food. Close to the beach.

[B / 40917]  lang=tr
Belek'te 5 yıldızlı otel.

[C / TR-ANT-551]  lang=de
(açıklama yok)

Descriptions in three lengths under one HM ID

HM-1048213 hotel descriptions (tr)
{
  "hm_id": "HM-1048213",
  "lang": "tr",
  "available_langs": ["tr", "en", "de", "ru", "ar"],
  "descriptions": {
    "short": "Belek'te, otele ait kum plaja 250 metre mesafede, üç açık havuzlu resort otel.",
    "medium": "Sunset Bay Resort & Spa, Antalya'nın Belek bölgesinde, otele ait kum plaja 250 metre uzaklıktadır. 412 odalı tesiste üç açık ve bir kapalı havuz bulunur.",
    "long": "Sunset Bay Resort & Spa, Belek'in sahil şeridinde yer alır. (Örnekte kısaltıldı.)"
  }
}

Sample data; the hotel and codes do not belong to a real property. Repetitive and exaggerated wording is removed; the distances and numbers in the text come from factsheet fields.

How it works

  1. 1

    Start with the right hotel

    Once hotel mapping merges a hotel into a single HM ID, all of its supplier texts and factsheet data are brought together.

  2. 2

    Draft generation

    AI produces a short, medium and long description from the factsheet data and supplier texts; repeated and contradictory wording is filtered out.

  3. 3

    Editor review

    Editors check the text for accuracy and style. All languages rest on the same information.

  4. 4

    Updates

    When property information changes, the description is updated too; the text never drifts out of line with the factsheet.

  5. 5

    Delivery

    Descriptions are returned from GET /v1/hotels/{hm_id}/content with a language parameter; the full inventory arrives in daily full and delta dump files.

What do hotel descriptions solve?

Mapping merges the same hotel under one HM ID, but the marketing copy still differs by as many suppliers as you have. One supplier sends only English text with repeated sentences, another a one-line note in Turkish, and a third sends no text at all. The hotel page changes depending on whose content is used, and when you want to open a German- or Russian-speaking market, you have to commission the text from scratch.

Hotel descriptions close that gap at HM ID level: a single, consistent, sales-ready text for every hotel. The precondition is matching the hotel correctly; you can find the method in the hotel mapping guide and the product on the hotel mapping page.

Three lengths, three uses

Version Format Where it is used
Short One sentence Search result card, map card
Medium One paragraph Top section of the hotel page
Long Several paragraphs Detail tab: location, rooms, dining, facilities

Every version rests on the same information. The short text is not a trimmed version of the long one; it is written separately for its own slot.

How are the texts prepared?

A description rests on verified information compiled from all of a hotel’s supplier records. Details such as times, numbers, distances and policies come from the hotel factsheet fields. So a check-in time or beach distance mentioned in the text never contradicts the value in the factsheet.

AI produces the draft; repeated, exaggerated and mutually contradictory wording is filtered out. Editors then check the text for accuracy and style. When property information changes, the description is updated as well.

Languages and delivery

The first release offers descriptions in Turkish, English, German, Russian and Arabic. Because all languages are produced from the same information, a page in one language and a page in another describe the same hotel.

Descriptions are delivered per hotel through the REST API and for the whole inventory through daily full and delta dump files. The include and lang parameters in the example are an API v1 draft; the final schema will be published on the developers page.

The structured information needed for filtering and comparison is in the hotel factsheet product. The hotel’s photo gallery is deduplicated and category-tagged in the hotel images service. For coverage and pricing, you can request a quote.

What is hotel mapping? The complete guide

API example

Request

Requesting English descriptions
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
  -H "X-API-Key: $HM_API_KEY"

Response

200 OK
{
  "hm_id": "HM-1048213",
  "lang": "en",
  "available_langs": ["tr", "en", "de", "ru", "ar"],
  "descriptions": {
    "short": "Resort hotel in Belek, 250 m from its private sandy beach, with three outdoor pools.",
    "medium": "Sunset Bay Resort & Spa is in Belek, Antalya, 250 metres from the hotel's private sandy beach. The 412-room property has three outdoor pools and one indoor pool.",
    "long": "Sunset Bay Resort & Spa sits on the Belek coastline. (Shortened in this example.)"
  },
  "updated_at": "2026-11-02T08:14:00Z"
}

Code samples are illustrative; field names may change in the v1 release.

Frequently asked questions

Which languages are the hotel descriptions available in?

The first languages are Turkish, English, German, Russian and Arabic. All languages rest on the same verified information. The schedule for new languages has not been set yet.

Who writes the descriptions?

AI produces the text; editors check it for accuracy and style. Details such as times, numbers and policies come from structured factsheet data.

What is the difference between a description and the factsheet?

A description is text written to be read. The factsheet gives details such as check-in/check-out time, beach, pool and child policy in separate fields for filtering and comparison. Both rest on the same data.

How are the descriptions delivered?

Per hotel through the REST API, and for the whole inventory through daily full and delta dump files. A webhook for change notifications is planned.

Can I publish the descriptions on my own website and app?

The terms of use and licensing for the content are set in the contract.

Request a quote

Get your tailored quote

Send your request in three steps; we will email the quote to your work address. The request is non-binding.

  1. 1 Select solutions
  2. 2 Select suppliers
  3. 3 Leave your contact details