Автокомплит городов и стран

API позволяет искать по сайту страны, города, рубрики и экскурсии текстовым запросом. Для получения данных используйте метод https://experience.tripster.ru/api/partners/{partnername}/search/site/

Параметры запроса

  • Параметры

    • query текст запроса

      • limit кол-во результатов (16 значений по умолчанию)

    • types фильтр по типам объектов. Строка с запятой в качестве разделителя. Возможные значения:

      • country (страны)

      • city (города)

      • citytag (рубрики)

      • experience (экскурсии и туры)

Структура ответа

Пример ответа API
[ { "id": 130, "type": "country", "title": "Франция", "url": "https://experience.tripster.ru/destinations/france/", "score": 18.00821763664043, "experience_count": 281 }, { "id": 3, "type": "city", "title": "Париж", "url": "https://experience.tripster.ru/experience/Paris/", "score": 16.854508934275433, "experience_count": 224, "country": { "id": 130, "name_ru": "Франция" } }, { "id": 310, "type": "citytag", "title": "Обзорные", "url": "https://experience.tripster.ru/experience/Paris/310-obzornyie/", "score": 10.360534288774225, "experience_count": 39, "city": { "id": 3, "name_ru": "Париж", "country": { "id": 130, "name_ru": "Франция" } } }, { "id": 13216, "type": "experience", "title": "Главные сокровища Лувра за 2 часа", "url": "https://experience.tripster.ru/experience/13216/", "score": 8.832400703069453, "price": "от €35", "image": "https://experience-ireland.s3.amazonaws.com/thumbs2/f94a627c-73f7-11e8-87e2-6e714efd800d.384x289.jpg", "city": { "id": 3, "name_ru": "Париж", "country": { "id": 130, "name_ru": "Франция" } } } ]

Описание ответа

Параметр

Описание

Тип

id

ID экскурсии в Трипстере

Число

type

Тип объекта: country, city, citytag, experience

Строка

title

Название объекта

Строка

url

Ссылка на страницу на Трипстере

Строка

score

Рейтинг — релевантность объекта поиска в выдаче

Число

experience_count

Число экскурсий в рубрике, городе или стране

Число

city

Объект с данными о городе

Объект

city.id

ID города в Трипстере

Число

city.name_ru

Название города на русском

Строка

country

Объект с данными о стране

Объект

country.id 

ID страны в Трипстере

Число

country.name_ru

Название страны на русском

Строка

price

Минимальная цена за экскурсию

Число

image

Картинка экскурсии в виде превью

Строка

Примеры использования

  • Поисковый запрос без параметров отдает самые популярные города: https://experience.tripster.ru/api/partners/{partnername}/search/site/

  • Можно в реальном времени отправлять запросы при вводе пользователем в поисковое поле слова "париж": п, па, пар, пари, париж

  • Выдачу можно группировать на своей стороне по типам «types». Например, мы в шапке сайта группируем в выдаче экскурсии в блок «Популярные экскурсии»