fishtank.live APIfishtank.live ↗
Access Fishtank.live clips, episodes, leaderboard, contestant stox, and live stream status via a structured REST API with 9 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/79e8fcda-585e-4e22-8df0-4ab1af838604/get_initial_data' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve site metadata including contestants, poll, TTS history, feature toggles, and current announcement.
No input parameters required.
{
"type": "object",
"fields": {
"initialData": "object containing announcement, contestants, poll, ttsMessages, featureToggles, and other site state"
},
"sample": {
"data": {
"initialData": {
"poll": {
"lastPoll": {
"pid": "1778464554437",
"winner": "Aryeh",
"answers": [
"Aryeh",
"Angie"
],
"question": "Who goes home?"
},
"ongoingPoll": null
},
"contestants": [
{
"id": "101",
"name": "Rachel",
"color": "#ff9b04",
"season": "4"
}
],
"ttsMessages": [
{
"id": "321446",
"room": "ktch-5",
"status": "played",
"message": "hi guys",
"displayName": "fartjon"
}
],
"announcement": "backyardbutchers.com/fishtank for 30% off"
}
},
"status": "success"
}
}About the fishtank.live API
The Fishtank.live API exposes 9 endpoints covering clips, episodes, contestants, leaderboard rankings, stock prices, and live stream status from the Fishtank.live reality show platform. The get_clips endpoint supports paginated search with filters for room, season, and sort order, while get_live_streams returns real-time online/offline status for each active broadcast. Together the endpoints give programmatic access to nearly every core data surface the site surfaces to viewers.
Clips and Episodes
get_clips returns an array of clip objects — each with id, name, views, likes, liveStream, and source — plus a total count for pagination. You can filter by room (e.g., 'Bedroom 1', 'Director Mode'), season (e.g., 'Season 4'), and sort (hot_score or views), or run a freetext search against clip names. get_clip_detail accepts a numeric clip_id and returns the full clip object alongside a comments array (each comment has profile, message, likes, and nested replies) and the creator's displayName. get_random_clip returns one clip chosen at random with no inputs required. Episodes are retrieved via get_episodes, which returns objects keyed by season/category name, each holding an array of episode objects with id, title, thumbnail, duration, and createdAt. get_episode_detail takes a UUID from those results and returns the episode's comment thread.
Contestants, Stox, and Leaderboard
get_initial_data returns a broad site-state snapshot: an announcement, a contestants array, the active poll, recent ttsMessages, and featureToggles. get_stox returns a stocks array where each object carries tickerSymbol, currentPrice, averagePrice, totalShares, ipoPrice, and order book data — effectively a mini exchange feed tied to individual contestants. The orders field is populated only for authenticated sessions; unauthenticated calls return an empty array. get_leaderboard returns the top users ranked by XP, with each entry including userId, displayName, xp, tokens, and medals.
Live Streams
get_live_streams returns three objects: liveStreams (an array of stream definitions with id, name, playbackId, season, access, and an interactive flag), loadBalancer (a map from stream IDs to server hostnames), and liveStreamStatus (a map from stream IDs to online/offline state). This is the fastest way to determine which rooms are currently broadcasting and which playback IDs to use for embedding or monitoring.
- Build a clip discovery tool that surfaces trending Fishtank.live clips filtered by room and sorted by
hot_score. - Track contestant popularity over time by polling
get_stoxforcurrentPriceandaveragePricechanges. - Monitor which live streams are online using the
liveStreamStatusmap fromget_live_streams. - Aggregate episode comment sentiment by fetching comment threads via
get_episode_detailfor each season. - Display a real-time leaderboard widget using
xpandtokensfields fromget_leaderboard. - Power a random clip feature on a fan site using
get_random_clipwith no configuration required. - Audit active feature flags and current announcements programmatically via the
featureTogglesfield inget_initial_data.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Fishtank.live have an official public developer API?+
What does get_stox return when called without authentication?+
stocks array is always populated with ticker symbols, current prices, average prices, total shares, IPO prices, and order book data for each contestant. The orders field, which would contain the caller's open orders, returns an empty array when the request is unauthenticated.Can I filter clips by a specific contestant rather than by room or season?+
get_clips supports filtering by room, season, and a freetext search against clip names, but does not expose a dedicated contestant filter parameter. You can fork this API on Parse and revise it to add a contestant-specific filter endpoint.Is user profile data — such as individual account stats or follow relationships — available?+
displayName, xp, tokens, medals) and clip/episode comment authors, but does not expose individual user profile pages or social graph data. You can fork the API on Parse and revise it to add a user profile endpoint.How is episode content different from clip content in the API?+
get_episodes returns structured episode metadata (title, thumbnail, duration, createdAt) grouped by season, suitable for building a VOD catalog. get_clips returns shorter user-highlighted clips with engagement metrics like views and likes. The two content types are fetched through separate endpoints and are not interchangeable.