Skip to Content
Conditions

Phrases API - Conditions

URL Path
https://phrases.api.xweather.com/conditions/
Data Coverage
Global
Update Interval
Near real-time
Time Range
Now to +1 day
Multiplier
50x

The Conditions endpoint generates a comprehensive report of the current weather conditions along with an optional 24-hour forecast. By default, the forecast is not provided. This endpoint aggregates and identifies the most important weather metrics and presents them akin to traditional weather broadcasts or reports. This report can include metrics such as temperatures, wind speeds, precipitation, humidity, and more.

This endpoint utilizes data from the Conditions  and Forecasts  endpoint (if forecast is included). Please refer to these for more information on the available metrics and valid time ranges.

Requests

Every request to the endpoint must include one of the supported actions in the url.

https://phrases.api.xweather.com/conditions/{action}?client_id={client_id}&client_secret={client_secret}&{params}

Supported Parameters

The following parameters are optional unless otherwise noted:

ParameterDescriptionFormat
streamType: stringWhether to stream the results in real-time. The default value is false.stream=:boolean
unitsType: stringThe units to use for the results. The default value is both. Valid values are: both, imperial, metric.units=:string
personalityType: stringThe personality to use for the results. The default value is default, which is a helpful meteorologist. Valid values are: default, meteorologist, on_air_met, radio_host, shock_jock.personality=:string
languageType: stringThe desired output language of the results. The default value is en. Refer to the list of Supported Languages for the full range of values.language=:string
tzType: stringThe caller's full IANA time zone, such as Europe/Helsinki or America/Chicago. Relative dates such as tomorrow and dates/times without a UTC offset are interpreted in this time zone. When omitted, the requested location's time zone is used.tz=:string
tz_displayType: stringThe time zones to use for times in the response. The default value is both. Valid values are: location for the requested location's time zone, caller for the caller's tz, or both for both time zones. When tz is omitted, times use the requested location's time zone for all options. Time zone references are combined when both zones share the same UTC offset throughout the requested period.tz_display=:string
include_locationType: stringWhether to include a reference to the requested location in the response. The default value is true.include_location=:boolean
forecast_24hType: stringWhether to include a 24-hour forecast in the response. The default value is false.forecast_24h=:boolean

Response

The following is an example of what each object in the response will consist of. Depending on your requested action, the response may contain multiple instances of this object within an array.

Properties

response (string)

The object containing the text summary output.

{
  "response": "Minneapolis, MN is currently experiencing significant weather impacts that pose risks for outdoor activities. The forecasted minimum feels-like temperature is expected to drop to -22.3°C (-8°F) within the next hour, indicating a high temperature risk. The current temperature stands at -14.8°C (5°F), with a dew point of -20.1°C (-4°F) and humidity at 64%. The wind is blowing from the northwest at about 6 kph (4 mph), contributing to the overall chill.\n\nLooking ahead, the weather forecast for the evening of February 19 features partly cloudy skies with snow showers likely, having a 70% chance of precipitation. The expected minimum temperature will reach -21.9°C (-7°F) with a minimum feels-like temperature of -26.8°C (-16°F). Winds will be from the northwest at speeds ranging from 5 to 9 kph (3 to 6 mph). Visibility is expected to be 15.2 kilometers (9.4 miles). \n\nFor the morning of February 20, the weather is expected to be mostly sunny with a minimum temperature of -14.6°C (6°F) and a minimum feels-like temperature dropping to -25.8°C (-15°F). Winds will continue from the northwest at 5 kph (3 mph). Visibility remains at 15.2 kilometers (9.4 miles) with no expected precipitation. The atmospheric pressure is currently at 1039 mb (30.6 inHg)."
}
© 2026 Xweather (opens in a new tab)Terms of Service (opens in a new tab)Privacy Policy (opens in a new tab)