Conditions
https://phrases.api.xweather.com/conditions/The Conditions endpoint generates a comprehensive report of the current weather conditions along with an optional forecast. By default, the request includes a 24 hour forecast if one is not provided. It 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 primarily utilizes data from the Conditions (opens in a new tab) and Forecasts (opens in a new tab) endpoint. Please refer to these for more information on the available metrics and valid time ranges.
Requests
The request URL should be in the following format:
https://phrases.api.xweather.com/conditions/?client_id={client_id}&client_secret={client_secret}&{params}Supported Parameters
The following parameters are optional unless otherwise noted:
| Parameter | Description | Format |
|---|---|---|
| stream | Type: stringWhether to stream the results in real-time. The default value is false. | stream=:boolean |
| units | Type: stringThe units to use for the results. The default value is both. Valid values are: both, imperial, metric. | units=:string |
| personality | Type: 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 |
| language | Type: 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 |
| limit | Type: stringThe total number of forecast period results that filter uses. The default value is 2. | limit=:total |
| filter | Type: stringForecast filters for the results. The default value is daynight. Valid values are: daynight, day, mdnt2mdnt, #hr. See Filters tab for more info on usage of these values. | filter=:string |
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)."
}