Sunshine Atlas

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['destinations'], 'properties': {'month': {'anyOf': [{'type': 'string'}, {'type': 'number'}], 'description': 'Optional month to compare in; omit for year-round comparison'}, 'destinations': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5, 'minItems': 2, 'description': '2–5 destinations (city, "city, country", or IATA code)'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['month'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'How many results (default 10, max 50)'}, 'month': {'anyOf': [{'type': 'string'}, {'type': 'number'}], 'description': 'Month name ("November", "nov") or number 1–12'}, 'where': {'type': 'string', 'description': 'Optional continent ("Europe", "Asia", "North America", …) or country (name or ISO-2 code) to search within. "Europe" uses the traveler definition and includes the Canary Islands.'}, 'max_midday_uv': {'type': 'number', 'description': 'Only places whose typical midday UV index that month is at or below this (WHO scale: ≤2 low, ≤5 moderate, ≤7 high). For sun-sensitive travellers — "sunny but not fierce".'}, 'min_day_high_c': {'type': 'number', 'description': 'Only places at least this warm by day that month, °C'}, 'min_population': {'type': 'number', 'description': 'Only places with at least this population (default 0 = include small islands and outposts)'}, 'require_swimmable_sea': {'type': 'boolean', 'description': 'Only coastal places with sea ≥21°C that month'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['destination'], 'properties': {'destination': {'type': 'string', 'description': 'City name, "city, country", or 3-letter IATA airport code'}}}