API позволяет искать по сайту страны, города, рубрики и экскурсии текстовым запросом. Для получения данных используйте метод https://experience.tripster.ru/api/search/site/?query=пар
Параметры запроса
Параметры
query текст запроса
limit кол-во результатов (16 значений по умолчанию)
types фильтр по типам объектов. Строка с запятой в качестве разделителя. Возможные значения:
country — /wiki/spaces/affiliates/pages/1042972673
citytag — /wiki/spaces/affiliates/pages/1043136516
experience — /wiki/spaces/affiliates/pages/1043169285
Структура ответа
Пример ответа 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 | Число экскурсий в рубрике, городе или стране | Число |
Объект с данными о городе | Объект | |
ID города в Трипстере | Число | |
city.name_ru | Название города на русском | Строка |
Объект с данными о стране | Объект | |
ID страны в Трипстере | Число | |
country.name_ru | Название страны на русском | Строка |
price | Минимальная цена за экскурсию | Число |
image | Картинка экскурсии в виде превью | Строка |
Примеры использования
Поисковый запрос без параметров отдает самые популярные города: https://experience.tripster.ru/api/search/site/
Можно в реальном времени отправлять запросы при вводе пользователем в поисковое поле слова "париж": п, па, пар, пари, париж
Выдачу можно группировать на своей стороне по типам «types». Например, мы в шапке сайта группируем в выдаче экскурсии в блок «Популярные экскурсии»