ski-france.com Agent Search

Main apartment-level search for winter ski accommodation in French ski areas and ski resorts. Results are apartments, not whole accommodations. Put destination, ski area, ski resort or accommodation names into keywords. Use structured parameters for amenities, rooms, living space, slope distance, ski area size, parent areas, accommodation category, chalet type, pets and price sorting. Put the traveller count into partySize, not keywords. Use weekId and durationWeeks for one- or two-week price, availability, bookability and special-discount data.

{
  "type": "object",
  "properties": {
    "keywords": {
      "type": "string",
      "default": null,
      "description": "Natural-language destination or accommodation keywords, for example a ski resort, ski area, accommodation name or free text. Use the structured filter parameters for amenities and property requirements.",
      "maxLength": 120
    },
    "weekId": {
      "type": "integer",
      "default": null,
      "description": "Fixed weekly winter arrival date id from get_search_options. Required for week-specific price, availability, bookabilityStatus and special-discount comparison.",
      "minimum": 1
    },
    "partySize": {
      "type": "integer",
      "default": null,
      "description": "Traveller count. Results are restricted to apartments whose capacity is at least this party size within the matching website occupancy bucket.",
      "minimum": 1
    },
    "amenities": {
      "type": "array",
      "default": null,
      "description": "Amenity values from get_search_options.",
      "items": {
        "type": "string",
        "enum": [
          "sauna",
          "whirlpool",
          "steam-room",
          "pool",
          "chimney"
        ]
      },
      "uniqueItems": true
    },
    "durationWeeks": {
      "type": "integer",
      "default": 1,
      "description": "Stay duration in weeks. Two weeks requires weekId.",
      "enum": [
        1,
        2
      ]
    },
    "minBedrooms": {
      "type": "integer",
      "default": null,
      "description": "Minimum number of bedrooms. Value 8 means 8 or more.",
      "enum": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8
      ]
    },
    "minBathrooms": {
      "type": "integer",
      "default": null,
      "description": "Minimum number of bathrooms. Value 8 means 8 or more.",
      "enum": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8
      ]
    },
    "minSquareMeters": {
      "type": "integer",
      "default": null,
      "description": "Minimum living space in square metres.",
      "enum": [
        20,
        30,
        40,
        60,
        80,
        100,
        150,
        200
      ]
    },
    "maxDistanceToSlopeMeters": {
      "type": "integer",
      "default": null,
      "description": "Maximum distance to piste, lift or gondola in metres.",
      "enum": [
        100,
        400
      ]
    },
    "priceSort": {
      "type": "string",
      "default": "default",
      "description": "Result sorting. Status remains the primary order, followed by price and party-size category.",
      "enum": [
        "default",
        "price-desc",
        "price-asc"
      ]
    },
    "skiAreaSizes": {
      "type": "array",
      "default": null,
      "description": "Ski-area size categories from get_search_options.",
      "items": {
        "type": "string",
        "enum": [
          "small",
          "medium",
          "large"
        ]
      },
      "uniqueItems": true
    },
    "areas": {
      "type": "array",
      "default": null,
      "description": "Parent-area values from get_search_options.",
      "items": {
        "type": "string",
        "enum": [
          "northern-alps",
          "southern-alps",
          "pyrenees",
          "switzerland"
        ]
      },
      "uniqueItems": true
    },
    "accommodationCategories": {
      "type": "array",
      "default": null,
      "description": "Premium and luxury accommodation categories from get_search_options.",
      "items": {
        "type": "string",
        "enum": [
          "premium",
          "luxury"
        ]
      },
      "uniqueItems": true
    },
    "accommodationType": {
      "type": "string",
      "default": null,
      "description": "Optional accommodation type.",
      "enum": [
        "chalet"
      ]
    },
    "pets": {
      "type": "string",
      "default": null,
      "description": "Pet policy.",
      "enum": [
        "pets-allowed",
        "pets-not-allowed"
      ]
    },
    "entityType": {
      "type": "string",
      "default": null,
      "description": "Optional precise search-scope entity type from resolve_search_keywords. Use together with entityId to restrict results to a resolved parent region, ski area, ski resort, district or accommodation.",
      "enum": [
        "area",
        "region",
        "resort",
        "district",
        "accommodation"
      ]
    },
    "entityId": {
      "type": "integer",
      "default": null,
      "description": "Optional precise search-scope entity id from resolve_search_keywords. Use together with entityType.",
      "minimum": 1
    },
    "page": {
      "type": "integer",
      "default": 1,
      "description": "Result page, starting at 1.",
      "minimum": 1
    }
  }
}

Return the current structured search vocabulary before building a search: arrival weeks, one- or two-week durations, amenities, advanced apartment filters, price sorting, entity types and supported language subdomains. Use this first when you need valid parameter values.

{
  "type": "object",
  "properties": {}
}

Resolve a user phrase into concrete search-scope candidates such as parent regions, ski areas, ski resorts, districts or accommodations. Use the returned entityType and entityId in search_apartments when you want to restrict a later apartment search to a precise destination or accommodation. Broad searches can skip this and use keywords directly. Parent-region scopes are only for restricting searches, not for destination detail lookup.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search phrase to resolve into possible destination or accommodation scopes, for example \"Val Thorens\", \"3 Vallees\" or an accommodation name.",
      "minLength": 1,
      "maxLength": 120
    }
  },
  "required": [
    "query"
  ]
}

List public accommodations for catalogue discovery, optionally filtered by ski area, ski resort or district ids from the destination tools. This list intentionally has no prices, availability or bookability. Use search_apartments with weekId for price and availability comparison, and get_accommodation_detail after a result for accommodation context.

{
  "type": "object",
  "properties": {
    "skiAreaId": {
      "type": "integer",
      "default": null,
      "description": "Optional ski area id from list_ski_areas.",
      "minimum": 1
    },
    "skiResortId": {
      "type": "integer",
      "default": null,
      "description": "Optional ski resort id from list_ski_resorts.",
      "minimum": 1
    },
    "districtId": {
      "type": "integer",
      "default": null,
      "description": "Optional district id from accommodation or search-scope data.",
      "minimum": 1
    },
    "page": {
      "type": "integer",
      "default": 1,
      "description": "Result page, starting at 1.",
      "minimum": 1
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "description": "Results per page. Maximum is 200.",
      "minimum": 1,
      "maximum": 200
    }
  }
}

Return accommodation-level context, apartment list, images, detail information and weekly availability for one public accommodation. Use this after search results to inspect all apartments belonging to one accommodation and to explain location, descriptions and detail notes. For price and bookability comparison for a specific week, prefer search_apartments with weekId.

{
  "type": "object",
  "properties": {
    "accommodationId": {
      "type": "integer",
      "description": "Accommodation id from search results or list_accommodations.",
      "minimum": 1
    }
  },
  "required": [
    "accommodationId"
  ]
}

List public ski areas in France for destination discovery and comparison. A ski area groups one or more ski resorts and can be used as a destination scope for apartment search. Parent regions only bundle ski areas and do not have a separate detail endpoint.

{
  "type": "object",
  "properties": {}
}

Return public ski area information, facts, images, ski maps and related ski resorts. Use this for destination context and recommendations, not for apartment prices or availability; use search_apartments for live week-specific accommodation results.

{
  "type": "object",
  "properties": {
    "skiAreaId": {
      "type": "integer",
      "description": "Ski area id from list_ski_areas.",
      "minimum": 1
    }
  },
  "required": [
    "skiAreaId"
  ]
}

List public ski resorts in France for destination discovery, optionally filtered by ski area id. A ski resort is the local destination or village/resort used for accommodation search scopes and resort detail pages.

{
  "type": "object",
  "properties": {
    "skiAreaId": {
      "type": "integer",
      "default": null,
      "description": "Optional ski area id from list_ski_areas.",
      "minimum": 1
    }
  }
}

Return public ski resort information, location, facts, images and ski maps. Use this for explaining and comparing destinations, not for apartment prices or availability; use search_apartments for live week-specific accommodation results.

{
  "type": "object",
  "properties": {
    "skiResortId": {
      "type": "integer",
      "description": "Ski resort id from list_ski_resorts.",
      "minimum": 1
    }
  },
  "required": [
    "skiResortId"
  ]
}

Return ski pass weeks, durations and price tables with listPrice, discount and discountedPrice. Restrict by skiAreaId, skiResortId or accommodationId for destination-specific ski pass discovery. A global request without destination scope must provide weekId to avoid an overly broad price matrix. Omit durationDays to discover available durations with prices.

{
  "type": "object",
  "properties": {
    "skiAreaId": {
      "type": "integer",
      "default": null,
      "description": "Optional ski area id from list_ski_areas.",
      "minimum": 1
    },
    "skiResortId": {
      "type": "integer",
      "default": null,
      "description": "Optional ski resort id from list_ski_resorts.",
      "minimum": 1
    },
    "accommodationId": {
      "type": "integer",
      "default": null,
      "description": "Optional accommodation id from search_apartments, list_accommodations or get_accommodation_detail. Uses the accommodation ski resort.",
      "minimum": 1
    },
    "weekId": {
      "type": "integer",
      "default": null,
      "description": "Optional fixed weekly winter arrival date id. Required when no skiAreaId, skiResortId or accommodationId is provided. Omit it only for destination-scoped ski pass discovery.",
      "minimum": 1
    },
    "durationDays": {
      "type": "integer",
      "default": null,
      "description": "Optional ski pass duration in days. Omit it to return all available durations with prices. Default website duration is 6 days.",
      "minimum": 1
    },
    "page": {
      "type": "integer",
      "default": 1,
      "description": "Result page, starting at 1.",
      "minimum": 1
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "description": "Results per page. Maximum is 50.",
      "minimum": 1,
      "maximum": 50
    }
  }
}