Skip to main content
This endpoint returns a plain text message designed for Twitch chat bot integration. It provides a concise answer about whether Kevin will stream today, formatted for display in Twitch chat.

Endpoint

GET /api/twitch/command

Response

Returns a plain text string (not JSON) with one of the following messages:
  • When streaming is predicted: "Kevin plant um {time} Uhr online zu gehen. Pag"
    • Example: "Kevin plant um 14:00 Uhr online zu gehen. Pag"
  • When no stream is predicted: "Kevin kommt heute nicht online. Saj"
  • When no data is available: "4Shrug"
The time is formatted in 24-hour format (HH:mm) using German locale.

Use case

This endpoint is specifically designed for Twitch chat bot integration. A bot can periodically query this endpoint and post the response to chat when users ask about the stream schedule. The response includes Twitch emote codes (Pag, Saj, 4Shrug) that will render as emotes when posted in Twitch chat.

Example

Request

curl https://kommtkevinonline.de/api/twitch/command

Response (stream predicted)

Kevin plant um 18:00 Uhr online zu gehen. Pag

Response (no stream predicted)

Kevin kommt heute nicht online. Saj

Response (no data)

4Shrug

Implementation notes

The endpoint queries the most recent VOD from the database and applies the same prediction logic used on the main site. It checks if Kevin mentioned streaming today or tomorrow based on when the last stream occurred.
For chat bot integration, consider caching this response for 5-10 minutes to avoid excessive database queries while still providing reasonably up-to-date information.

Build docs developers (and LLMs) love