API Documentation

Base URL: https://mindcracksmp.com/api/

Only endpoints that do not require authentication are listed here.

Creators

GET/api/creatorsReturns all creators. Supports simple search.

Cache: 5m

GET/api/creators/statsReturns simple statistics about creators.

Cache: 1m

GET/api/creators/:idGet a single creator by numeric ID.

Cache: 10m

GET/api/creators/name/:nameGet a single creator by exact name (case-insensitive).

Cache: 10m

Twitch

Update cadence: live ~1m (server cache TTL 1m, SWR 30s). Data via external provider with built-in caching and no rate limits.

GET/api/creators/twitchMap of Twitch usernames to live status for all creators with Twitch set.

Cache: 1m

GET/api/creators/:id/twitchTwitch live status for a creator by ID (if Twitch is set).

Cache: 1m

GET/api/creators/name/:name/twitchTwitch live status for a creator by name (if Twitch is set).

Cache: 1m

YouTube

Update cadence: channel stats ~1m (server cache TTL 1m). Uses aggregated data with built-in provider caching.

GET/api/creators/youtubeYouTube info for every creator with YouTube configured.

Cache: 1m

Response

{"success":true,"data":[{"creatorId":1,"creatorName":"Guude","youtube":{"channelId":"UC1234567890","isLive":false,"subscribers":1230000,"views":567890123,"videoCount":1200,"latestVideoId":"abc123","latestTitle":"Mindcrack SMP - Episode 1","latestPublishedAt":"2024-08-31T18:00:00.000Z"}},{"creatorId":2,"creatorName":"VintageBeef","youtube":{"channelId":"UC0987654321","isLive":true,"liveVideoId":"live987","liveTitle":"Live Redstone Stream","subscribers":2500000,"views":2000000000,"videoCount":1800,"latestVideoId":"def456","latestTitle":"VintageBeef - New Series","latestPublishedAt":"2024-08-30T20:00:00.000Z"}}],"count":2}

Example

curl -sS "https://mindcracksmp.com/api/creators/youtube"

GET/api/creators/:id/youtubeYouTube info for a creator by ID.

Cache: 1m

GET/api/creators/name/:name/youtubeYouTube info for a creator by name.

Cache: 1m

Path params

name: string (URL-encoded)

Response

{"success":true,"data":{"creatorId":1,"creatorName":"Guude","youtube":{"channelId":"UC1234567890","isLive":false,"subscribers":1230000,"views":567890123,"videoCount":1200,"latestVideoId":"abc123","latestTitle":"Mindcrack SMP - Episode 1","latestPublishedAt":"2024-08-31T18:00:00.000Z"}}}

Example

curl -sS "https://mindcracksmp.com/api/creators/name/Guude/youtube"

GET/api/creators/:id/youtube/latestLatest video from creator's YouTube channel uploads.

Cache: 15m

Path params

id: number

Query params

format?: "text" | "title" (optional, defaults to JSON)

Response

JSON (default):
{"success":true,"data":{"videoId":"UZNumPjsQcs","url":"https://youtu.be/UZNumPjsQcs","title":"Cheated Out of ALL my Diamonds!","publishedAt":"2024-01-15T10:00:00Z"}}

Text (?format=text):
https://youtu.be/UZNumPjsQcs

Title (?format=title):
Cheated Out of ALL my Diamonds! - https://youtu.be/UZNumPjsQcs

Example

curl -sS "https://mindcracksmp.com/api/creators/1/youtube/latest?format=title"

GET/api/creators/name/:name/youtube/latestLatest video from creator's YouTube channel uploads by name.

Cache: 15m

Path params

name: string (URL-encoded)

Query params

format?: "text" | "title" (optional, defaults to JSON)

Response

JSON (default):
{"success":true,"data":{"videoId":"UZNumPjsQcs","url":"https://youtu.be/UZNumPjsQcs","title":"Cheated Out of ALL my Diamonds!","publishedAt":"2024-01-15T10:00:00Z"}}

Text (?format=text):
https://youtu.be/UZNumPjsQcs

Title (?format=title):
Cheated Out of ALL my Diamonds! - https://youtu.be/UZNumPjsQcs

Example

curl -sS "https://mindcracksmp.com/api/creators/name/Guude/youtube/latest?format=title"

GET/api/creators/:id/youtube/playlistYouTube playlist URL for a creator by ID.

Cache: 1h

Path params

id: number

Query params

format?: "text" | "title" (optional, defaults to JSON)

Response

JSON (default):
{"success":true,"data":{"playlistId":"PL1234567890","url":"https://youtube.com/playlist?list=PL1234567890","title":"Mindcrack SMP Series"}}

Text (?format=text):
https://youtube.com/playlist?list=PL1234567890

Title (?format=title):
Mindcrack SMP Series - https://youtube.com/playlist?list=PL1234567890

Example

curl -sS "https://mindcracksmp.com/api/creators/1/youtube/playlist?format=text"

GET/api/creators/name/:name/youtube/playlistYouTube playlist URL for a creator by name.

Cache: 1h

Path params

name: string (URL-encoded)

Query params

format?: "text" | "title" (optional, defaults to JSON)

Response

JSON (default):
{"success":true,"data":{"playlistId":"PL1234567890","url":"https://youtube.com/playlist?list=PL1234567890","title":"Mindcrack SMP Series"}}

Text (?format=text):
https://youtube.com/playlist?list=PL1234567890

Title (?format=title):
Mindcrack SMP Series - https://youtube.com/playlist?list=PL1234567890

Example

curl -sS "https://mindcracksmp.com/api/creators/name/Guude/youtube/playlist?format=text"

GET/api/creators/:id/youtube/playlist/latestLatest video from creator's YouTube playlist by ID.

Cache: 15m

Path params

id: number

Query params

format?: "text" | "title" (optional, defaults to JSON)

Response

JSON (default):
{"success":true,"data":{"videoId":"UZNumPjsQcs","url":"https://youtu.be/UZNumPjsQcs","title":"Cheated Out of ALL my Diamonds!","publishedAt":"2024-01-15T10:00:00Z"}}

Text (?format=text):
https://youtu.be/UZNumPjsQcs

Title (?format=title):
Cheated Out of ALL my Diamonds! - https://youtu.be/UZNumPjsQcs

Example

curl -sS "https://mindcracksmp.com/api/creators/1/youtube/playlist/latest?format=title"

GET/api/creators/name/:name/youtube/playlist/latestLatest video from creator's YouTube playlist by name.

Cache: 15m

Path params

name: string (URL-encoded)

Query params

format?: "text" | "title" (optional, defaults to JSON)

Response

JSON (default):
{"success":true,"data":{"videoId":"UZNumPjsQcs","url":"https://youtu.be/UZNumPjsQcs","title":"Cheated Out of ALL my Diamonds!","publishedAt":"2024-01-15T10:00:00Z"}}

Text (?format=text):
https://youtu.be/UZNumPjsQcs

Title (?format=title):
Cheated Out of ALL my Diamonds! - https://youtu.be/UZNumPjsQcs

Example

curl -sS "https://mindcracksmp.com/api/creators/name/Guude/youtube/playlist/latest?format=title"

Realtime Events

Server-Sent Events (SSE) for cache change notifications. Connections stay open so prefer streaming-aware HTTP clients.

GET/api/events/cacheSubscribe to cache invalidation events via SSE.

Response headers

Content-Type: text/event-stream
Cache-Control: no-cache
Connection: keep-alive

Payload schema

{"connected":{"clientId":"string","timestamp":"string"},"heartbeat":{"timestamp":"string"},"cache-event":{"type":"clear-all | clear-pattern | clear-key","payload?":{"pattern?":"string","key?":"string"},"timestamp":"string"}}

`payload` only includes `pattern` for `clear-pattern` and `key` for `clear-key` events.

Sample stream

event: connected
data: {"clientId":"client_1693920000000","timestamp":"2024-09-05T12:34:56.000Z"}

event: heartbeat
data: {"timestamp":"2024-09-05T12:35:26.000Z"}

event: cache-event
data: {"type":"clear-key","payload":{"key":"creators:all"},"timestamp":"2024-09-05T12:36:02.000Z"}

Example

curl -N "https://mindcracksmp.com/api/events/cache"

API Documentation