Thank you for using the GridPointWeather API service. To properly use the API, important information is below. If you have any issues, email support with a detailed description of your issue.
You can use the API URL Builder to automatically populate API request parameters, or you can use the information below to manually create a request to the API.
All requests to the API are HTTP GET requests to
Additionally there are a series of query parameters that must be appeneded to the URL to dictate
what type of API request is being made.
An example of a fully-formed API Request URL could look like
Note: you must have a valid token to make a request to the API. If you wish to simply test the API, you can sign up for the free plan.
Each parameters meaning and possible values are explained below.
Location is in the format
LONGITUDE are valid latitude and longitude values. These coordinates specify
the location for which you are requesting model data. The
%2c is present
as it represents a URL-encoded comma.
The model represents the model for which you are requesting forecast information. The API offers access to forecast data from multiple weather and non-weather models. Only one model can be specified per request. The possible model values are enumerated below.
Weather Forecast Models
Other Non-Weather Models:
This parameter controlls whether or not you would like to recieve the current forecast conditions, and/or the daily maxium information.
api=0does not print the current forecast condition or the daily maximum information
api=1prints only the current forecast conditions
api=2prints only the daily maximum information
api=3prints both current forecast condition and daily maximum information
Setting INUNITS to 1 will give you US units, while setting inunits to 0 gives you metric
interptype=2 causes the program to interpolate
to your location while setting
interptype=1 will provide
the nearest gridpoint.
offset=0 to return UTC times, otherwise set to the
hour offset for your location (Enter +/- Hours).
hours is the number of forecast hours you would like to
pull. Change HOURS to 24 for a 24 hour forecast to 192
(This is model dependant).
This response was generated using the following request:
To determine the model cycle pass the following information through the API MODEL-cycle. For example to find out the current GFS cycle:
Please contact us for information about our API.
185 Jordan Road
Troy, NY 12180-7611