categorystring
Слаг категории, например, "theatre", "tours", "museums", "attractions".
citystring
Слаг города, например "london", "new-york", "paris".
formatenum
Форма ответа. 'json' возвращает структурированные записи; 'text' возвращает тот же контент, отрендеренный как короткий повествовательный абзац для чат-интерфейсов.
indoor_outdoorenum
Настройка фильтра. Значения 'indoor' / 'outdoor' определяются по столбцу products.tags (в каталоге помечено около 2 100 товаров indoor и около 5 000 товаров outdoor). Значение 'either' не применяет фильтр.
languagestring
Код языка BCP-47 для человекочитаемых полей (например, 'en', 'fr-FR'). Если не указан, по умолчанию английский.
limitinteger
Количество результатов для возврата (1-20, по умолчанию 10)
max_pricenumber
Максимальная цена за человека в указанной валюте. Положительное значение задаёт потолок цены; 0 (или не задано) - потолка цены нет (без ограничения).
min_ratingnumber
Минимальный агрегированный рейтинг по шкале от 0 до 5.
min_review_countinteger
Минимальное количество отзывов покупателей. Используйте, чтобы отсеять новые товары или товары с малым числом отзывов.
popular_onlyboolean
УСТАРЕЛО: используйте restrict_to_top_rated. Псевдоним для жёсткого фильтра результатов с высоким рейтингом (rating >= 4.5 AND review_count >= 100). Название намекает на подсказку по сортировке, но это жёсткое условие WHERE. Существующий вызывающий код продолжает работать без изменений.
querystring
Текстовый запрос в свободной форме, который сопоставляется с названием впечатления и площадкой (не с описанием). Разбивается на слова, и все они должны совпасть, поэтому подходит для заголовка или ключевого слова; запрос, который не совпал ни с одним названием, возвращает городские топ-подборки с пометкой match_type "fallback_city_ranked".
restrict_to_top_ratedboolean
HARD RESULT FILTER. Когда true, ограничивает результаты товарами с rating >= 4.5 AND review_count >= 100. Это условие WHERE, а не подсказка сортировки. Всё, что не проходит порог, полностью исключается из набора результатов. Используйте только когда вызывающий действительно хочет исключить товары с низким рейтингом или малым числом отзывов. Для ранжирования по популярности без исключения не задавайте этот параметр; результаты уже упорядочены по рейтингу и числу отзывов.
tagsstring[]
Фильтрует по тегам впечатлений. Несколько тегов объединяются по AND (каждый тег должен совпасть), поэтому добавление тегов сужает набор результатов. Использует формы в нижнем регистре и единственном числе; совпадение ищется по подстроке в массиве тегов. Каноническая таксономия тегов в каталоге, упорядоченная по частоте: 'tour', 'attraction', 'historical', 'outdoor', 'museum', 'family', 'landmark', 'adventure', 'show', 'indoor', 'food & drink', 'transport', 'theatre', 'concert', 'theme park', 'cruise', 'nightlife', 'comedy', 'musical', 'city pass', 'sport', 'dance', 'aquarium', 'zoo', 'gallery', 'opera', 'wellness', 'water park', 'workshop', 'religious', 'festival'. Примеры: ['museum'] для музеев; ['family','indoor'] для семейных достопримечательностей в помещении; ['outdoor','adventure'] для приключенческих активностей на открытом воздухе. Другие значения в свободной форме могут совпасть по подстроке, но без гарантии.