Tomorrow.io LLM-Friendly Weather API Documentation

The Realtime Weather API provides current weather conditions for any location worldwide with up-to-the-minute accuracy. All available weather parameters are automatically included - no field selection required. Perfect for dashboards, mobile apps, and real-time monitoring systems.

Reference: https://docs.tomorrow.io/reference/realtime-weather

Information

Automatic Field Inclusion: Unlike other endpoints, the Realtime Weather API automatically includes all available weather fields. No fields parameter is needed or supported.

Endpoint Details

Base URL

https://api.tomorrow.io/v4/weather/realtime

Method: GET | Authentication: API Key (query parameter)

Parameters

Parameter	Type	Required	Description	Example
`location`	String \| [Number, Number]	Required	Location coordinates, address, or place name. Supports coordinates (lat,lon), city names, addresses, ZIP codes, and postal codes	`40.7128,-74.0060 or "New York, NY" or "10001"`
`units`	String	Optional	Units for response data (metric or imperial)	`imperial`
`timezone`	String	Optional	IANA timezone name for response timestamps. If not specified, UTC is used	`America/New_York`
`apikey`	String	Required	Your Tomorrow.io API key for authentication	`YOUR_API_KEY`

Response Structure

The Realtime Weather API returns a simple JSON structure with current weather data and location information. All available weather fields are included automatically - no field selection is needed.

Complete Response Hierarchy

API Response StructureTEXT
Realtime Weather API Response Structure
├── data/
│   ├── time (ISO 8601 timestamp)
│   └── values/
│       ├── cloudBase (m or ft)
│       ├── cloudCeiling (m or ft) 
│       ├── cloudCover (%)
│       ├── dewPoint (°C/°F)
│       ├── freezingRainIntensity (mm/h or in/h)
│       ├── hailProbability (%)
│       ├── humidity (%)
│       ├── precipitationProbability (%)
│       ├── precipitationIntensity (mm/h or in/h)
│       ├── pressureSeaLevel (hPa or inHg)
│       ├── pressureSurfaceLevel (hPa or inHg)
│       ├── rainIntensity (mm/h or in/h)
│       ├── sleetIntensity (mm/h or in/h)
│       ├── snowIntensity (mm/h or in/h)
│       ├── temperature (°C/°F)
│       ├── temperatureApparent (°C/°F)
│       ├── uvHealthConcern (0-5)
│       ├── uvIndex (0-11+)
│       ├── visibility (km or miles)
│       ├── weatherCode (integer)
│       ├── windDirection (degrees)
│       ├── windGust (m/s or mph)
│       └── windSpeed (m/s or mph)
│
└── location/
    ├── lat (latitude coordinate)
    ├── lon (longitude coordinate)
    └── name (location name, if applicable)

Data Fields

The Realtime Weather API automatically includes all available weather data fields. Here are the key fields you can expect in every response:

Temperature & Comfort

temperature - Current air temperature
temperatureApparent - Feels-like temperature
dewPoint - Dew point temperature
humidity - Relative humidity percentage
uvIndex - UV radiation index
uvHealthConcern - UV health risk level

Wind & Pressure

windSpeed - Wind speed
windDirection - Wind direction in degrees
windGust - Wind gust speed
pressureSeaLevel - Barometric pressure at sea level
pressureSurfaceLevel - Surface-level pressure

Precipitation

precipitationIntensity - Current precipitation rate
precipitationProbability - Chance of precipitation
rainIntensity - Rain intensity
snowIntensity - Snow intensity
sleetIntensity - Sleet intensity
freezingRainIntensity - Freezing rain intensity
hailProbability - Probability of hail

Visibility & Clouds

visibility - Visibility distance
cloudCover - Cloud coverage percentage
cloudBase - Height of cloud base
cloudCeiling - Height of cloud ceiling
weatherCode - Numeric weather condition code

Examples

Example 1: Toronto Weather (City Name)

Request

curl "https://api.tomorrow.io/v4/weather/realtime?location=toronto&apikey=[API_KEY]"

Response

{
  "data": {
    "time": "2025-06-08T10:55:00Z",
    "values": {
      "cloudBase": 15.6,
      "cloudCeiling": 15.6,
      "cloudCover": 52,
      "dewPoint": 9.2,
      "freezingRainIntensity": 0,
      "hailProbability": 0,
      "humidity": 76,
      "precipitationProbability": 0,
      "pressureSeaLevel": 1011.27,
      "pressureSurfaceLevel": 1000.74,
      "rainIntensity": 0,
      "sleetIntensity": 0,
      "snowIntensity": 0,
      "temperature": 13.3,
      "temperatureApparent": 13.3,
      "uvHealthConcern": 0,
      "uvIndex": 0,
      "visibility": 15.7,
      "weatherCode": 1101,
      "windDirection": 49,
      "windGust": 3.9,
      "windSpeed": 2.5
    }
  },
  "location": {
    "lat": 43.653480529785156,
    "lon": -79.3839340209961,
    "name": "Toronto, Golden Horseshoe, Ontario, Canada",
    "type": "administrative"
  }
}

Example 2: New York Weather (Coordinates + Imperial Units)

Request

curl "https://api.tomorrow.io/v4/weather/realtime?location=40.7128,-74.0060&units=imperial&apikey=[API_KEY]"

Response

{
  "data": {
    "time": "2019-03-20T14:09:50Z",
    "values": {
      "temperature": 59.36,
      "temperatureApparent": 62.6,
      "humidity": 73,
      "windSpeed": 8.94,
      "windDirection": 205.63,
      "precipitationIntensity": 0,
      "weatherCode": 1000
    }
  },
  "location": {
    "lat": 40.7128,
    "lon": -74.006
  }
}