To test the Weather API, please submit a brief request through the form at https://weather.openportguide.org/index.php/de/freischaltung-wetterkacheln or send a brief email to
With your API key, you can best test the individual API endpoints (functions) through the prepared page at API-Dog: https://share.apidog.com/78b21e59-e8c5-4a74-a1a9-77e830a93808. The advantage of testing through this page is that you can rule out any errors in your software. Conversely, what works here must also work in your software/on your website.
- Here's a brief description of how to get your first results:
After calling up the URL, you should see the following page: - First, you'll find a whole series of information pages in the upper left area, whose content would overload the individual pages for the respective API endpoints. Use this information as a reference when you get stuck. If you still can't proceed, whether due to the English language or because it's not explained clearly enough, please ask for help briefly at
This email address is being protected from spambots. You need JavaScript enabled to view it. with a brief description of the problem. You'll get a quick response or we'll clarify it in a video conference. - In the lower left area, you'll find the links to the individual API endpoints (functions).
For this example, we want to know the temperature in Hamburg on August 12, 2025, 14:00 UTC. Please note that currently only forecasts, but no historical data, are retrievable. A detailed explanation of the time steps, which can be specified relatively or absolutely in UTC or local time, can be found here: https://share.apidog.com/78b21e59-e8c5-4a74-a1a9-77e830a93808/doc-555031 - In the first step, we'll look at the various forecast models and click on /wthr/list/ForecastModels.
The following page appears:
Here we click on "Try it" - Here you click on {{api-key}} to set your individual API key. Without the API key, the server won't respond to your requests. The API key is only saved on your browser when clicking "Save", but not uploaded to the cloud where this testing environment is located. So everyone works with their own API key without anything being shared publicly.
- Your API key consists of 4 blocks of 8 characters each, separated by "-", so the following format: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd.
Copy your individual API key into the "Value" field behind "api-key" and please click on "Save & Exit". - Now click on the "Send" button in the upper right. The following result should appear in the lower right:
We can see there are 4 possible forecast models from which data can be retrieved:
- gfs: The Global Forecast System of NOAA
- gfswave: The wave forecast of the Global Forecast System of NOAA
- rtofs_prog: The Real Time Ocean Forecast System - Prognosis of NOAA
- rtofs_ice: The Real Time Ocean Forecast System - Ice of NOAA
The temperature in Hamburg, our goal, can be found in the gfs model. How to retrieve it exactly is what we'll look at next. - We now click on /wthr/list/WeatherVariables to take a closer look at the content of the gfs model:
For the "model" parameter, we enter "gfs", the model we're interested in. The "units" parameter can remain empty, and metric units will be automatically assumed.
Now we click "Send" in the upper right again and get a response like this:
As you can see, quite a lot of variables are available for retrieval, a more detailed description here: Weather API - Variables.
A little further down we find the temperature "TMP" which is available as ground surface temperature or as air temperature 2 m above ground as usual. - To be safe, we'll also query the available time steps for the forecast. To do this, click on /wthr/list/Timesteps in the lower left area.
Here we again enter "gfs" for the "model" parameter. The browser remembers our API key.
After clicking "Send", you'll get the list of available time steps displayed both relatively as integers and absolutely as ISO 8601 timestamps. Both have their justification, more details here: Weather API - Timesteps.
For the example, we choose time step "8" because it always works due to the relative reference. - Hamburg is located at approximately the following position:
- lat: 53.55
- lon: 10.00 - Now we finally retrieve the temperature forecast for Hamburg. For this, we select the following API endpoint: /wthr/svar/InterpolatedData.
Here we enter the found values for the query:
And get approximately the following response:
Normally, the path to a value is of course simpler, but to understand the available data, we didn't choose the direct route for this tutorial. Now you're welcome to explore the advanced API endpoints as well. The following should be worth a look:
- /wthr/svar/AreaForcast: Forecast for an entire area
- /wthr/mvar/PointForcast: Time series, also for multiple parameters, ideal for creating your own meteograms
- /wthr/calc/AstroData: Sun and moon data
- /wthr/graphic/Meteogram: Ready-generated meteograms as PNG graphics for any point on Earth
- /wthr/graphic/WeatherMap: Individual weather maps configurable according to personal needs as PNG graphics for any point on Earth
- /wthr/graphic/Tile: Weather tiles as overlay