StreamStatus API Reference

GET /api/status Public

Retrieves the current live status, game, and tags for all tracked infosec streamers. This endpoint is entirely public and is designed to be easily consumed by any fork of the InfosecStreams website.

Rate Limit: 5 requests per second per IP.

cURL

curl -X GET https://streamstatus.wupinyin.co.uk/api/status

Response (JSON)

{
  "discomouse": {
    "online": true,
    "game": "Science & Technology",
    "language": "en",
    "tags": ["cybersecurity", "infosec"]
  }
}

POST /api/streamers Admin Only

Registers a new streamer in the database and automatically negotiates an EventSub webhook subscription with Twitch. Requires the administrative Bearer token.

cURL

curl -X POST https://streamstatus.wupinyin.co.uk/api/streamers \
  -H "Authorization: Bearer <YOUR_SS_ADMIN_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"username": "SomeStreamer"}'