Previous value: -"Free-text query matched against experience name and venue (not description). Split into words that must all match, so it is best for a title or keyword; a query that matches no name returns city top-picks flagged match_type \"fallback_city_ranked\"."New value: +"Free-text query matched against experience name and venue (not description). Split into words that must all match, so it suits a title or keyword; a query that matches no name returns city top-picks flagged match_type \"fallback_city_ranked\"."

Added value: +{
+  "additionalProperties": true,
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": true,
+  "type": "object"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "items": {
+    "additionalProperties": true,
+    "properties": {
+      "booking_url": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "category": {
+        "type": "string"
+      },
+      "city": {
+        "type": "string"
+      },
+      "description": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "image_url": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "name": {
+        "type": "string"
+      },
+      "price": {
+        "additionalProperties": true,
+        "properties": {
+          "amount_minor": {
+            "type": "integer"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "display": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "product_id": {
+        "description": "Stable experience identifier for detail, availability, related-experience, and card-rendering calls.",
+        "type": "string"
+      },
+      "rating": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "review_count": {
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "slug": {
+        "type": "string"
+      },
+      "tags": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "venue": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "product_id",
+      "name"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "integer"
+}

Added value: +{
+  "type": "string"
+}

Removed value: -"Ranked bookable experiences."

Removed value: -"Display name of the experience."

Previous value: -"Stable identifier for this experience. Pass these values into render_experience_cards (experience_ids) to show the results as visual cards."New value: +"Stable experience identifier for detail, availability, related-experience, and card-rendering calls."

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Previous value: -"Free-text query matched against title, venue, and description."New value: +"Free-text query matched against experience name and venue (not description). Split into words that must all match, so it is best for a title or keyword; a query that matches no name returns city top-picks flagged match_type \"fallback_city_ranked\"."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "pagination": {
+      "additionalProperties": true,
+      "properties": {
+        "limit": {
+          "type": "integer"
+        },
+        "total": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "results": {
+      "description": "Ranked bookable experiences.",
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "booking_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "category": {
+            "type": "string"
+          },
+          "city": {
+            "type": "string"
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "image_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "name": {
+            "description": "Display name of the experience.",
+            "type": "string"
+          },
+          "price": {
+            "additionalProperties": true,
+            "properties": {
+              "amount_minor": {
+                "type": "integer"
+              },
+              "currency": {
+                "type": "string"
+              },
+              "display": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "product_id": {
+            "description": "Stable identifier for this experience. Pass these values into render_experience_cards (experience_ids) to show the results as visual cards.",
+            "type": "string"
+          },
+          "rating": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "review_count": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "slug": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "product_id",
+          "name"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

Previous value: -"DEPRECATED — use restrict_to_top_rated. Alias for the destructive top-rated filter (rating >= 4.5 AND review_count >= 100). The name implies a sort hint but it is a hard WHERE clause. Existing callers continue to work unchanged."New value: +"DEPRECATED: use restrict_to_top_rated. Alias for the destructive top-rated filter (rating >= 4.5 AND review_count >= 100). The name implies a sort hint but it is a hard WHERE clause. Existing callers continue to work unchanged."

Previous value: -"DESTRUCTIVE FILTER. When true, hard-restricts results to products with rating >= 4.5 AND review_count >= 100. This is a WHERE clause, not a sort hint — anything failing the floor is dropped from the result set entirely. Use only when the caller genuinely wants to exclude lower-rated or lesser-reviewed products. For ranking-by-popularity without exclusion, do not set this; results are already ordered by rating and review count."New value: +"DESTRUCTIVE FILTER. When true, hard-restricts results to products with rating >= 4.5 AND review_count >= 100. This is a WHERE clause, not a sort hint. Anything failing the floor is dropped from the result set entirely. Use only when the caller genuinely wants to exclude lower-rated or lesser-reviewed products. For ranking-by-popularity without exclusion, do not set this; results are already ordered by rating and review count."

Previous value: -"Maximum price per person in the listed currency."New value: +"Maximum price per person in the listed currency. A positive value applies a cap; 0 (or unset) means no price cap (unbounded)."

Added value: +true

Previous value: -"When true, restricts results to products that meet the popular threshold (4.5+ rating with 100+ reviews)."New value: +"DEPRECATED — use restrict_to_top_rated. Alias for the destructive top-rated filter (rating >= 4.5 AND review_count >= 100). The name implies a sort hint but it is a hard WHERE clause. Existing callers continue to work unchanged."

Added value: +{
+  "description": "DESTRUCTIVE FILTER. When true, hard-restricts results to products with rating >= 4.5 AND review_count >= 100. This is a WHERE clause, not a sort hint — anything failing the floor is dropped from the result set entirely. Use only when the caller genuinely wants to exclude lower-rated or lesser-reviewed products. For ranking-by-popularity without exclusion, do not set this; results are already ordered by rating and review count.",
+  "type": "boolean"
+}

Removed value: -{
-  "description": "Target audience. Currently 'family' is the strongest signal in the catalogue (resolves via the 'family' tag, ~3,200 products). Other values are best-effort and may be sparsely populated; for guaranteed family-suitable results prefer tags=['family'] in addition to or instead of this filter.",
-  "enum": [
-    "family",
-    "couple",
-    "solo",
-    "group",
-    "business"
-  ],
-  "type": "string"
-}

Previous value: -"Setting filter for weather-aware searches. Note: dedicated indoor/outdoor enrichment data is sparse; if this filter returns no results, fall back to tags=['indoor'] or tags=['outdoor'] which are well-populated in the tag taxonomy (~2,100 indoor and ~5,000 outdoor products)."New value: +"Setting filter. 'indoor' / 'outdoor' resolve via the products.tags column (~2,100 indoor and ~5,000 outdoor products are tagged in the catalogue). 'either' applies no filter."

Removed value: -{
-  "description": "Physical exertion level. 'low' = seated or short walks; 'moderate' = sustained walking; 'high' = climbing, hiking, or active sports. Note: physical-level enrichment data is currently sparse; setting this filter may return zero results for some categories. For activity-style queries prefer tags=['adventure','sport'] instead.",
-  "enum": [
-    "low",
-    "moderate",
-    "high"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Filter to stroller-friendly products only. Note: stroller-friendly flags are currently sparse; for family-with-children queries also try tags=['family'] which is well-populated.",
-  "type": "boolean"
-}

Removed value: -{
-  "description": "Filter to wheelchair-accessible products only. Note: accessibility flags are currently sparse in the catalogue; this may return zero results even for accessible-friendly cities. The catalogue is being progressively enriched.",
-  "type": "boolean"
-}

Previous value: -"Audience filter. Maps to enrichment metadata, not a freeform string."New value: +"Target audience. Currently 'family' is the strongest signal in the catalogue (resolves via the 'family' tag, ~3,200 products). Other values are best-effort and may be sparsely populated; for guaranteed family-suitable results prefer tags=['family'] in addition to or instead of this filter."

Previous value: -"Setting filter for weather-aware searches."New value: +"Setting filter for weather-aware searches. Note: dedicated indoor/outdoor enrichment data is sparse; if this filter returns no results, fall back to tags=['indoor'] or tags=['outdoor'] which are well-populated in the tag taxonomy (~2,100 indoor and ~5,000 outdoor products)."

Previous value: -"Physical exertion level. 'low' = seated or short walks; 'moderate' = sustained walking; 'high' = climbing, hiking, or active sports."New value: +"Physical exertion level. 'low' = seated or short walks; 'moderate' = sustained walking; 'high' = climbing, hiking, or active sports. Note: physical-level enrichment data is currently sparse; setting this filter may return zero results for some categories. For activity-style queries prefer tags=['adventure','sport'] instead."

Previous value: -"Filter to stroller-friendly products only."New value: +"Filter to stroller-friendly products only. Note: stroller-friendly flags are currently sparse; for family-with-children queries also try tags=['family'] which is well-populated."

Previous value: -"Enrichment tags to filter by. Common values: 'family-friendly', 'romantic', 'kid-friendly', 'date-night', 'rainy-day', 'first-timer', 'hidden-gem', 'food-and-drink', 'rooftop', 'sightseeing', 'museums', 'theatre', 'walking-tour', 'cruise', 'observation-deck', 'palace-castle', 'art-gallery', 'outdoors', 'indoors', 'wheelchair-accessible', 'stroller-friendly'. Multiple tags are AND-combined."New value: +"Filter by experience tags. Multiple tags are AND-combined (every tag must match) so adding more tags narrows the result set. Use lowercase singular forms; matching is substring-based against the tag array. The canonical tag taxonomy in the catalogue, ordered by frequency, is: 'tour', 'attraction', 'historical', 'outdoor', 'museum', 'family', 'landmark', 'adventure', 'show', 'indoor', 'food & drink', 'transport', 'theatre', 'concert', 'theme park', 'cruise', 'nightlife', 'comedy', 'musical', 'city pass', 'sport', 'dance', 'aquarium', 'zoo', 'gallery', 'opera', 'wellness', 'water park', 'workshop', 'religious', 'festival'. Examples: ['museum'] for museums; ['family','indoor'] for indoor family attractions; ['outdoor','adventure'] for outdoor adventure activities. Other free-form values may match by substring but are not guaranteed."

Previous value: -"Filter to wheelchair-accessible products only."New value: +"Filter to wheelchair-accessible products only. Note: accessibility flags are currently sparse in the catalogue; this may return zero results even for accessible-friendly cities. The catalogue is being progressively enriched."

Removed value: -"http://json-schema.org/draft-07/schema#"

Removed value: -false

Previous value: -"Optional comma-separated audience filter. Valid values: Family, Couples, AdultsOnly, Kids, Seniors, Groups, Solo"New value: +"Audience filter. Maps to enrichment metadata, not a freeform string."

Added value: +[
+  "family",
+  "couple",
+  "solo",
+  "group",
+  "business"
+]

Removed value: -{
-  "description": "Filter by language availability. ISO 639-1 code: en, es, fr, de, ja, zh, pt, it, ko, etc.",
-  "type": "string"
-}

Previous value: -"Optional category filter. Valid values: theatre, musicals, tours, food, family, nightlife, sightseeing, concerts, comedy, shows, outdoor, workshops, cruises, sports. Matching is fuzzy, so singular forms like \"tour\" still map to \"tours\" internally."New value: +"Category slug, e.g., \"theatre\", \"tours\", \"museums\", \"attractions\"."

Removed value: -[
-  "theatre",
-  "musicals",
-  "tours",
-  "food",
-  "family",
-  "nightlife",
-  "sightseeing",
-  "concerts",
-  "comedy",
-  "shows",
-  "outdoor",
-  "workshops",
-  "cruises",
-  "sports"
-]

Previous value: -"City name or slug (e.g. 'london', 'new-york', 'paris', 'tokyo', 'dubai')"New value: +"City slug, e.g., \"london\", \"new-york\", \"paris\"."

Removed value: -{
-  "description": "Optional start date filter in ISO date format YYYY-MM-DD (e.g. '2026-03-27'). Must be used together with dateTo.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Optional end date filter in ISO date format YYYY-MM-DD (e.g. '2026-03-28'). Must be used together with dateFrom.",
-  "type": "string"
-}

Previous value: -"text"New value: +"json"

Previous value: -"Response format: text (default) or json"New value: +"Response shape. 'json' returns structured records; 'text' returns the same content rendered as a short narrative paragraph for chat surfaces."

Previous value: -[
-  "text",
-  "json"
-]New value: +[
+  "json",
+  "text"
+]

Removed value: -{
-  "description": "Filter for experiences with free cancellation (true) or non-refundable (false)",
-  "type": "boolean"
-}

Added value: +{
+  "description": "Setting filter for weather-aware searches.",
+  "enum": [
+    "indoor",
+    "outdoor",
+    "either"
+  ],
+  "type": "string"
+}

Removed value: -"en"

Previous value: -"Supported language code for localised booking URLs (e.g. 'en', 'de', 'fr', 'es', 'ja', 'pt-br')"New value: +"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."

Added value: +{
+  "default": 10,
+  "description": "Number of results to return (1-50). Default 10.",
+  "maximum": 50,
+  "minimum": 1,
+  "type": "integer"
+}

Removed value: -{
-  "description": "Maximum duration in minutes (e.g. 120 for under 2 hours)",
-  "type": "number"
-}

Previous value: -"Optional maximum price in the experience's local currency"New value: +"Maximum price per person in the listed currency."

Added value: +0

Removed value: -{
-  "default": 12,
-  "description": "Maximum number of experiences to return (default 12, max 200)",
-  "type": "number"
-}

Removed value: -{
-  "description": "Minimum duration in minutes (e.g. 60 for at least 1 hour)",
-  "type": "number"
-}

Removed value: -{
-  "description": "Optional minimum price in the experience's local currency",
-  "type": "number"
-}

Previous value: -"Minimum rating (e.g. 4.5 for top-rated experiences only)"New value: +"Minimum aggregate rating on a 0-5 scale."

Added value: +5

Added value: +0

Added value: +{
+  "description": "Minimum number of customer reviews. Use to filter out new or sparsely-reviewed products.",
+  "minimum": 0,
+  "type": "integer"
+}

Removed value: -{
-  "default": 0,
-  "description": "Pagination offset. Skip this many results before returning. Use with max_results for cursor-based pagination.",
-  "type": "number"
-}

Previous value: -"Filter by physical difficulty level"New value: +"Physical exertion level. 'low' = seated or short walks; 'moderate' = sustained walking; 'high' = climbing, hiking, or active sports."

Previous value: -[
-  "Easy",
-  "Moderate",
-  "Demanding"
-]New value: +[
+  "low",
+  "moderate",
+  "high"
+]

Added value: +{
+  "description": "When true, restricts results to products that meet the popular threshold (4.5+ rating with 100+ reviews).",
+  "type": "boolean"
+}

Previous value: -"Optional free-text filter matched against experience title and description (e.g. 'ghost tour', 'pizza', 'harry potter')"New value: +"Free-text query matched against title, venue, and description."

Removed value: -{
-  "description": "Optional indoor/outdoor filter. Use Indoor for rainy days.",
-  "enum": [
-    "Indoor",
-    "Outdoor",
-    "Mixed"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "default": "relevance",
-  "description": "Optional result ordering. Valid values: relevance, popular, price_low, price_high, rating, best_value. \"popular\" prioritises experiences with price, imagery, rating >= 4.0, and a description.",
-  "enum": [
-    "relevance",
-    "popular",
-    "price_low",
-    "price_high",
-    "rating",
-    "best_value"
-  ],
-  "type": "string"
-}

Added value: +{
+  "description": "Filter to stroller-friendly products only.",
+  "type": "boolean"
+}

Previous value: -"Optional comma-separated tag filter. Results must match at least one tag. Valid tags: Musical, WestEnd, WalkingTour, FoodTour, Museum, Outdoor, HiddenGem, MustSee, Bestseller, Cruise, DayTrip, SkipTheLine, HopOnHopOff, WaterSport, Spa, BikeTour, Adventure, GuidedTour, Attraction, Transfer, SelfGuided, KidsAttraction, Show, Concert, Helicopter, WhaleWatching, Dining, Workshop, NightLife, Safari, Evening, Morning, Seasonal"New value: +"Enrichment tags to filter by. Common values: 'family-friendly', 'romantic', 'kid-friendly', 'date-night', 'rainy-day', 'first-timer', 'hidden-gem', 'food-and-drink', 'rooftop', 'sightseeing', 'museums', 'theatre', 'walking-tour', 'cruise', 'observation-deck', 'palace-castle', 'art-gallery', 'outdoors', 'indoors', 'wheelchair-accessible', 'stroller-friendly'. Multiple tags are AND-combined."

Added value: +{
+  "type": "string"
+}

Previous value: -"string"New value: +"array"

Previous value: -"Filter for wheelchair-accessible experiences only"New value: +"Filter to wheelchair-accessible products only."

Removed value: -[
-  "city"
-]

Previous value: -"Maximum number of experiences to return (default 12, max 50)"New value: +"Maximum number of experiences to return (default 12, max 200)"

Added value: +{
+  "default": 0,
+  "description": "Pagination offset. Skip this many results before returning. Use with max_results for cursor-based pagination.",
+  "type": "number"
+}