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

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

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

Пример ответа 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». Например, мы в шапке сайта группируем в выдаче экскурсии в блок «Популярные экскурсии»