API Documentation

CatchUp.help exposes a public API for integrating AI recaps with Nightbot, StreamElements, or any custom chat bot. Available on Creator and Pro plans.

Base URL

https://api.catchup.help/api/v1

GET /recap/{channel_id}

Get the latest AI-generated recap for a live stream.

Parameters:

channel_id — Your CatchUp channel ID

Response:

{
  "success": true,
  "recap": "Stream summary text here...",
  "timestamp": "2026-05-02T18:30:00Z",
  "stream_status": "live"
}

GET /chapters/{session_id}

Get auto-generated chapters for a completed stream session.

Response:

{
  "success": true,
  "chapters": [
    { "timestamp": "00:00", "title": "Stream Start & Intro" },
    { "timestamp": "05:23", "title": "Boss Strategy Discussion" },
    { "timestamp": "15:47", "title": "Q&A Session" }
  ],
  "summary": "Full stream summary..."
}

GET /chapters/{session_id}/export

Export chapters in various formats.

Query Parameters:

format — youtube, srt, json, or markdown

YouTube format example:

00:00 Stream Start & Intro
05:23 Boss Strategy Discussion
15:47 Q&A Session

Nightbot Integration

To use CatchUp with Nightbot, create a custom command in Nightbot:

!addcom !recap $(urlfetch https://api.catchup.help/api/v1/recap/YOUR_CHANNEL_ID)

When a viewer types !recap, Nightbot fetches the latest recap from CatchUp's API and posts it in chat.