VenuNite Events

Added value: +{
+  "description": "Stable VenuNite identity; use this value with create_ticket_handoff.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Canonical VenuNite event page; null when no stored slug exists. Prefer this link for event details.",
+  "format": "uri",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Original event source for provenance. The legacy url field retains the same meaning.",
+  "format": "uri",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"Canonical vibe vocabulary. Include tags the user explicitly or strongly implied. IMPORTANT: the tags `queer-friendly`, `family-friendly`, `all-ages`, `18-plus`, `21-plus` are HARD filters — only include them when the user's query explicitly asked for that property. Including `family-friendly` for a user who just said 'something fun tonight' will exclude most venues."New value: +"Canonical vibe vocabulary. Include tags the user explicitly or strongly implied. IMPORTANT: the tags `queer-friendly`, `family-friendly`, `all-ages`, `18-plus`, `21-plus` are HARD filters — only include them when the user's query explicitly asked for that property. Including `family-friendly` for a user who just said 'something fun tonight' will exclude most events."

Previous value: -"Search radius in miles. OMIT this field to let the server pick a density-aware default: 5mi in dense metros (Chicago, NYC), 15mi suburban, 25mi rural. Only pass an explicit value when the user's phrasing implies a specific scope:\n  - 'walking distance' / 'on my block' → 2-3\n  - 'near me' in a dense downtown or neighborhood → 5-7\n  - 'near me' in a suburb → 10-15\n  - 'metro area' / 'anywhere in <city>' → 25-30\n  - rural 'near me' or 'within driving distance' → 25-50\n\nFor a user who says 'things to do tonight' in Lincolnwood, Chicago, or any other dense-urban location: omit this field. Passing 15 there pulls events from 8-10 miles away in other neighborhoods, which is worse than the density-aware default.\n\nMax 500. Use 'local_only: true' instead of a small radius when you're unsure of local density."New value: +"Search radius in miles. OMIT this field to let the server pick a density-aware default: 5mi in dense metros (Chicago, NYC), 15mi suburban, 25mi rural. Only pass an explicit value when the user's phrasing implies a specific scope:\n  - 'walking distance' / 'on my block' → 2-3\n  - 'near me' in a dense downtown or neighborhood → 5-7\n  - 'near me' in a suburb → 10-15\n  - 'metro area' / 'anywhere in <city>' → 25-30\n  - rural 'near me' or 'within driving distance' → 25-50\n\nFor a user who says 'things to do tonight' in Lincolnwood, Chicago, or any other dense-urban location: omit this field. Passing 15 there pulls events from 8-10 miles away in other neighborhoods, which is worse than the density-aware default.\n\nRange 0.5 to 500. An out-of-range value FAILS the entire call and returns zero events — it is not clamped — so omit the field rather than guessing. Use 'local_only: true' instead of a small radius when you're unsure of local density."

Added value: +500

Added value: +0.5

Added value: +{
+  "format": "date-time",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Added value: +{
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -"ISO-8601 end of the search window. Default: 14 days from date_start. 'Tonight' → date_start + 6 hours. 'Next weekend' → date_start + 2 days."New value: +"Exclusive ISO-8601 end of the search window, including the local UTC offset. Default: 14 days from date_start. 'Tonight' → date_start + 6 hours. 'Next weekend' → date_start + 2 days. An event starting exactly at date_end is outside this window."

Added value: +{
+  "default": "overlap",
+  "description": "overlap includes events already running during the window, such as multi-day festivals or prior-night shows; events ending exactly at date_start are excluded. starts_within requires the event to start at or after date_start and before date_end. Prefer starts_within for requests about events starting tomorrow, on a specified date, this evening, or this weekend. Keep overlap when the user asks what is currently happening or wants ongoing activities.",
+  "enum": [
+    "overlap",
+    "starts_within"
+  ],
+  "type": "string"
+}

Previous value: -"ISO-8601 start of the search window. Default: now. For 'tonight' pass now. For 'this weekend' pass the upcoming Saturday midnight. NOTE: the window matches by OVERLAP — an event that STARTED before date_start but is still running during the window (multi-day festival, a show that ends after midnight) is included. Filter client-side on `start` if you strictly need events that begin inside the window."New value: +"Inclusive ISO-8601 start of the search window, including the local UTC offset. Default: now. For 'tonight' pass now. For 'this weekend' pass the upcoming Saturday midnight. The timezone field controls day grouping, not parsing: date-times without an offset are interpreted as UTC. Use date_match=starts_within when the user wants events starting on a particular date or evening."

Added value: +{
+  "default": true,
+  "description": "Include events whose admission price cannot be determined. Default true preserves broad discovery; positive price bounds may then include unknown prices, which must be labeled unverified. Set false with min_cost/max_cost when the user explicitly requires a verified budget. This never relaxes the proven-free requirement of max_cost=0.",
+  "type": "boolean"
+}

Previous value: -"Upper bound on event cost in USD. 'cheap' ≈ 15, 'affordable' ≈ 30, 'under $X' → X. Leave unset if the user didn't constrain price."New value: +"Upper bound on event cost in USD. 'cheap' ≈ 15, 'affordable' ≈ 30, 'under $X' → X. Set include_unknown_prices=false when the user explicitly wants a verified budget such as 'under $100'. max_cost=0 returns only proven-free events. Leave unset if the user didn't constrain price."

Previous value: -"Human-readable location if the user mentioned one: 'Westminster, CO' or 'Five Points Denver'. Prefer this over lat/lng when you have a name. Always include the state abbrev when the city name is ambiguous."New value: +"Human-readable location if the user mentioned one: 'Westminster, CO' or 'Five Points Denver'. Prefer this over guessed lat/lng when you have a name; existing precise coordinates take precedence. Always include the state abbrev when the city name is ambiguous. An unresolved place returns location_unresolved; correct the place or use known coordinates rather than dropping the location."

Added value: +{
+  "enum": [
+    "overlap",
+    "starts_within"
+  ],
+  "type": "string"
+}

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

Previous value: -"Ordering axis. Results are always grouped chronologically by calendar day (in `timezone`); `sort` orders WITHIN each day. 'date' (default) = by start time; 'distance' = nearest first; 'demand' = most popular first; 'relevance' = semantic score first (best with query_text)."New value: +"Ordering axis. Results are presented by calendar day in timezone; sort orders within each day. With query_text and no explicit sort (or relevance), the server selects the strongest event-text and venue-vibe matches before applying that day order. Explicit date, distance, or demand sorts select by day and that axis. Without query_text, default date is chronological."

Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "anyOf": [
+    {
+      "required": [
+        "applied_filters"
+      ]
+    },
+    {
+      "required": [
+        "error"
+      ]
+    }
+  ],
+  "properties": {
+    "applied_filters": {
+      "additionalProperties": false,
+      "properties": {
+        "categories": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "center": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "number"
+              },
+              "maxItems": 2,
+              "minItems": 2,
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "d_half_miles": {
+          "type": "number"
+        },
+        "date_end": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "date_start": {
+          "format": "date-time",
+          "type": "string"
+        },
+        "density_class": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "limit": {
+          "type": "integer"
+        },
+        "local_only": {
+          "type": "boolean"
+        },
+        "max_cost": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "max_events_per_venue": {
+          "type": "integer"
+        },
+        "min_cost": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "original_radius_miles": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "original_strict_tags": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "query_text": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "radius_miles": {
+          "type": "number"
+        },
+        "relaxed": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "soft_tags": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "sort": {
+          "type": "string"
+        },
+        "sort_requested": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "strict_tags": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "error": {
+      "type": "string"
+    },
+    "results": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "age": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "category": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "cost_numeric": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cost_text": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "end": {
+            "format": "date-time",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "image_url": {
+            "format": "uri",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "is_free": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "slug": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "start": {
+            "format": "date-time",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "title": {
+            "type": "string"
+          },
+          "url": {
+            "format": "uri",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "venue": {
+            "additionalProperties": false,
+            "properties": {
+              "city": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "distance_miles": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "name": {
+                "type": "string"
+              },
+              "state": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "vibeTags": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "name",
+              "city",
+              "state",
+              "vibeTags",
+              "distance_miles"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "title",
+          "slug",
+          "description",
+          "start",
+          "end",
+          "cost_text",
+          "is_free",
+          "cost_numeric",
+          "age",
+          "category",
+          "url",
+          "image_url",
+          "venue"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "validation_errors": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "field": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "field",
+          "message"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "results"
+  ],
+  "type": "object"
+}

Previous value: -[
-  "music",
-  "karaoke",
-  "sports",
-  "comedy",
-  "theater",
-  "trivia-games",
-  "food-drink",
-  "arts-culture",
-  "community"
-]New value: +[
+  "music",
+  "karaoke",
+  "sports",
+  "comedy",
+  "theater",
+  "trivia-games",
+  "food-drink",
+  "arts-culture",
+  "community",
+  "festivals"
+]

Previous value: -"ISO-8601 start of the search window. Default: now. For 'tonight' pass now. For 'this weekend' pass the upcoming Saturday midnight."New value: +"ISO-8601 start of the search window. Default: now. For 'tonight' pass now. For 'this weekend' pass the upcoming Saturday midnight. NOTE: the window matches by OVERLAP — an event that STARTED before date_start but is still running during the window (multi-day festival, a show that ends after midnight) is included. Filter client-side on `start` if you strictly need events that begin inside the window."

Added value: +{
+  "description": "Ordering axis. Results are always grouped chronologically by calendar day (in `timezone`); `sort` orders WITHIN each day. 'date' (default) = by start time; 'distance' = nearest first; 'demand' = most popular first; 'relevance' = semantic score first (best with query_text).",
+  "enum": [
+    "date",
+    "distance",
+    "demand",
+    "relevance"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Two-letter state abbreviation to disambiguate place_name (e.g. place_name 'Frederick' + state_hint 'MD'). Unnecessary when place_name already contains the state.",
+  "type": "string"
+}

Added value: +{
+  "description": "IANA timezone (e.g. 'America/New_York') used for the calendar-day grouping of results. Default UTC — pass the user's local zone so 'today/tomorrow' day buckets match their clock.",
+  "type": "string"
+}

Added value: +{
+  "default": false,
+  "description": "Set true when the user's query implies 'in my immediate area' — 'what's on my block', 'nearby tonight', 'close by'. The server clamps the effective radius to a neighborhood-scale max based on local density (≤10mi urban, ≤30mi suburban, ≤50mi rural), even if radius_miles is larger. Prefer this over guessing a small radius — the server knows the density of the area and you don't.",
+  "type": "boolean"
+}

Previous value: -15New value: +null

Previous value: -"Search radius in miles. Default 15 if the user said 'near X' without specifying. 25-30 for 'metro area', 5 for 'walking distance'. Max 500."New value: +"Search radius in miles. OMIT this field to let the server pick a density-aware default: 5mi in dense metros (Chicago, NYC), 15mi suburban, 25mi rural. Only pass an explicit value when the user's phrasing implies a specific scope:\n  - 'walking distance' / 'on my block' → 2-3\n  - 'near me' in a dense downtown or neighborhood → 5-7\n  - 'near me' in a suburb → 10-15\n  - 'metro area' / 'anywhere in <city>' → 25-30\n  - rural 'near me' or 'within driving distance' → 25-50\n\nFor a user who says 'things to do tonight' in Lincolnwood, Chicago, or any other dense-urban location: omit this field. Passing 15 there pulls events from 8-10 miles away in other neighborhoods, which is worse than the density-aware default.\n\nMax 500. Use 'local_only: true' instead of a small radius when you're unsure of local density."

Previous value: -"Canonical vibe vocabulary. Include tags the user explicitly or strongly implied. IMPORTANT: the tags `family-friendly`, `all-ages`, `18-plus`, `21-plus` are HARD filters — only include them when the user's query explicitly asked for that property. Including `family-friendly` for a user who just said 'something fun tonight' will exclude most venues."New value: +"Canonical vibe vocabulary. Include tags the user explicitly or strongly implied. IMPORTANT: the tags `queer-friendly`, `family-friendly`, `all-ages`, `18-plus`, `21-plus` are HARD filters — only include them when the user's query explicitly asked for that property. Including `family-friendly` for a user who just said 'something fun tonight' will exclude most venues."