{"current":{"path":"/weather/current","method":"GET","kind":"data","tier":"basic","description":"Current weather conditions for any location — temperature, humidity, wind.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"}},"required":["latitude","longitude"],"output_example":{"location":{"lat":51.5,"lon":-0.12,"timezone":"Europe/London"},"current":{"temperature_c":18.0,"feels_like_c":18.4,"humidity_pct":86,"wind_speed_kmh":9.7,"conditions":"Overcast","weather_code":3,"precipitation_mm":0.0}},"latency_class":"fast"},"forecast":{"path":"/weather/forecast","method":"GET","kind":"data","tier":"basic","description":"7-day weather forecast — daily highs, lows, precipitation.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"},"days":{"type":"integer","description":"Forecast days (1-16)","default":7}},"required":["latitude","longitude"],"output_example":{"location":{"lat":51.5,"lon":-0.12,"timezone":"Europe/London"},"forecast":[{"date":"2026-06-18","high_c":28.0,"low_c":16.0,"conditions":"Sunny"}]},"latency_class":"fast"},"earthquakes":{"path":"/nature/earthquakes","method":"GET","kind":"data","tier":"basic","description":"Recent earthquake activity near a location — queries multiple seismic monitoring portals in parallel. Magnitude, depth, and distance.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"},"radius_km":{"type":"integer","description":"Search radius in km","default":200},"min_magnitude":{"type":"number","description":"Minimum magnitude","default":2.5}},"required":["latitude","longitude"],"output_example":{"location":{"lat":35.68,"lon":139.76},"earthquakes":[{"magnitude":3.2,"depth_km":45.0,"location":"50 km E of Tokyo","time":"2026-06-18T04:00:00Z","distance_km":52.0}],"count":1},"latency_class":"fast"},"volcanoes":{"path":"/nature/volcanoes","method":"GET","kind":"data","tier":"basic","description":"Recent volcanic activity near a location — global volcano event monitoring.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"},"radius_km":{"type":"integer","description":"Search radius in km","default":500}},"required":["latitude","longitude"],"output_example":{"location":{"lat":35.68,"lon":139.76},"volcanoes":[{"name":"Telica Volcano, Nicaragua","distance_km":0.0,"date":"2026-05-30T00:00:00Z","status":"active"}],"count":1},"latency_class":"fast"},"air_quality":{"path":"/nature/air-quality","method":"GET","kind":"data","tier":"basic","description":"Air quality index and pollutants at any location — European AQI, US AQI, PM2.5, PM10, ozone, and NO2.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"}},"required":["latitude","longitude"],"output_example":{"location":{"lat":51.5,"lon":-0.12},"air_quality":{"european_aqi":38,"us_aqi":47,"pm2_5":8.7,"pm10":14.2,"ozone":64.1}},"latency_class":"fast"},"marine":{"path":"/nature/marine","method":"GET","kind":"data","tier":"basic","description":"Marine conditions — wave height, sea surface temperature, swell height, and current velocity.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"}},"required":["latitude","longitude"],"output_example":{"location":{"lat":30.0,"lon":-80.0},"marine":{"wave_height_m":1.02,"sea_surface_temperature_c":29.1,"swell_wave_height_m":0.56}},"latency_class":"fast"},"solar":{"path":"/nature/solar","method":"GET","kind":"data","tier":"basic","description":"Solar radiation data — shortwave and direct radiation, and sunshine duration.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"}},"required":["latitude","longitude"],"output_example":{"location":{"lat":51.5,"lon":-0.12},"solar":{"shortwave_radiation_sum_mj":24.21,"sunshine_duration_h":8.5}},"latency_class":"fast"},"historical":{"path":"/climate/historical","method":"GET","kind":"data","tier":"basic","description":"Historical weather data from 1940 to present — temperature, precipitation, and more.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"},"start_date":{"type":"string","description":"Start date YYYY-MM-DD"},"end_date":{"type":"string","description":"End date YYYY-MM-DD"}},"required":["latitude","longitude","start_date","end_date"],"output_example":{"location":{"lat":51.5,"lon":-0.12},"days":7,"start_date":"2020-01-01","end_date":"2020-01-07","data":[{"date":"2020-01-01","temp_max_c":9.8,"temp_min_c":4.2}]},"latency_class":"fast"},"weather_ask":{"path":"/weather/ask","method":"POST","kind":"inference","tier":"regular","description":"Premium multi-source intelligence: ask natural-language questions about weather, earthquakes, volcanoes, or natural events. Queries multiple weather models in parallel and returns the fastest result with cross-validation.","parameters":{"question":{"type":"string","description":"Natural language question about weather, earthquakes, volcanoes."},"latitude":{"type":"number","description":"Latitude — optional, extracted from question if omitted"},"longitude":{"type":"number","description":"Longitude — optional, extracted from question if omitted"}},"required":["question"],"output_example":{"question":"Is there any seismic or volcanic activity near Tokyo?","answer":"No recent volcanic activity near Tokyo. Current weather is clear. No disruptions expected.","sources_consulted":["Weather Models","Seismic Monitoring","Volcanic Activity Data","Earthquake Data"],"fastest_source":"Weather Models","sources_returned":3,"sources_errored":0,"reasoning_model":"deepseek-v4-flash","confidence":"high"},"latency_class":"medium"}}