Оформление
Список туров
Для поиска туров используйте метод https://toursystema.com/org-api/tour/list
✅ Поддерживается постраничная выборка
Структура ответа
Пример
json
{
"pagination": {
"current_page": 1,
"total_pages": 1925,
"total_items": 1925,
"per_page": 1
},
"data": [
{
"id": 544,
"image": "https://i.cdnpic.net/{{size}}/4b/39/4b3900dd3258f23a6348bb5572fd684a.jpeg",
"title": "Калейдоскоп Алтая. Тур-комфорт",
"description": "<p>Уникальный шанс увидеть огромное количество природных и созданных людьми достопримечательностей Горного Алтая, практически не отказывая себе в комфортном отдыхе. Возможность размещаться в номерах с удобствами/частичными удобствами на базах отдыха на легком, обзорном маршруте по Республике Алтай станет прекрасным вариантом для того, чтобы провести отпуск всей семьёй, включая детей старше 10 лет. В то же время этот активный тур комбинированного типа позволит попробовать свои силы в различных видах туризма.</p>",
"currency": "RUB",
"price": 11,
"countries": [
{
"id": 1,
"name": "Россия"
}
],
"regions": [
{
"id": 1,
"name": "Алтай"
}
],
"host_cities": [
{
"id": 214,
"name": "Железногорск",
"code": ""
}
],
"main_location": "region",
"main_location_name": "Алтай",
"rest_kinds": [
{
"id": 16,
"name": "Конные туры"
},
{
"id": 8,
"name": "Сплавы"
}
],
"collections": [
{
"id": 6,
"name": "Отдых с детьми"
},
{
"id": 23,
"name": "Корпоративные туры"
}
],
"nearest_variant": {
"id": 1009669,
"start": "2024-10-08",
"end": "2024-10-17",
"price": 50,
"is_busy": false,
"not_guaranteed": false,
"tour_id": 544
},
"min_age": 7,
"max_age": null,
"difficulty": 2,
"duration": 10,
"languages": [
{
"name": "Русский",
"code": "ru"
}
],
"reviews_count": 1,
"rating": 4,
"seasons": [
"autumn",
"winter",
"summer"
],
"accommodation": [
{
"camp-site": 8
},
{
"hotel": 1
}
],
"is_comfort_base": false,
"is_comfort_base_plus": true,
"is_comfort_medium": false,
"is_comfort_improved": false,
"is_comfort_premium": false,
"main_activity": {
"name": "Беговые туры",
"screen_name": null,
"type": "collection"
},
"is_very_hot": false,
"use_request_period": false,
"request_period_start": null,
"request_period_end": null,
"is_dates_preliminary": true,
"tour_variants": [
{
"tour_id": 17511,
"name": "Калейдоскоп осеннего Алтая",
"use_request_period": false,
"is_dates_preliminary": true
},
{
"tour_id": 55256,
"name": "Калейдоскоп Алтая",
"use_request_period": false,
"is_dates_preliminary": true
}
],
"variants": [
{
"id": 1009669,
"start": "2024-10-08",
"end": "2024-10-17",
"price": 50,
"is_busy": false,
"flight_included": false,
"not_guaranteed": false,
"prepayment_type": null,
"full_payment_days": null,
"prepayment_size": null,
"number_of_seats": 14,
"number_of_free_seats": 14,
"tour_id": null,
"discount": {
"id": 3463,
"name": "Скидка на заезд",
"type": 3,
"size": 40,
"format": {
"id": 2,
"name": "%"
},
"conditions": null,
"start_date": "2025-04-30",
"end_date": "2025-05-29",
"count_days": 0
}
},
{
"id": 1009672,
"start": "2024-12-21",
"end": "2024-12-30",
"price": 11,
"is_busy": false,
"flight_included": false,
"not_guaranteed": false,
"prepayment_type": null,
"full_payment_days": null,
"prepayment_size": null,
"number_of_seats": 14,
"number_of_free_seats": 14,
"tour_id": 544
},
{
"id": 1009673,
"start": "2024-12-25",
"end": "2025-01-08",
"price": 11,
"is_busy": false,
"flight_included": false,
"not_guaranteed": false,
"prepayment_type": {
"id": 2,
"name": "%"
},
"full_payment_days": 3,
"prepayment_size": 30,
"number_of_seats": 30,
"number_of_free_seats": 30,
"tour_id": 544
},
{
"id": 1005108,
"start": "2025-05-30",
"end": "2025-06-08",
"price": 67000,
"is_busy": false,
"flight_included": false,
"not_guaranteed": true,
"prepayment_type": null,
"full_payment_days": null,
"prepayment_size": null,
"number_of_seats": null,
"number_of_free_seats": null,
"tour_id": 55256
}
],
"discounts": [
{
"id": 3385,
"name": "Скидка за раннее бронирование до указанной даты",
"type": 1,
"size": 5,
"format": {
"id": 1,
"name": "Currency"
},
"conditions": "",
"start_date": null,
"end_date": "2025-07-31",
"count_days": 0
},
{
"id": 3463,
"name": "Сезонная скидка",
"type": 3,
"size": 40,
"format": {
"id": 2,
"name": "%"
},
"conditions": null,
"start_date": "2025-04-30",
"end_date": "2025-05-29",
"count_days": 0
}
]
}
]
}Описание ответа
| Параметр | Назначение | Тип данных |
|---|---|---|
| id | ID тура | integer |
| image | Ссылка на фотографию обложки тура | string |
| title | Заголовок | string |
| description | Описание | string |
| currency | Валюта тура | string |
| price | Стоимость | float |
| countries | Список стран тура | Список объектов стран |
| regions | Список регионов тура | Список объектов регионов |
| host_cities | Список городов тура | Список объектов городов |
| main_location | Тип основной локации тура | "country" | "region" | "city" |
| main_location_name | Название основной локации тура | string |
| rest_kinds | Список видов отдыха (активностей) тура | Список объектов коллекци |
| collections | Список коллекций тура | Список объектов видов отдыха |
| nearest_variant | Дата ближайшего заезда | Объект дат заезда |
| min_age | Минимальный возраст туриста | integer | null |
| max_age | Максимальный возраст туриста | integer | null |
| difficulty | Уровень сложности тура | integer |
| duration | Количество дней | integer |
| languages | Список языков тура | Список объектов языков тура |
| reviews_count | Число отзывов | integer |
| rating | Оценка тура | float | null |
| seasons | Список названий сезонов тура | string[] |
| accommodation | Варианты проживаний по дням | Список объектов проживаний |
| is_comfort_base | Базовый уровень комфорта (палатки, кемпинги) | boolean |
| is_comfort_base_plus | Простой уровень комфорта (гостевые дома) | boolean |
| is_comfort_medium | Средний уровень комфорта (апартаменты, коттеджи) | boolean |
| is_comfort_improved | Уровень комфорта выше среднего (виллы, лоджи) | boolean |
| is_comfort_premium | Высокий уровень комфорта (глэмпинги, бутик-отели) | boolean |
| main_activity | Главная активность | null или Объект главной активности |
| is_very_hot | Горящий тур (в туре есть даты с приоритетным набором) | boolean |
| use_request_period | Тур может проводиться по запросу в течение указанного периода | boolean | null |
| request_period_start | Начало периода под запрос | string | null |
| request_period_end | Окончание периода под запрос | string | null |
| is_dates_preliminary | Даты тура предварительные | boolean |
| tour_variants | Варианты туров | Список объектов вариантов туров |
| variants | Даты заездов тура и даты вариантов этого тура | Список объектов дат заезда |
| discounts | Активные скидки в туре | Список объектов скидка |
Описание объекта "Регион"
| Параметр | Описание | Тип |
|---|---|---|
| id | ID региона | integer |
| name | Название | string |
Описание объекта "Город"
| Параметр | Описание | Тип |
|---|---|---|
| id | ID города | integer |
| name | Название | string |
Описание объекта "Вид отдыха"
| Параметр | Описание | Тип |
|---|---|---|
| id | ID вида отдыха | integer |
| name | Название | string |
Описание объекта "Коллекция"
| Параметр | Описание | Тип |
|---|---|---|
| id | ID коллекции | integer |
| name | Название | string |
Описание объекта "Достопримечательность"
| Параметр | Описание | Тип |
|---|---|---|
| id | ID коллекции | integer |
| name | Название | string |
Описание объекта "Дата заезда"
| Параметр | Описание | Тип |
|---|---|---|
| id | ID даты | integer |
| start | Дата начала заезда | string |
| end | Дата окончания заезда | string |
| price | Стоимость | integer |
| is_busy | Даты заняты | boolean |
| not_guaranteed | Даты не гарантированы | boolean |
| tour_id | ID тура | integer | null |
| discount | Скидка на заезд | Объект скидка |
Описание объекта "Язык"
| Параметр | Описание | Тип |
|---|---|---|
| name | Название | string |
| code | Название | string |
Описание объекта "Проживание"
| Параметр | Описание | Тип |
|---|---|---|
| nights | Количество ночей | integer |
| variants | Варианты проживания | Список объектов вариантов проживания |
Описание объекта "Объект варианта проживания"
| Параметр | Описание | Тип |
|---|---|---|
| type | Тип | string |
| title | Название | string | null |
| description | Описание | string | null |
| images | Массив ссылок на изображения | string[] |
Описание объекта "Вид отдыха"
| Параметр | Описание | Тип |
|---|---|---|
| id | ID | integer |
| name | Название | string | null |
| is_active | Активный | boolean |
| is_excursion | Экскурсия | boolean |
| url | Ссылка | string | null |
| photo | Ссылка на изображение | string | null |
Описание объекта "Главная активность"
| Параметр | Описание | Тип |
|---|---|---|
| name | Название | string | null |
| type | Тип | string (rest_kind или collection) |
Описание объекта "Основное впечатление"
| Параметр | Описание | Тип |
|---|---|---|
| title | Название | string | null |
| description | Описание | string | null |
| image | Ссылка на изображение | string | null |
Описание объекта "Вариант тура"
| Параметр | Описание | Тип |
|---|---|---|
| tour_id | ID тура | integer |
| name | Название тура | string |
| use_request_period | Тур может проводиться по запросу | boolean |
| is_dates_preliminary | Даты предварительные | boolean |
Описание объекта "Скидка"
| Параметр | Описание | Тип |
|---|---|---|
| id | ID скидки | integer |
| name | Название скидки | string |
| type | Тип скидки | integer |
| size | Размер скидки | float |
| format | Формат скидки | {"id": int, "name": string} |
| conditions | Условия скидки | string |
| start_date | Дата начала действия скидки | string |
| end_date | Дата окончания действия скидки | string |
| count_days | Количество дней до начала тура | integer |
Описание параметра "Тип скидки"
| Значение | Описание |
|---|---|
| 1 | Скидка за раннее бронирование до указанной даты |
| 2 | Скидка за раннее бронирование до установленного количества дней до даты тура |
| 3 | Сезонная скидка |
| 4 | Скидка на заезд |
Описание параметра "Формат скидки"
| Значение | Описание |
|---|---|
| 1 | Валюта |
| 2 | % |