# Tomorrow.io API

**Provider:** Tomorrow.io
**Category:** weather
**Base URL:** `https://api.tomorrow.io/v4`
**Auth:** api-key — `x-api-key: your-api-key`
**Rate Limit:** 3 requests/s (free)
**Free Tier:** Yes — [object Object]
**Pricing:** Pay per use (pay-as-you-go)
**Docs:** https://docs.tomorrow.io/reference

## Description

Tomorrow.io (formerly ClimaCell) delivers hyperlocal weather intelligence sourced from proprietary IoT sensor networks, radar, satellites, and ML models. Get precipitation-level precision, severe weather alerts, timeline forecasts, and custom weather event triggers for automation.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.tomorrow.io/v4/weather/realtime` | Real-time weather conditions at a location |
| GET | `https://api.tomorrow.io/v4/weather/forecast` | Hourly/daily forecast up to 6 months |
| GET | `https://api.tomorrow.io/v4/weather/history/recent` | Historical weather (last 6 hours) |
| POST | `https://api.tomorrow.io/v4/events/search` | Search for weather events matching criteria |

## Authentication

Pass your API key in the apikey query parameter or the x-api-key header.

```
x-api-key: your-api-key
```

## Sample Request

```bash
curl "https://api.tomorrow.io/v4/weather/realtime?location=42.3478,-71.0466&units=metric" \
  -H "x-api-key: $TOMORROW_API_KEY"
```

## Sample Response

```json
{
  "data": {
    "time": "2024-01-18T12:00:00Z",
    "values": {
      "temperature": 5.2,
      "humidity": 62,
      "precipitationIntensity": 0,
      "windSpeed": 8.1,
      "weatherCode": 1100
    }
  },
  "location": {"lat": 42.3478, "lon": -71.0466, "name": "Boston, MA"}
}
```

## Pricing Details

Free: 500 calls/day. Developer: $99/mo. Startup: $299/mo. Enterprise: custom pricing for high-volume and custom data layers.

---

*Source: [API Map](https://apimap.dev/apis/tomorrow-io/) — CC BY 4.0*