Quickstart

1. Create an API Key

Sign up for a SmarterWeather account and create an API key from your Developer Dashboard. Your key will look like sw_live_xxxxxxxxxxxxxxxx.

2. Make Your First Request

The unified /v1/weather endpoint returns everything you need in a single call. Pass your coordinates and your API key as an HTTP Bearer token:

curl "https://api.smarterweather.com/v1/weather?lat=40.7128&lon=-74.0060&units=imperial" \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Understand the Response

The response is a single JSON object containing all weather data for the requested location:

{
  "location": {
    "lat": 40.7128,
    "lon": -74.006,
    "city": "New York",
    "state": "NY",
    "timezone": "America/New_York"
  },
  "current": {
    "temperature": 72,
    "feels_like": 74,
    "humidity": 55,
    "wind_speed": 8,
    "wind_direction": "SW",
    "conditions": "Partly Cloudy",
    "icon": "partly_cloudy_day"
  },
  "hourly": [ ... ],
  "daily": [ ... ],
  "alerts": [ ... ],
  "radar": { ... }
}

4. Filter Response Sections

Use the include parameter to request only the sections you need, reducing payload size:

curl "https://api.smarterweather.com/v1/weather?lat=40.7128&lon=-74.0060&include=current,alerts" \
  -H "Authorization: Bearer YOUR_API_KEY"

5. Try the MCP Server

If you're building AI applications, check out our MCP Server for direct AI assistant integration with 30+ specialized weather tools.