Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

Table of Contents

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

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

  • Параметры

    • query

...

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

      • limit

...

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

    • types

...

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

      • country —

...

...

...

...

...

Excerpt

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

Пример ответа API
Code Block
languagejs
titleПример ответа 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

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

Число

/wiki/spaces/affiliates/pages/1043169281

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

Объект

city.id

ID

...

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

Число

city.name_ru

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

Строка

/wiki/spaces/affiliates/pages/1042972673

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

Объект

country.

...

id 

ID

...

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

Число

country.name_ru

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

Строка

price

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

Число

image

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

Строка

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

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

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

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