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.

If you have an existing account using the API Explorer is recommended to build API calls. Additionally, securely passing "apikey" and "secretkey" in the http header is supported. Curl example represented below:

curl "https://wxdata.com/cgi-bin/land-daily-forecast-api.pl?format=json&version=1.0&location=10001&forecast_period=all&units=e&max_temp=1&min_temp=1" \
-H "apikey: [provided-apikey]" \
-H "secretkey: [provided-secretkey]"

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"
apikey User API access key Required As provided by WxData™
secretkey 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