Hotel factsheet solutions
Hotel details such as check-in/out time, beach, pool and child policy, in separate fields tied to the HM ID.
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.
{
"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ı.)"
}
} 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.
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 produces the draft; editors check it for accuracy and style. Details such as times, numbers and policies come from factsheet fields.
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.
Hotel text arriving from three suppliers
[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_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.
Once hotel mapping merges a hotel into a single HM ID, all of its supplier texts and factsheet data are brought together.
AI produces a short, medium and long description from the factsheet data and supplier texts; repeated and contradictory wording is filtered out.
Editors check the text for accuracy and style. All languages rest on the same information.
When property information changes, the description is updated too; the text never drifts out of line with the factsheet.
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.
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.
| 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.
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.
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.
Request
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
-H "X-API-Key: $HM_API_KEY" Response
{
"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.
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.
AI produces the text; editors check it for accuracy and style. Details such as times, numbers and policies come from structured factsheet data.
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.
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.
The terms of use and licensing for the content are set in the contract.
Request a quote
Send your request in three steps; we will email the quote to your work address. The request is non-binding.