Public API

Read only endpoints for public channel data. No API key needed.

• Base URL: https://fishrift.com
• Responses are JSON.
• :username matches any connected platform name, preferring Twitch.
• Creators with a private profile return 404 {"error":"Not found"} on profile endpoints.

#Profile

GET /api/public/profile/:username

Everything on a creator's public profile: names, avatar and banner, bio, live status, connected platforms, social links, cosmetics, schedule and visible sections.

#Schedule

GET /api/public/schedule/:username

{
  "creator_timezone": "Europe/Amsterdam",
  "highlight": { "title": "Efteling day", "platform": "twitch", "start_datetime": "2026-10-05T18:00:00Z", "days_until": 1, "is_live": false },
  "recurring": [{ "title": "Chill stream", "days": ["mon", "wed"], "time": "20:00", "timezone": "Europe/Amsterdam", "duration_minutes": 120 }],
  "upcoming": [],
  "recent": [],
  "series": []
}

Recurring times are local to their timezone.

recent lists dated entries from the last 8 days that are already over, in the same shape as upcoming. Week views use it to show past days greyed out instead of empty.

GET /api/public/schedule/:username/embed returns a short version: the highlight, up to 4 recurring streams and the next 3 upcoming ones.

#Leaderboard

GET /api/public/leaderboard/:username?type=points&period=all_time&limit=10&offset=0

:username must be the Twitch login. Cached for 2 minutes.

{
  "type": "points",
  "period": "all_time",
  "currency_name": "Fishcoins",
  "has_more": true,
  "entries": [{ "rank": 1, "login": "fishfan", "display_name": "fishfan", "value": 12345 }]
}

value is points, watch time in seconds, message count, bits or gift subs, depending on type. Hidden boards return 404 {"error":"hidden"}.

#Commands

GET /api/public/commands/:username

The creator's public command list, in sections (general, song_request, raffle, viewer_queue, giveaway, moderation, bot).

{
  "prefix": "!",
  "sections": [{
    "id": "general",
    "label": "General",
    "commands": [{ "trigger": "!discord", "description": "...", "access": "Viewer", "cooldown_sec": 5, "user_cooldown_sec": 0 }]
  }]
}

#Activity

GET /api/public/feed/:username

The last 50 follows, subs, resubs, gift subs, raids, cheers and tips. Messages are never included. Cached for 30 seconds.

{ "events": [{ "type": "bits", "platform": "twitch", "viewer": "FishFan", "amount": 500, "occurred_at": "2026-10-04T19:00:00Z" }] }

#Alerts, clips and links

#Giveaway

#Viewer cosmetics and pronouns

Cosmetics are useful for chat overlays that want to show Fishrift name paints and badges.

#Media