LastBilet — flight search

Найти город или аэропорт и его код IATA по названию (можно с опечатками, по-русски или по-английски). Возвращает аэропорты города и ближайшие аэропорты в радиусе 250 км — полезно, если в городе нет аэропорта (Паттайя, Анапа зимой) или из соседнего дешевле.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Название города или аэропорта"
    }
  },
  "required": [
    "query"
  ]
}

Живой поиск LastBilet на конкретные даты — как форма поиска на сайте: актуальные предложения авиакомпаний и агентств с багажом и ручной кладью, условиями возврата и обмена, пересадками (длительность, ночная, смена аэропорта, самостоятельная пересадка, нужна ли транзитная виза), самолётом и способами оплаты (карта, СБП). Занимает 10–30 секунд. Используй, когда известны даты; для «когда дешевле» и гибких дат сначала price_calendar или cheapest_prices. Ответ: сводка (минимальная цена, прямой, с багажом, самый быстрый) и варианты; у каждого offer_id для get_booking_link. Повтор того же поиска в течение 15 минут — из кэша, можно менять фильтры без нового поиска.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Город или аэропорт: код IATA (MOW, LED, SVO) или название по-русски/по-английски"
    },
    "destination": {
      "type": "string",
      "description": "Город или аэропорт: код IATA (MOW, LED, SVO) или название по-русски/по-английски"
    },
    "depart_date": {
      "type": "string",
      "description": "Дата вылета YYYY-MM-DD"
    },
    "return_date": {
      "type": "string",
      "description": "Дата обратно YYYY-MM-DD (для билета туда-обратно)"
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9,
      "default": 1,
      "description": "Взрослых (12+)"
    },
    "children": {
      "type": "integer",
      "minimum": 0,
      "maximum": 8,
      "default": 0,
      "description": "Детей 2–11 лет"
    },
    "infants": {
      "type": "integer",
      "minimum": 0,
      "maximum": 4,
      "default": 0,
      "description": "Младенцев до 2 лет (без места)"
    },
    "trip_class": {
      "type": "string",
      "enum": [
        "economy",
        "business"
      ],
      "default": "economy"
    },
    "direct_only": {
      "type": "boolean",
      "default": false,
      "description": "Только прямые рейсы"
    },
    "baggage_only": {
      "type": "boolean",
      "default": false,
      "description": "Только с багажом в цене"
    },
    "max_stops": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3,
      "description": "Не больше N пересадок"
    },
    "no_self_transfer": {
      "type": "boolean",
      "default": false,
      "description": "Без самостоятельных пересадок"
    },
    "no_night_transfer": {
      "type": "boolean",
      "default": false,
      "description": "Без ночных пересадок"
    },
    "depart_after": {
      "type": "string",
      "description": "Вылет не раньше HH:MM (местное время)"
    },
    "depart_before": {
      "type": "string",
      "description": "Вылет не позже HH:MM (местное время)"
    },
    "max_price": {
      "type": "integer",
      "description": "Не дороже, ₽ за всех пассажиров"
    },
    "sort": {
      "type": "string",
      "enum": [
        "price",
        "duration"
      ],
      "default": "price"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 8,
      "description": "Сколько вариантов вернуть"
    }
  },
  "required": [
    "origin",
    "destination",
    "depart_date"
  ]
}

Ссылка на покупку выбранного варианта из search_flights (на сайте агентства или авиакомпании). Действует ~15 минут после поиска; если устарела — вернётся ссылка на новый поиск на lastbilet.ru. Вызывай, когда пользователь выбрал вариант.

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "offer_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id",
    "offer_id"
  ]
}

Быстрые минимальные цены из кэша LastBilet (найдены пользователями за последние дни) на дату или месяц. Без destination — «куда дешево улететь» из города: лучшие цены по направлениям. Цены ориентировочные — точные и с багажом даст search_flights. Подходит для гибких дат, бюджета, вдохновения.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Город или аэропорт: код IATA (MOW, LED, SVO) или название по-русски/по-английски"
    },
    "destination": {
      "type": "string",
      "description": "Город или аэропорт: код IATA (MOW, LED, SVO) или название по-русски/по-английски"
    },
    "depart": {
      "type": "string",
      "description": "Дата YYYY-MM-DD или месяц YYYY-MM"
    },
    "return": {
      "type": "string",
      "description": "Дата или месяц возвращения (для туда-обратно)"
    },
    "direct_only": {
      "type": "boolean",
      "default": false
    },
    "max_price": {
      "type": "integer",
      "description": "Бюджет, ₽"
    },
    "abroad_only": {
      "type": "boolean",
      "default": false,
      "description": "Только за границу (для подборки направлений)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 10
    }
  },
  "required": [
    "origin",
    "depart"
  ]
}

Календарь минимальных цен по маршруту: с month — по дням месяца (самый дешёвый день, гибкие даты ±), без month — по месяцам на год вперёд. Данные из кэша LastBilet.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Город или аэропорт: код IATA (MOW, LED, SVO) или название по-русски/по-английски"
    },
    "destination": {
      "type": "string",
      "description": "Город или аэропорт: код IATA (MOW, LED, SVO) или название по-русски/по-английски"
    },
    "month": {
      "type": "string",
      "description": "Месяц YYYY-MM (по дням); не указывать — по месяцам"
    },
    "direct_only": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "origin",
    "destination"
  ]
}

Справка о городе назначения для туриста из России: нужна ли виза гражданам РФ (и можно ли по внутреннему паспорту), погода на даты поездки (прогноз до 16 дней) или климат месяца (средние за 5 лет, температура моря), разница во времени с Москвой, местная валюта и курс ЦБ к рублю.

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "Город или аэропорт: код IATA (MOW, LED, SVO) или название по-русски/по-английски"
    },
    "date_from": {
      "type": "string",
      "description": "Дата начала поездки YYYY-MM-DD"
    },
    "date_to": {
      "type": "string",
      "description": "Дата окончания YYYY-MM-DD"
    },
    "month": {
      "type": "string",
      "description": "Месяц YYYY-MM, если точных дат нет"
    }
  },
  "required": [
    "destination"
  ]
}