Решения для фактшитов отелей
Время заезда и выезда, пляж, бассейн, правила для детей и другие сведения об отеле в отдельных полях под HM ID.
Описания отелей дают для каждого HM ID многоязычный текст, готовый к продаже. Для каждого отеля есть три версии: краткая, средняя и полная; первые языки — турецкий, английский, немецкий, русский и арабский. Тексты создаются на основе factsheet отеля и текстов поставщиков, проходят проверку редактором и передаются через API и dump-файлы.
{
"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ı.)"
}
} Краткий текст подходит для карточки в результатах поиска, средний — для верха страницы отеля, полный — для раздела с подробностями. Обрезать текст под каждый экран отдельно не нужно.
Описания на турецком, английском, немецком, русском и арабском основаны на одних и тех же проверенных данных. При выходе на новый рынок текст не нужно заказывать заново.
Черновик создаёт ИИ, редакторы проверяют точность и стиль. Время, числа и правила берутся из полей factsheet.
Каждое описание привязано к одному HM ID. Даже если вы смените поставщика или добавите нового, текст останется у того же отеля.
Текст об отеле от трёх поставщиков
[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) Описание трёх длин под одним 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ı.)"
}
} Это пример данных; отель и коды не относятся к реальному объекту. Повторы и преувеличения убираются; расстояния и числа в тексте берутся из полей factsheet.
Все тексты поставщиков и данные factsheet отеля, объединённого в один HM ID при маппинге, собираются вместе.
ИИ создаёт краткое, среднее и полное описание на основе данных factsheet и текстов поставщиков; повторяющиеся и противоречащие формулировки убираются.
Редакторы проверяют текст на точность и стиль. Все языки основаны на одной и той же информации.
При изменении сведений об объекте обновляется и описание; текст не расходится с factsheet.
Описания возвращаются с эндпоинта GET /v1/hotels/{hm_id}/content по параметру языка; весь фонд поступает в ежедневных полных и delta dump-файлах.
Маппинг объединяет один и тот же отель в одном HM ID, но рекламный текст по-прежнему различается столько раз, сколько у вас поставщиков. Один поставщик присылает только английский текст с повторяющимися фразами, другой — однострочную заметку на турецком, третий вообще не присылает текст. Страница отеля меняется в зависимости от того, чей контент использован; при выходе на немецкоязычный или русскоязычный рынок текст приходится заказывать заново.
Описания отелей закрывают этот разрыв на уровне HM ID: для каждого отеля один согласованный текст, готовый к продаже. Обязательное условие — правильное сопоставление отеля; метод описан в руководстве по маппингу отелей, продукт — на странице маппинга отелей.
| Версия | Формат | Где используется |
|---|---|---|
| Краткая | Одно предложение | Карточка в результатах поиска, карточка на карте |
| Средняя | Один абзац | Верхняя часть страницы отеля |
| Полная | Несколько абзацев | Вкладка с подробностями: расположение, номера, питание, удобства |
Каждая версия основана на одной и той же информации. Краткий текст — не обрезанная версия полного; он пишется отдельно для своего места.
Описание основано на проверенных данных, собранных из всех записей отеля у поставщиков. Время, числа, расстояния и правила берутся из полей factsheet отеля. Поэтому время заезда или расстояние до пляжа в тексте не расходятся со значением в factsheet.
Черновик создаёт ИИ; повторяющиеся, преувеличенные и противоречащие друг другу формулировки убираются. Затем редакторы проверяют текст на точность и стиль. При изменении сведений об объекте обновляется и описание.
В первой версии доступны описания на турецком, английском, немецком, русском и арабском. Поскольку все языки создаются из одной информации, страницы на разных языках рассказывают об одном и том же отеле.
Описания передаются по отелям через REST API, а для всего фонда — ежедневными полными и delta dump файлами. Параметры include и lang в примере — черновик API v1; точная схема публикуется на странице для разработчиков.
Структурированные сведения для фильтрации и сравнения находятся в продукте factsheet отеля. Фотогалерея отеля очищается от дубликатов и размечается по категориям в сервисе фото отелей. Для информации об охвате и стоимости запросите предложение.
Запрос
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
-H "X-API-Key: $HM_API_KEY" Ответ
{
"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"
} Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1.
Первые языки — турецкий, английский, немецкий, русский и арабский. Все языки основаны на одних и тех же проверенных данных. График новых языков пока не определён.
Текст создаёт ИИ, редакторы проверяют точность и стиль. Время, числа и правила берутся из структурированных данных factsheet.
Описание — это текст, написанный для чтения. Factsheet же передаёт время заезда и выезда, пляж, бассейн, правила для детей и другие сведения в отдельных полях для фильтрации и сравнения. Оба основаны на одних и тех же данных.
По отелям — через REST API, для всего фонда — ежедневными полными и delta dump-файлами. Для уведомлений об изменениях планируется webhook.
Условия использования и лицензии на контент определяются в договоре.
Запросить предложение
Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.