Premium cruise fares

Describe the latest published crawl: crawl date, row count, and the real line, source, ship, and rate values. Call this before search_rates when an exact line, source, or ship name is unknown. Prices are not converted between currencies.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search the latest published cruise fares. This is the full crawl, including Contitrans and Crusit. Empty line, source, ship, or rate means all of that dimension. Values within one of those filters are OR; filters combine with AND. title, line, source, ship, rate, and sort ignore case. title is a substring. line, source, and ship must otherwise match describe_rates. nights, price, and ppd are inclusive min-max strings such as "8-14". departs is inclusive YYYY-MM-DD..YYYY-MM-DD. sort is field:asc or field:desc, comma-separated. Sort fields are title, cruiseline (line), source_label (source), ship, date, number_of_days (nights), lowest_price (price), price_per_day (ppd), and comment (rate). The default sort is Ultra, then All included, then Economy, then cheapest per night. Each row's price stays in its own currency.

{
  "type": "object",
  "properties": {
    "title": {
      "description": "Case-insensitive substring of the sailing name.",
      "type": "string"
    },
    "line": {
      "description": "Cruise line names. Case-insensitive. Comma-separated or a list.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "source": {
      "description": "Source ids such as celebrity or contitrans. Case-insensitive.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "ship": {
      "description": "Ship names. Case-insensitive.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "rate": {
      "description": "Economy, All included, and/or Ultra.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "nights": {
      "description": "Inclusive night range, such as \"8-14\".",
      "type": "string"
    },
    "departs": {
      "description": "Inclusive departure range, such as \"2027-01-01..2027-06-01\".",
      "type": "string"
    },
    "price": {
      "description": "Inclusive total price range in the row currency, such as \"1500-4000\".",
      "type": "string"
    },
    "ppd": {
      "description": "Inclusive price-per-night range, such as \"150-300\".",
      "type": "string"
    },
    "sort": {
      "description": "Sort such as \"date:desc\" or \"ppd:asc\". Several fields are comma-separated.",
      "type": "string"
    },
    "limit": {
      "description": "Page size. Default 25, maximum 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Matching rows to skip. Default 0.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}