SuperTours.ru Tour Search

Get full tour details by slug or UUID: description, duration, tariffs with their prices and what a price pays for (per person or per group), meeting point, languages, activity level, kids, the tour's own rating and reviews count, settlement, country and photos. Use this after search_tours to fetch the full description for a selected tour. (RU: Полные детали тура по slug или UUID.)

List user reviews for a tour by slug or UUID, newest first. Returns rating, author name, text and the date of each review, plus the tour's average rating. Use after get_tour to substantiate recommendations with real-customer feedback. (RU: Отзывы пользователей на тур.)

Get the most viewed tours (by view count, then recency). Use to give an agent quick recommendations when the user is undecided. (RU: Самые популярные туры — для общих рекомендаций.)

List Russian regions (subjects of the Russian Federation) with optional name prefix filter. Returns region ID, name and timezone. Currently region IDs are only attached to Russian settlements; for foreign destinations use list_settlements instead. (RU: Список регионов России для уточнения географии.)

Find settlements (cities, towns, villages) by the beginning of their name, in Russian or in Latin ("Сочи", "Sochi", "Istanbul"). Returns settlement ID, localized + international name, type, region, country ID and name, and coordinates. Use the ID as settlementId and the country ID as countryId of search_tours. Only places of the supertours.ru directory are returned. (RU: Поиск населённых пунктов по началу названия.)

List all tour categories with ID and localized name. Use this to translate user phrases like "wine tasting" into tourCategoryIds filter for search_tours. (RU: Справочник категорий туров.)

Search tours and excursions on supertours.ru by destination, category, price range (currency-aware), duration (in HOURS), start time of day, activity level, private or group format, kids-allowed flag and free dates. Returns a paginated list with name, slug, prices, duration in minutes, settlement, country and the organizer's rating. With dateFrom/dateTo only tours that can be booked on a date of that period are returned, each with availableDates (up to three nearest dates with their free start times and seats left). Text matches in the tour name rank first. Use list_settlements and list_tour_categories to resolve names to IDs before filtering by ID. (RU: Поиск туров и экскурсий с фильтрами по городу, категории, цене, длительности, времени, активности и свободным датам.)