Community Roster API

Easily access up-to-date streamer rosters for Alaska, Hawaii, New England, and West Coast. Use this API for bots, overlays, websites, or any project that wants to showcase our communities and who's live!

How to Use

1. Send a GET request to /community_roster_api.php
2. Receive a JSON response grouped by alaska, hawaii, newengland, and westcoast
3. Display, process, or filter the data as you wish! You can use all communities or just one.

Example Request

GET https://teammidnite.tv/community_roster_api.php

Sample JSON Output

{
  "alaska": [
    {
      "display_name": "Streamer1",
      "username": "streamer1",
      "avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/...",
      "location": "Anchorage, AK",
      "twitch_url": "https://twitch.tv/streamer1",
      "live": true,
      "viewer_count": 42,
      "stream_title": "Alaska Adventures!",
      "game_name": "Just Chatting"
    },
    ...
  ],
  "hawaii": [ ... ],
  "newengland": [ ... ],
  "westcoast": [ ... ]
}

Filtering by Community

To get just one community, simply use the relevant key from the JSON response. For example, to get all live West Coast members:

const data = await fetch('/community_roster_api.php').then(r => r.json());
const westCoastMembers = data.westcoast;
const liveWestCoast = westCoastMembers.filter(m => m.live);

Field Reference

Field	Type	Description
display_name	string	Streamer's display name
username	string	Twitch username (login)
avatar	string (URL)	Twitch profile image URL
location	string	Location (if provided)
twitch_url	string (URL)	Direct link to Twitch channel
live	boolean	True if streamer is live, false otherwise
viewer_count	integer/null	Current viewers (if live)
stream_title	string/null	Current stream title (if live)
game_name	string/null	Current game/category (if live)

Usage Ideas

• Display live community members on your own website or blog
• Build a Discord bot to announce when someone goes live
• Create overlays for streamers to show who's live in their region
• Integrate with third-party services or apps
• Research, analytics, and more!