Оформление

Список туров ​

Для поиска туров используйте метод https://toursystema.com/org-api/tour/list

✅ Поддерживается постраничная выборка

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

Пример
json
{
  "pagination": {
    "current_page": 1,
    "total_pages": 1925,
    "total_items": 1925,
    "per_page": 1
  },
  "data": [
    {
      "id": 918,
      "image": "",
      "title": "Легенды Карелии. Тур-актив",
      "description": "<p>Уникальная возможность увидеть главные природные и рукотворные достопримечательности Карелии, совмещая насыщенную активную программу с комфортным отдыхом. Размещение в номерах с удобствами/частичными удобствами на турбазах на несложном, познавательном маршруте по Карелии станет отличным вариантом для семейного отпуска, включая детей старше 10 лет. При этом активный тур комбинированного типа позволит попробовать свои силы в разных видах туризма.</p>",
      "currency": "RUB",
      "price": 11,
      "countries": [
        {
          "id": 4,
          "name": "Россия"
        }
      ],
      "regions": [
        {
          "id": 7,
          "name": "Карелия"
        }
      ],
      "host_cities": [
        {
          "id": 350,
          "name": "Петрозаводск",
          "code": ""
        }
      ],
      "main_location": "region",
      "main_location_name": "Карелия",
      "rest_kinds": [
        {
          "id": 21,
          "name": "Пешие походы"
        },
        {
          "id": 33,
          "name": "Сплавы"
        }
      ],
      "collections": [
        {
          "id": 11,
          "name": "Отдых с детьми"
        },
        {
          "id": 45,
          "name": "Корпоративные туры"
        }
      ],
      "nearest_variant": {
        "id": 2117845,
        "start": "2024-10-08",
        "end": "2024-10-17",
        "price": 50,
        "is_busy": false,
        "not_guaranteed": false,
        "tour_id": 918
      },
      "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": 24601,
          "name": "Осенние легенды Карелии",
          "use_request_period": false,
          "is_dates_preliminary": true
        },
        {
          "tour_id": 76210,
          "name": "Легенды Карелии",
          "use_request_period": false,
          "is_dates_preliminary": true
        }
      ],
      "variants": [
        {
          "id": 2117845,
          "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": 5820,
            "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": 2117846,
          "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": 918
        },
        {
          "id": 2117847,
          "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": 918
        },
        {
          "id": 2098234,
          "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": 76210
        }
      ],
      "discounts": [
        {
          "id": 5799,
          "name": "Скидка за раннее бронирование до указанной даты",
          "type": 1,
          "size": 5,
          "format": {
            "id": 1,
            "name": "Currency"
          },
          "conditions": "",
          "start_date": null,
          "end_date": "2025-07-31",
          "count_days": 0
        },
        {
          "id": 5820,
          "name": "Сезонная скидка",
          "type": 3,
          "size": 40,
          "format": {
            "id": 2,
            "name": "%"
          },
          "conditions": null,
          "start_date": "2025-04-30",
          "end_date": "2025-05-29",
          "count_days": 0
        }
      ]
    }
  ]
}

Описание ответа ​

ПараметрНазначениеТип данных
idID тура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Активные скидки в туреСписок объектов скидка

Описание объекта "Регион"

ПараметрОписаниеТип
idID регионаinteger
nameНазваниеstring

Описание объекта "Город"

ПараметрОписаниеТип
idID городаinteger
nameНазваниеstring

Описание объекта "Вид отдыха"

ПараметрОписаниеТип
idID вида отдыхаinteger
nameНазваниеstring

Описание объекта "Коллекция"

ПараметрОписаниеТип
idID коллекцииinteger
nameНазваниеstring

Описание объекта "Достопримечательность"

ПараметрОписаниеТип
idID коллекцииinteger
nameНазваниеstring

Описание объекта "Дата заезда"

ПараметрОписаниеТип
idID датыinteger
startДата начала заездаstring
endДата окончания заездаstring
priceСтоимостьinteger
is_busyДаты занятыboolean
not_guaranteedДаты не гарантированыboolean
tour_idID тураinteger | null
discountСкидка на заездОбъект скидка

Описание объекта "Язык"

ПараметрОписаниеТип
nameНазваниеstring
codeНазваниеstring

Описание объекта "Проживание"

ПараметрОписаниеТип
nightsКоличество ночейinteger
variantsВарианты проживанияСписок объектов вариантов проживания

Описание объекта "Объект варианта проживания"

ПараметрОписаниеТип
typeТипstring
titleНазваниеstring | null
descriptionОписаниеstring | null
imagesМассив ссылок на изображенияstring[]

Описание объекта "Вид отдыха"

ПараметрОписаниеТип
idIDinteger
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_idID тураinteger
nameНазвание тураstring
use_request_periodТур может проводиться по запросуboolean
is_dates_preliminaryДаты предварительныеboolean

Описание объекта "Скидка"

ПараметрОписаниеТип
idID скидки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%