guruwalk.com

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "minLength": 1,
      "description": "REQUIRED. The destination city name mentioned by the user. Pass the user's literal text (e.g., 'Valencia', 'New York', 'Roma') without modification."
    },
    "beginsAt": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date of the search range in YYYY-MM-DD format"
    },
    "endsAt": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date of the search range in YYYY-MM-DD format"
    },
    "howManyAdults": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of adults attending"
    },
    "howManyChildren": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of children attending"
    },
    "activityType": {
      "type": "string",
      "enum": [
        "free-tour",
        "paid",
        "all"
      ],
      "description": "Type of activities to search for. 'free-tour' = free walking tours (the default option, what most users want). 'paid' = paid activities like food tours, museum tickets, day trips. 'all' = both free tours and paid activities together."
    },
    "verticalId": {
      "type": "string",
      "minLength": 1,
      "description": "Optional vertical ID to filter by. Use this to filter by a specific category (e.g., Tablaos Flamencos = \"171\" in Sevilla). Get valid IDs from list_destination_options first."
    },
    "tagId": {
      "type": "string",
      "minLength": 1,
      "description": "Optional free-tour tag ID. Get valid IDs from list_destination_options first. Providing a tagId implies free tours: activityType will be treated as 'free-tour'."
    }
  },
  "required": [
    "destination"
  ]
}