Что гостям нравится и не нравится в отеле — по их отзывам
Получайте отзывы гостей Booking.com в JSON с оценкой, плюсами, минусами, типом путешественника и датой, чтобы понять, что исправить и чем гордиться.
Средняя оценка отеля скрывает свои причины. Причины — в тексте: шум, на который жалуются, завтрак, который хвалят, номер, о котором предупреждают других. Booking.com делит отзывы гостей на то, что понравилось и что не понравилось, но отзывов тысячи, и посчитать их невозможно. Lovely Router получает их для выбранных вами отелей. Отправьте ссылки на отели, получите по одному JSON-объекту на отзыв и платите за каждый отзыв с предоплаченного баланса.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Что гостям нравится и не нравится в отеле — по их отзывам. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <the inputs (links, keywords or accounts) and how many results you need>Как это работает
Соберите ссылки на отели
Возьмите страницу Booking.com своего отеля и трёх-четырёх отелей, с которыми вы конкурируете.
Запустите инструмент с лимитом
Отправьте ссылки в
POST /v1/tools/booking-reviews/run. ЗадайтеmaxReviewsPerHotelво входных данных иmax_resultsв теле запроса. Запуск резервирует свою максимальную стоимость на балансе и возвращает отзывы в виде JSON.Посчитайте темы
Попросите модель разметить каждый текст о плюсах и минусах темами вроде шума, чистоты, завтрака и персонала, затем посчитайте их по отелю, месяцу и типу путешественника.
Отзывы об отеле одним запросом
Отзывы об отелях Booking.com принимают страницы отелей в startUrls. maxReviewsPerHotel ограничивает число отзывов на отель, sortReviewsBy задаёт порядок, а reviewScores фильтрует по оценке:
curl https://lovelyrouter.com/v1/tools/booking-reviews/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"startUrls": [
{"url": "https://www.booking.com/hotel/cz/jeromehouse.en-gb.html"}
],
"maxReviewsPerHotel": 3
},
"max_results": 3
}'Запуск, который всё ещё идёт через 60 секунд, возвращает 202; как опрашивать его, показано в разделе «Запустить инструмент». sortReviewsBy принимает f_relevance, f_recent_desc, f_recent_asc, f_score_desc и f_score_asc. Один запуск может вернуть до 500 отзывов.
Что есть в каждом отзыве
| Группа полей | Что вы получаете |
|---|---|
| Оценка | Оценка в отзыве |
| Обратная связь | Что гостю понравилось и что не понравилось |
| Гость | Тип путешественника |
| Время | Дата отзыва |
Рецепты
Получите отзывы о своём отеле с самыми низкими оценками, задав sortReviewsBy равным f_score_asc, разметьте минусы и отправьте три самые частые темы службе эксплуатации.
Получите отзывы с самыми высокими оценками, соберите то, что понравилось гостям, и используйте их слова в описании и подписях к фото.
Разделите отзывы по типу путешественника. Семьям может быть важен простор, а парам — тишина, и ваша реакция будет разной.
Получите свежие отзывы с f_recent_desc до и после работ, затем сравните, как часто упоминается отремонтированная зона и в каком тоне.
Запустите свой отель и четырёх конкурентов, посчитайте, как часто каждая тема встречается у каждого отеля, и найдите тему, в которой вы отстаёте.
Удобнее обычными словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Получи 100 отзывов с самыми низкими оценками для этого отеля на Booking.com, сгруппируй минусы по темам и покажи количество. Задай max_results равным 100.»
Сочетайте с другими источниками отзывов
Гости Booking.com — лишь часть путешественников:
Отзывы гостей об отелях Booking.com: оценка, что понравилось, что не понравилось, тип путешественника, дата.
Отели на Booking.com по направлению (и датам): название, цена за проживание, оценка гостей, звёзды, адрес, бесплатная отмена.
Отзывы об отелях, ресторанах и достопримечательностях на Tripadvisor: рейтинг, заголовок, текст, дата, тип поездки.
Отзывы о месте в Google Maps (по place ID или URL): текст, звёзды, дата, ответы владельца.
Отзывы о компании на Trustpilot по домену: звёзды, текст, дата, ответ.
booking-hotelsпоказывает цены и оценки отелей, с которыми вы себя сравниваете.tripadvisor-reviewsдобавляет вторую аудиторию путешественников.google-maps-reviewsохватывает отзывы в карточке на картах, куда многие гости смотрят в первую очередь.trustpilot-reviewsохватывает отзывы о компании в целом, если у вас сеть отелей.
Более широкая задача отслеживания отзывов описана в сценарии «Мониторинг отзывов».
Сколько это стоит
Вы платите за каждый отзыв: при старте запуска резервируется его максимальная стоимость — плата за вызов плюс плата за отзыв, умноженная на max_results, — а итоговое списание соответствует тому, что запуск вернул. Остаток резерва возвращается на баланс. Запуск, который завершился ошибкой или по тайм-ауту, оплачивается только за выданные отзывы, а запуск, отклонённый на старте, ничего не стоит.
Нет ни подписки, ни ежемесячного минимума: пополняйте баланс от $5, и один баланс оплачивает и инструменты, и модели. На карточке выше указана текущая цена; на странице «Цены» перечислены все инструменты.
Частые вопросы
Можно ли получить только плохие отзывы?+
Да. Используйте reviewScores, чтобы фильтровать по оценке так, как она показана на Booking.com, или задайте sortReviewsBy равным f_score_asc и ограничьте число отзывов.
Можно ли получить сначала самые новые отзывы?+
Да. Задайте sortReviewsBy равным f_recent_desc.
Можно ли прочитать отзывы о нескольких отелях за один запуск?+
Да. startUrls — это список. maxReviewsPerHotel ограничивает каждый отель отдельно, поэтому учитывайте общее число, когда задаёте max_results.
Сколько отзывов может вернуть один запуск?+
До 500. Начните с небольшого лимита, чтобы увидеть, как выглядит отзыв, прежде чем его поднимать.
Нужна ли подписка?+
Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. Неудачные запуски оплачиваются только за выданные результаты, и ничего не продлевается автоматически.
Работаете над впечатлениями гостей? Смотрите мониторинг отзывов, данные о путешествиях и недвижимости и каталог инструментов.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.