Сценарий использования

API данных об отелях с Airbnb, Zillow и авиаперелётами

Цены и оценки отелей Booking.com, жильё Airbnb, места Tripadvisor, дома Zillow и тарифы Google Flights в виде JSON для вашего приложения или агента.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Booking.comAirbnbTripadvisorZillowGoogle Flightslovelyjsonitems[0]"name": "Casa del Mar""city": "Lisbon""rating": 9.1"nightly": 142"beds": 2"reviews": 1204

Мониторинг цен конкурентов, исследование рынка аренды, агенты для планирования поездок и отбор недвижимости начинаются с одного и того же: актуальных объявлений с ценами для выбранного места и дат. Lovely Router возвращает их в виде JSON с Booking.com, Airbnb, Tripadvisor, Zillow и Google Flights: API данных об отелях и API данных о недвижимости на одном ключе. Вы платите за каждый возвращённый отель, объявление или место с одного предоплаченного баланса и вызываете инструменты из своего кода или позволяете ИИ-агенту вызывать их через MCP.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Get hotel prices and review scores from Booking.com, Airbnb stays, Tripadvisor places, Zillow homes and Google Flights fares. 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 destinations, dates, budget and what to compare>
01

Как это работает

010203
  1. Выберите место и даты

    Направление для отелей, URL поиска Airbnb с датами, город для Tripadvisor, почтовые индексы для Zillow, маршрут для перелётов.

  2. Запустите инструмент с лимитом

    Отправьте входные данные в POST /v1/tools/{id}/run с max_results. Запуск резервирует свою максимальную стоимость и списывает итог по фактически возвращённым результатам.

  3. Сравнивайте и повторяйте

    Сохраняйте цены вместе с датой сбора, затем повторяйте запуск по расписанию, чтобы следить за тарифами, арендными ставками или ценами на билеты во времени.

02

Цены отелей одним запросом

Поиск отелей на Booking.com ищет по направлению на ваши даты и возвращает каждый отель с ценой за проживание. Этот запуск запрашивает 20 отелей в Лиссабоне на пять ночей для двух взрослых с ценами в евро:

curl https://lovelyrouter.com/v1/tools/booking-hotels/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "search": "Lisbon",
      "checkin": "2026-11-09",
      "checkout": "2026-11-14",
      "adults": 2,
      "currency": "EUR"
    },
    "max_results": 20
  }'

У каждого отеля в items есть название, цена за проживание, оценка по отзывам, звёзды, адрес и признак бесплатной отмены. Если оставить checkin пустым, инструмент посчитает цену одной ночи через 30 дней от текущей даты. Запуск, который всё ещё идёт через 60 секунд, возвращает 202; как опрашивать его, показано в разделе Запуск инструмента.

03

Инструменты

Booking.com
Поиск отелей на Booking.com

Отели на Booking.com по направлению (и датам): название, цена за проживание, оценка гостей, звёзды, адрес, бесплатная отмена.

$0.0025 / hotelПодробности →
Booking.com
Отзывы об отелях Booking.com

Отзывы гостей об отелях Booking.com: оценка, что понравилось, что не понравилось, тип путешественника, дата.

$0.00285 / reviewПодробности →
Airbnb
Поиск жилья на Airbnb

Объявления Airbnb по месту и датам: цена за проживание и за ночь, рейтинг, отзывы, хозяин, удобства, правила дома, фото.

$0.00075 / listingПодробности →
Tripadvisor
Поиск в Tripadvisor

Отели, рестораны и достопримечательности Tripadvisor в указанном месте.

$0.00435 / placeПодробности →
Zillow
Поиск объявлений Zillow

Дома на Zillow на продажу, в аренду или недавно проданные в указанных ZIP-кодах: цена, спальни, санузлы, жилая площадь, адрес, Zestimate.

$0.00225 / listingПодробности →
Google Flights
Поиск в Google Flights

Варианты перелётов и цены из Google Flights по маршруту и датам: авиакомпании, время, пересадки, длительность, цена.

$0.01125 / callПодробности →
ИнструментЧто вы отправляетеЧто содержит каждый результат
booking-hotelssearch, checkin, checkout, adults, currencyНазвание, цена за проживание, оценка по отзывам, звёзды, адрес, бесплатная отмена
booking-reviewsstartUrls отелей, sortReviewsBy, reviewScoresОценка, что понравилось, что не понравилось, тип путешественника, дата
airbnb-listingsurls: URL поиска Airbnb с датами (подойдёт и название места)Цена за проживание и за ночь, рейтинг, отзывы, хозяин, удобства, правила дома, фото
tripadvisor-placesquery (место или ключевое слово), includeHotels, includeRestaurantsОтель, ресторан или достопримечательность в этом месте
zillow-listingslocations (почтовые индексы), operation (buy, rent или sold), minPrice, maxPriceЦена, спальни, санузлы, жилая площадь, адрес, Zestimate
google-flightssearches: откуда, куда, даты (коды IATA), а также adults, cabinClass, maxStopsАвиакомпании, время, пересадки, длительность, цена
04

Рецепты

Мониторинг цен для отеля

Каждое утро запускайте booking-hotels для своего города и дат, которые продаёте, и отслеживайте цену проживания в отелях вашей конкурентной группы. Добавьте booking-reviews с "sortReviewsBy": "f_recent_desc", чтобы видеть, что их гостям нравится и не нравится в этом месяце.

Отель или краткосрочная аренда?

Запустите airbnb-listings с https://www.airbnb.com/s/Lisbon/homes?checkin=2026-11-09&checkout=2026-11-14&adults=2 и сравните цены за ночь и рейтинги с отелями Booking.com на те же даты.

Оценка района

Запустите zillow-listings для индекса 78701 три раза, с operation, равным buy, rent и sold, и сравните запрашиваемые цены, цены недавних продаж и арендные ставки в расчёте на жилую площадь. Zestimate приходит с каждым домом.

Планирование поездки

Узнайте цены на перелёты через google-flights с "searches": [{"origin": "LAX", "destination": "JFK", "departureDate": "2026-11-04", "returnDate": "2026-11-09"}], затем найдите отели на те же даты через booking-hotels и чем заняться — через tripadvisor-places.

Путеводитель по городу

Запустите tripadvisor-places с "query": "Chicago" и "includeRestaurants": true, чтобы получить список отелей, ресторанов и достопримечательностей, затем соберите отзывы о тех, что попадут в путеводитель, с помощью инструмента Отзывы Tripadvisor.

Агент, подключённый к MCP-серверу, сделает то же самое по одному промпту в Claude Code или Cursor: «Найди перелёты туда и обратно из LAX в JFK с вылетом 4 ноября и возвращением 9 ноября и пять отелей в Мидтауне с лучшим рейтингом дешевле 300 долларов за ночь на эти даты. Покажи и то и другое таблицами и задавай max_results при каждом запуске».

05

Сколько это стоит

Каждый инструмент тарифицирует результат: отель, объявление, место, отзыв или поиск перелётов, плюс плата за вызов у тех инструментов, где она есть; актуальные цены — на карточках выше. При старте запуск резервирует максимальную стоимость — плата за вызов плюс плата за результат, умноженная на max_results, — и списывает итог по возвращённому. Запуск, который завершился ошибкой или по таймауту, оплачивает только доставленные результаты, а запуск, отклонённый на старте, ничего не стоит.

Нет ни подписки, ни минимального срока. Пополните баланс от $5, и тот же баланс оплатит вызовы моделей, если агент или ваш код резюмирует результаты. Цены на все инструменты — на странице цен.

06

Частые вопросы

?
Включают ли данные об отелях цены на мои даты?+

Да. Инструмент booking-hotels принимает даты заезда и выезда и число взрослых и возвращает цену за это проживание. Без даты заезда он считает цену одной ночи через 30 дней от текущей даты.

В каких валютах можно получить цены отелей?+

Инструмент booking-hotels принимает валюту из списка из 20, например USD, EUR, GBP, JPY, CNY или AUD. Google Flights принимает для своих цен любой трёхбуквенный код валюты.

Можно ли получить аренду и недавно проданные дома на Zillow, а не только дома на продажу?+

Да. Задайте operation равным rent или sold вместо buy. Для аренды minPrice и maxPrice указываются за неделю.

Как искать на Airbnb на конкретные даты?+

Передайте URL поиска Airbnb, в котором есть даты и число гостей, например /s/Lisbon/homes?checkin=…&checkout=…&adults=2. Подойдёт и просто название места. Каждое объявление возвращается с ценой за проживание и за ночь.

Можно ли забронировать отель или перелёт через API?+

Нет. Эти инструменты читают публичные объявления и цены, они не бронируют. Для веб-задачи, где нужны клики и формы, см. браузерный агент.

Есть ли данные о недвижимости за пределами США?+

Инструмент Zillow ищет по почтовым индексам США. Для проживания в других странах Booking.com, Airbnb и Tripadvisor ищут по названию места, так что подойдёт любой город или регион, который можно указать на этих сайтах.

Отзывы гостей с большего числа сайтов — в разделе мониторинг отзывов, а агенты, которые сочетают эти инструменты с веб-поиском, — в разделе исследовательские агенты.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.