Оформление
Список туров
Для поиска туров используйте метод 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": 544
},
{
"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
}
]
}
]
}
Описание ответа
Параметр | Назначение | Тип данных |
---|---|---|
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 | Даты заездов тура и даты вариантов этого тура | Список объектов дат заезда |
Описание объекта "Регион"
Параметр | Описание | Тип |
---|---|---|
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 |
Описание объекта "Язык"
Параметр | Описание | Тип |
---|---|---|
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 |