# Hotel descriptions solutions

> URL: https://hotelmapping.org/en/products/hotel-descriptions-solutions/ · Language: English

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**

```text
[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)**

```json
{
  "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. **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. **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. **Editor review:** Editors check the text for accuracy and style. All languages rest on the same information.
4. **Updates:** When property information changes, the description is updated too; the text never drifts out of line with the factsheet.
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.

## API example

**Requesting English descriptions**

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

**200 OK**

```json
{
  "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._

## 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](https://hotelmapping.org/en/guide/what-is-hotel-mapping/) and the product on the [hotel mapping](https://hotelmapping.org/en/products/hotel-mapping-solutions/) 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](https://hotelmapping.org/en/products/hotel-factsheet-solutions/) 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](https://hotelmapping.org/en/glossary/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](https://hotelmapping.org/en/developers/).

## Related products

The structured information needed for filtering and comparison is in the [hotel factsheet](https://hotelmapping.org/en/products/hotel-factsheet-solutions/) product. The hotel's photo gallery is deduplicated and category-tagged in the [hotel images](https://hotelmapping.org/en/products/hotel-images-solutions/) service. For coverage and pricing, you can [request a quote](https://hotelmapping.org/en/get-a-quote/).

## 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.

## Related products

- [Hotel factsheet solutions](https://hotelmapping.org/en/products/hotel-factsheet-solutions/)
- [Hotel images solutions](https://hotelmapping.org/en/products/hotel-images-solutions/)
- [Hotel mapping solutions](https://hotelmapping.org/en/products/hotel-mapping-solutions/)

## Related articles

- [What is hotel XML integration? Static vs. dynamic data](https://hotelmapping.org/en/guide/what-is-hotel-xml-integration/)
- [What is hotel mapping? How it works: a complete guide](https://hotelmapping.org/en/guide/what-is-hotel-mapping/)
- [What duplicate hotel listings cost an agency: conversion, cancellations and complaints](https://hotelmapping.org/en/guide/cost-of-duplicate-hotel-listings/)
