The webCountdown API
The API allows external websites, programs, and AI agents to create a countdown. The countdown created via the API is equivalent to one created using the "Quick Start" link on the homepage. The generated link to the webpage with your custom countdown can be accessed directly.
To create a countdown using the API, simply append the target date (as a GET parameter) to the URL: https://www.webcountdown.net/api.php
The parameters are as follows:
- year
- month
- day
- hour
- minute
- second
- up (Countup: Continue counting if the date has already passed)
GET Parameter Restrictions
| Parameter | Minimum | Maximum | Required | Default value |
| year | 1971 | 3000 | ja | - |
| month | 1 | 12 | ja | - |
| day | 1 | 31 | ja | - |
| hour | 0 | 23 | nein | 0 |
| minute | 0 | 59 | nein | 0 |
| second | 0 | 59 | nein | 0 |
| up | 0 | 1 | nein | 0 |
Example API usage
Countdown to New Year: https://www.webcountdown.net/api.php?year=2030&month=1&day=1
OpenAPI definition for AI agents
For easy use by AI agents or other programmatic integration, the API description is available for download here as an OpenAPI definition in JSON format:
https://www.webcountdown.net/s/countdown-openapi.json [json]
Terms of use
The API functionality is provided for programmatic linking to standard webCountdowns. This means the function may be used by AI agents, within AI chats, from apps and from programs to link to the countdowns created in this way.
Additionally, the general webCountdown terms of use apply.
Feedback
Please submit your feedback and suggestions for improvement via our webCountdown contact form.
External calls to the timer function
It is also possible to start a timer directly. The syntax for this is described on the timer page. An example would be:
