TrustedVillas Villa Rentals

Search self-catering villa rentals with real-time availability. Filter by destination, check-in/check-out dates, guests, bedrooms, and amenities (pool, pet-friendly, sea view, wifi, parking, air conditioning). Returns matching villas with nightly price and a link to book. Always pass checkIn, checkOut, and guests when the user has specified dates and party size.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Country name in English, e.g. \"Spain\", \"France\", \"Italy\"."
    },
    "area": {
      "type": "string",
      "description": "Region or area, e.g. \"Costa del Sol\", \"Tuscany\", \"Algarve\"."
    },
    "location": {
      "type": "string",
      "description": "Town or resort name, e.g. \"Marbella\", \"Positano\", \"Lagos\"."
    },
    "checkIn": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date (YYYY-MM-DD). Required for availability filtering."
    },
    "checkOut": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date (YYYY-MM-DD). Required with checkIn."
    },
    "guests": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Total number of guests including children."
    },
    "bedrooms": {
      "type": "integer",
      "minimum": 1,
      "description": "Minimum number of bedrooms required."
    },
    "pool": {
      "type": "boolean",
      "description": "Private swimming pool required."
    },
    "petFriendly": {
      "type": "boolean",
      "description": "Pets accepted."
    },
    "seaView": {
      "type": "boolean",
      "description": "Sea or ocean view required."
    },
    "wifi": {
      "type": "boolean",
      "description": "WiFi required."
    },
    "parking": {
      "type": "boolean",
      "description": "On-site parking required."
    },
    "airCon": {
      "type": "boolean",
      "description": "Air conditioning required."
    },
    "minPrice": {
      "type": "integer",
      "minimum": 0,
      "description": "Minimum nightly price in GBP."
    },
    "maxPrice": {
      "type": "integer",
      "minimum": 0,
      "description": "Maximum nightly price in GBP."
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "price_asc",
        "price_desc",
        "bedrooms_asc",
        "bedrooms_desc"
      ],
      "default": "relevance",
      "description": "Result ordering."
    },
    "pageSize": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from a previous response."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get full details for a specific villa including description, all photos, amenities, house rules, and check-in/check-out times. Call this when the user wants more information about a property found via search_villas.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "pattern": "^IH-\\d+$",
      "description": "Interhome accommodation code from a search result, e.g. \"IH-123456\"."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check real-time availability and nightly pricing for a specific villa over a date range. Returns whether the property is available and the average nightly rate. For a binding total price including all fees and taxes, use get_quote.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "pattern": "^IH-\\d+$",
      "description": "Interhome accommodation code."
    },
    "checkIn": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date (YYYY-MM-DD)."
    },
    "checkOut": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date (YYYY-MM-DD). Must be after checkIn."
    }
  },
  "required": [
    "code",
    "checkIn",
    "checkOut"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a binding price quote for a villa stay including full breakdown of accommodation cost, cleaning fee, tourist tax, and security deposit. Always use this for final price — never estimate or calculate prices manually. Provides a direct booking link with dates pre-filled.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "pattern": "^IH-\\d+$",
      "description": "Interhome accommodation code."
    },
    "checkIn": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date (YYYY-MM-DD)."
    },
    "checkOut": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date (YYYY-MM-DD)."
    },
    "guests": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Total number of guests."
    }
  },
  "required": [
    "code",
    "checkIn",
    "checkOut",
    "guests"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}