Daily Weather Forecast API Format

The WxData™ Daily Weather Forecast API provides direct daily weather forecast data out to 7 days for any location in the U.S. defined by zip code or latitude/longitude. The API returns all provided weather forecast elements or only those that meet your needs.

In your API call you can filter on these elements:

  • location
  • Max temperature/span>
  • Wind speed/span>
  • wind gust
  • Heat index
  • Wind chill
  • Weather condition icon
  • Weather condition text

HTTP Methods

API supports GET

Base URL

HTTP: http://wxdata.com/cgi-bin/land-daily-forecast-api.pl

HTTPS: https://wxdata.com/cgi-bin/land-daily-forecast-api.pl

Request Parameters

The following parameters may be used:

Parameter Description Required Values
version Version control Required 1.0
format Return data format Required "xml" or "json"
key User API access key Required As provided by WxData™
secret Secret key (do not share) Required As provided by WxData™
location 5 digit zip code or latitude longitude point of desired location. Required
forecast_period 'all'is current option to return full forecast range out 7 days Required
  • Options:
  • all
units Imperial (U.S. Standard) or metric units Required
  • Options:
  • e (imperial)
  • m (metric)
max_temp Maximium daily forecast temperature Optional
  • Options:
  • 1 (yes, return)
  • 0 (no, do not return) (default)
min_temp Minimum daily forecast temperature Optional
  • Options:
  • 1 (yes, return)
  • 0 (no, do not return) (default)
heat_index Maximum heat index for the forecast period Optional
  • Options:
  • 1 (yes, return)
  • 0 (no, do not return) (default)
wind_chill Forecast wind chill for the forecast period Optional
  • Options:
  • 1 (yes, return)
  • 0 (no, do not return) (default)
wind_speed Maximum wind speed for forecat period Optional
  • Options:
  • 1 (yes, return)
  • 0 (no, do not return) (default)
wind_gust Maximum wind gust for forecast period Optional
  • Options:
  • 1 (yes, return)
  • 0 (no, do not return) (default)
weather_icon URL link to weather condition icon for forecast period Optional
  • Options:
  • 1 (yes, return)
  • 0 (no, do not return) (default)
weather_text Weather condition forecast phrase for forecast period. Optional
  • Options:
  • 1 (yes, return)
  • 0 (no, do not return) (default)

Return Elements: Information About The Returned Weather Data

Value Description Type
city City name text
state Two character state abbreviations text
country Country of origin text
latitude Latitude of city/state location float
longitude Longitude of city/state location float
valid time Start time of forecast period YYYY-MM-DDTHH:MM:SS
week_day Week day label of forecast period text
max_temp Maximum forecast temperature for period (max_temp_c or max_temp_f) integer
min_temp Minimum forecast temperature for period (min_temp_c or min_temp_f) integer
heat_index Heat index (heat_index_f or heat_index_c) float
wind_chill Wind chill (wind_chill_f or wind_chill_c) float
wind_speed Wind speed (wind_speed_mph or wind_speed_kt) integer
wind_gust Wind gust (wind_gust_mph or wind_gust_kt) integer
weather_icon Weather condition icon URL text
weather_text Weather forecast phrase text

XML Sample Output

<response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XML-Schema-instance" version="1.2" xsi:noNamespaceSchemaLocation="http://wxdata.com/schema/xml1_2.xsd"> <weatherdata> <location> <city>NEW YORK</city> <state>NY</state> <country>US</country> <zipcode>10001</zipcode> <type>forecast</type> <latitude>40.7484</latitude> <longitude>73.9967</longitude> </location> <time_taken_ms>009</time_taken_ms> <errors/> <warnings/> <forecast_periods> <validtime datetime="2021-04-07 08:00:00"> <week_day>Wednesday</week_day> <max_temp_f>68</max_temp_f> <min_temp_f></min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>7</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/bkn.jpg</weather_icon> <weather_text>Mostly Cloudy</weather_text> </validtime> <validtime datetime="2021-04-07 20:00:00"> <week_day>Wednesday Night</week_day> <max_temp_f></max_temp_f> <min_temp_f>47</min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>6</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/nsct.jpg</weather_icon> <weather_text>Partly Cloudy</weather_text> </validtime> <validtime datetime="2021-04-08 08:00:00"> <week_day>Thursday</week_day> <max_temp_f>65</max_temp_f> <min_temp_f></min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>9</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/sct.jpg</weather_icon> <weather_text>Partly Sunny</weather_text> </validtime> <validtime datetime="2021-04-08 20:00:00"> <week_day>Thursday Night</week_day> <max_temp_f></max_temp_f> <min_temp_f>46</min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>8</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/nsct.jpg</weather_icon> <weather_text>Partly Cloudy</weather_text> </validtime> <validtime datetime="2021-04-09 08:00:00"> <week_day>Friday</week_day> <max_temp_f>60</max_temp_f> <min_temp_f></min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>10</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/bkn.jpg</weather_icon> <weather_text>Mostly Cloudy</weather_text> </validtime> <validtime datetime="2021-04-09 20:00:00"> <week_day>Friday Night</week_day> <max_temp_f></max_temp_f> <min_temp_f>48</min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>7</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/nra30.jpg</weather_icon> <weather_text>Chance of Rain</weather_text> </validtime> <validtime datetime="2021-04-10 08:00:00"> <week_day>Saturday</week_day> <max_temp_f>59</max_temp_f> <min_temp_f></min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>10</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/shra30.jpg</weather_icon> <weather_text>Chance of Rain Showers</weather_text> </validtime> <validtime datetime="2021-04-10 20:00:00"> <week_day>Saturday Night</week_day> <max_temp_f></max_temp_f> <min_temp_f>49</min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>8</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/nra50.jpg</weather_icon> <weather_text>Chance of Rain</weather_text> </validtime> <validtime datetime="2021-04-11 08:00:00"> <week_day>Sunday</week_day> <max_temp_f>60</max_temp_f> <min_temp_f></min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>10</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/shra50.jpg</weather_icon> <weather_text>Chance of Rain Showers</weather_text> </validtime> <validtime datetime="2021-04-11 20:00:00"> <week_day>Sunday Night</week_day> <max_temp_f></max_temp_f> <min_temp_f>48</min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>7</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/nra50.jpg</weather_icon> <weather_text>Chance of Rain</weather_text> </validtime> <validtime datetime="2021-04-12 08:00:00"> <week_day>Monday</week_day> <max_temp_f>62</max_temp_f> <min_temp_f></min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>9</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/shra40.jpg</weather_icon> <weather_text>Chance of Rain Showers</weather_text> </validtime> <validtime datetime="2021-04-12 20:00:00"> <week_day>Monday Night</week_day> <max_temp_f></max_temp_f> <min_temp_f>47</min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>8</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/nra30.jpg</weather_icon> <weather_text>Chance of Rain</weather_text> </validtime> <validtime datetime="2021-04-13 08:00:00"> <week_day>Tuesday</week_day> <max_temp_f>62</max_temp_f> <min_temp_f></min_temp_f> <heat_index_f></heat_index_f> <wind_chill_f></wind_chill_f> <wind_speed_mph>8</wind_speed_mph> <weather_icon>https://wxdata.com/images/daily_wxicon/shra20.jpg</weather_icon> <weather_text>Slight Chance of Rain Showers</weather_text> </validtime> </forecast_periods> </weatherdata> </response>

JSON Sample Output

{ "weatherdata": { "location": { "city": "NEW YORK", "state": "NY", "country": "US", "zipcode": "10001", "type": "forecast", "latitude": "40.7484", "longitude": "73.9967" }, "time_taken_ms": "010", "errors": "", "warnings": "", "forecast_periods": [ { "validtime": "2021-04-07 08:00:00", "week_day": "Wednesday", "max_temp_f": "68", "min_temp_f": "", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "7", "weather_icon": "https://wxdata.com/images/daily_wxicon/bkn.jpg", "weather_text": "Mostly Cloudy" }, { "validtime": "2021-04-07 20:00:00", "week_day": "Wednesday Night", "max_temp_f": "", "min_temp_f": "47", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "6", "weather_icon": "https://wxdata.com/images/daily_wxicon/nsct.jpg", "weather_text": "Partly Cloudy" }, { "validtime": "2021-04-08 08:00:00", "week_day": "Thursday", "max_temp_f": "65", "min_temp_f": "", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "9", "weather_icon": "https://wxdata.com/images/daily_wxicon/sct.jpg", "weather_text": "Partly Sunny" }, { "validtime": "2021-04-08 20:00:00", "week_day": "Thursday Night", "max_temp_f": "", "min_temp_f": "46", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "8", "weather_icon": "https://wxdata.com/images/daily_wxicon/nsct.jpg", "weather_text": "Partly Cloudy" }, { "validtime": "2021-04-09 08:00:00", "week_day": "Friday", "max_temp_f": "60", "min_temp_f": "", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "10", "weather_icon": "https://wxdata.com/images/daily_wxicon/bkn.jpg", "weather_text": "Mostly Cloudy" }, { "validtime": "2021-04-09 20:00:00", "week_day": "Friday Night", "max_temp_f": "", "min_temp_f": "48", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "7", "weather_icon": "https://wxdata.com/images/daily_wxicon/nra30.jpg", "weather_text": "Chance of Rain" }, { "validtime": "2021-04-10 08:00:00", "week_day": "Saturday", "max_temp_f": "59", "min_temp_f": "", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "10", "weather_icon": "https://wxdata.com/images/daily_wxicon/shra30.jpg", "weather_text": "Chance of Rain Showers" }, { "validtime": "2021-04-10 20:00:00", "week_day": "Saturday Night", "max_temp_f": "", "min_temp_f": "49", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "8", "weather_icon": "https://wxdata.com/images/daily_wxicon/nra50.jpg", "weather_text": "Chance of Rain" }, { "validtime": "2021-04-11 08:00:00", "week_day": "Sunday", "max_temp_f": "60", "min_temp_f": "", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "10", "weather_icon": "https://wxdata.com/images/daily_wxicon/shra50.jpg", "weather_text": "Chance of Rain Showers" }, { "validtime": "2021-04-11 20:00:00", "week_day": "Sunday Night", "max_temp_f": "", "min_temp_f": "48", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "7", "weather_icon": "https://wxdata.com/images/daily_wxicon/nra50.jpg", "weather_text": "Chance of Rain" }, { "validtime": "2021-04-12 08:00:00", "week_day": "Monday", "max_temp_f": "62", "min_temp_f": "", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "9", "weather_icon": "https://wxdata.com/images/daily_wxicon/shra40.jpg", "weather_text": "Chance of Rain Showers" }, { "validtime": "2021-04-12 20:00:00", "week_day": "Monday Night", "max_temp_f": "", "min_temp_f": "47", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "8", "weather_icon": "https://wxdata.com/images/daily_wxicon/nra30.jpg", "weather_text": "Chance of Rain" }, { "validtime": "2021-04-13 08:00:00", "week_day": "Tuesday", "max_temp_f": "62", "min_temp_f": "", "heat_index_f": "", "wind_chill_f": "", "wind_speed_mph": "8", "weather_icon": "https://wxdata.com/images/daily_wxicon/shra20.jpg", "weather_text": "Slight Chance of Rain Showers" } ] } }

Our weather API is currently used worldwide by users to feed their apps, services, and mission with reliable weather data.

If you have any queries, then please contact us. Pricing