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. Query params
Response
{
"success": true,
"data": [
{
"id": 1,
"name": "Guude",
"bio": "Founding member of Mindcrack.",
"minecraft": { "name": "Guude" },
"youtube": { "channelUrl": "https://www.youtube.com/@Guude", "videoId": "", "playlistId": "" },
"twitch": { "username": "guude" },
"updatedAt": "2024-09-01T10:20:30.000Z"
},
{
"id": 2,
"name": "VintageBeef",
"bio": "OG Mindcrack creator.",
"minecraft": { "name": "VintageBeef" },
"youtube": { "channelUrl": "https://www.youtube.com/@VintageBeef", "videoId": "", "playlistId": "" },
"twitch": { "username": "vintagebeef" },
"updatedAt": "2024-09-01T10:20:30.000Z"
}
],
"count": 2
}Example
curl -sS "https://mindcracksmp.com/api/creators?search=Mindcrack"
GET/api/creators/statsReturns simple statistics about creators. Response
{
"success": true,
"data": { "totalCreators": 23, "lastUpdated": "2024-09-02T00:00:00.000Z" }
}Example
curl -sS "https://mindcracksmp.com/api/creators/stats"
GET/api/creators/:idGet a single creator by numeric ID. Path params
Response
{
"success": true,
"data": {
"id": 1,
"name": "Guude",
"bio": "Founding member of Mindcrack.",
"minecraft": { "name": "Guude" },
"youtube": { "channelUrl": "https://www.youtube.com/@Guude", "videoId": "", "playlistId": "" },
"twitch": { "username": "guude" },
"updatedAt": "2024-09-01T10:20:30.000Z"
}
}Example
curl -sS "https://mindcracksmp.com/api/creators/1"
GET/api/creators/name/:nameGet a single creator by exact name (case-insensitive). Path params
name: string (URL-encoded)
Response
{
"success": true,
"data": {
"id": 1,
"name": "Guude",
"bio": "Founding member of Mindcrack.",
"minecraft": { "name": "Guude" },
"youtube": { "channelUrl": "https://www.youtube.com/@Guude", "videoId": "", "playlistId": "" },
"twitch": { "username": "guude" },
"updatedAt": "2024-09-01T10:20:30.000Z"
}
}Example
curl -sS "https://mindcracksmp.com/api/creators/name/Guude"
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. Response
{
"success": true,
"data": { "guude": false, "vintagebeef": true },
"count": 2
}Example
curl -sS "https://mindcracksmp.com/api/creators/twitch"
GET/api/creators/:id/twitchTwitch live status for a creator by ID (if Twitch is set). Path params
Response
{
"success": true,
"data": { "creatorId": 1, "creatorName": "Guude", "username": "guude", "isLive": false }
}Example
curl -sS "https://mindcracksmp.com/api/creators/1/twitch"
GET/api/creators/name/:name/twitchTwitch live status for a creator by name (if Twitch is set). Path params
name: string (URL-encoded)
Response
{
"success": true,
"data": { "creatorId": 1, "creatorName": "Guude", "username": "guude", "isLive": false }
}Example
curl -sS "https://mindcracksmp.com/api/creators/name/Guude/twitch"
YouTube
Update cadence: live ~1m (scrape; no Data API quota), latest upload ~15m, channel stats ~60m, channel ID ~24h. Endpoint cache TTL 1m, SWR 30s.
GET/api/creators/youtubeAggregated YouTube info for creators with a channel set. 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. Path params
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/1/youtube"
GET/api/creators/name/:name/youtubeYouTube info for a creator by name. 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"
