{"openapi":"3.1.0","info":{"title":"FNTerminal API","version":"1","summary":"Live data for every Fortnite Creative and UEFN island.","description":"Free, read-only JSON API. No key; CORS enabled. 120 requests per minute per IP; responses are cached for 60 seconds and data refreshes every 10 minutes. Please show \"Data: FNTerminal\" with a link to https://fnterminal.live wherever the data appears. Players are peak concurrent players per 10-minute window (Epic hides values under 5, returned as null). Ratios are decimals (0.125 = 12.5%). Dates are ISO 8601 UTC. Estimated earnings come from a model based on playtime, not from Epic. FNTerminal is not affiliated with Epic Games.","termsOfService":"https://fnterminal.live/legal/terms#api"},"servers":[{"url":"https://fnterminal.live/api/v1"}],"externalDocs":{"description":"Developer docs and integration brief for AI agents","url":"https://fnterminal.live/developers?tab=agents"},"paths":{"/islands":{"get":{"operationId":"listIslands","summary":"List islands","description":"Islands sorted and filtered like the terminal.","parameters":[{"name":"sort","in":"query","required":false,"description":"Order of the list.","schema":{"type":"string","enum":["players","rising","falling","earnings","peak","plays","retention","newest"],"default":"players"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Number of islands."},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"description":"Islands to skip (pagination)."},{"name":"genre","in":"query","schema":{"type":"string"},"description":"Genre slug, e.g. simulation-tycoon or shooter."},{"name":"tag","in":"query","schema":{"type":"string"},"description":"Only islands with this tag."},{"name":"creator","in":"query","schema":{"type":"string"},"description":"Creator code: only this creator's islands."},{"name":"q","in":"query","schema":{"type":"string","maxLength":60},"description":"Search in titles."},{"name":"minPlayers","in":"query","schema":{"type":"integer","minimum":0},"description":"At least this many players now."},{"name":"epic","in":"query","schema":{"type":"boolean"},"description":"true: only Epic's modes; false: only creator islands."}],"responses":{"200":{"description":"The islands.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IslandList"}}}},"400":{"description":"A parameter has an unknown value; the message lists the accepted ones.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"More than 120 requests in a minute from this IP, or too many expensive list queries (deep offsets, broad filters). Wait retryAfterSeconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimited"}}}}}}},"/islands/{code}":{"get":{"operationId":"getIsland","summary":"One island","description":"Everything about one island, with optional history and extras.","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","examples":["1234-5678-9012","experience_br"]},"description":"Island code (creator islands: 1234-5678-9012; Epic modes: names such as experience_br). URL-encode it."},{"name":"series","in":"query","required":false,"description":"Include a time series for this range.","schema":{"type":"string","enum":["6h","1d","1w","1m","3m","1y","all"]}},{"name":"metric","in":"query","required":false,"description":"Metric of the series.","schema":{"type":"string","enum":["ccu","plays","uniq","minutes","avg_min","favs","recs","ret_d1","ret_d7","grank"],"default":"ccu"}},{"name":"include","in":"query","schema":{"type":"string","examples":["media,versions,discover"]},"description":"Comma-separated extras: media (artwork and HLS trailers), versions (update history with player impact), discover (Discover rows over 30 days)."}],"responses":{"200":{"description":"The island.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IslandResponse"}}}},"400":{"description":"A parameter has an unknown value; the message lists the accepted ones.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown island code.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"More than 120 requests in a minute from this IP, or too many expensive list queries (deep offsets, broad filters). Wait retryAfterSeconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimited"}}}}}}},"/ecosystem":{"get":{"operationId":"getEcosystem","summary":"Fortnite right now","description":"Players in a match and online, today's curve, daily peaks and the share of play on creator islands.","responses":{"200":{"description":"Fortnite-wide numbers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ecosystem"}}}},"429":{"description":"More than 120 requests in a minute from this IP, or too many expensive list queries (deep offsets, broad filters). Wait retryAfterSeconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimited"}}}}}}},"/heatmap":{"get":{"operationId":"getHeatmap","summary":"Genre heatmap","description":"Live islands grouped by genre, with players now and 24 hours ago for each island and genre (the heatmap of the genres page).","parameters":[{"name":"mode","in":"query","required":false,"description":"Biggest islands, biggest gainers or biggest losers over 24 hours.","schema":{"type":"string","enum":["most","rising","falling"],"default":"most"}},{"name":"genre","in":"query","schema":{"type":"string"},"description":"Genre slug, e.g. simulation-tycoon or shooter: only this genre."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":600,"default":200},"description":"Number of islands."}],"responses":{"200":{"description":"The islands, by genre.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Heatmap"}}}},"400":{"description":"A parameter has an unknown value; the message lists the accepted ones.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"More than 120 requests in a minute from this IP, or too many expensive list queries (deep offsets, broad filters). Wait retryAfterSeconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimited"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"RateLimited":{"type":"object","properties":{"error":{"type":"string"},"retryAfterSeconds":{"type":"integer"}},"required":["error","retryAfterSeconds"]},"Island":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"creator":{"type":["string","null"]},"isEpic":{"type":"boolean"},"url":{"type":"string","format":"uri","description":"Island page on FNTerminal."},"image":{"type":"string","format":"uri","description":"1280 px WebP thumbnail (w=256 or w=640 for smaller)."},"genre":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"tagline":{"type":["string","null"]},"releasedAt":{"type":["string","null"],"format":"date-time"},"releaseDateIsExact":{"type":"boolean"},"players":{"type":"object","properties":{"now":{"type":["integer","null"],"description":"Null when the island isn't live."},"lastSeen":{"type":["integer","null"],"description":"Last value seen."},"at":{"type":["string","null"],"format":"date-time","description":"Time of lastSeen."},"change1h":{"type":["number","null"],"description":"Change over 1 hour (0.125 = +12.5%)."},"change24h":{"type":["number","null"],"description":"Change over 24 hours."},"change7d":{"type":["number","null"],"description":"Change over 7 days."},"peak24h":{"type":["integer","null"],"description":"Highest player count over the past 24 hours."},"peak7d":{"type":["integer","null"],"description":"Highest player count over the past 7 days."},"peakAllTime":{"type":["integer","null"]},"peakAllTimeAt":{"type":["string","null"],"format":"date-time"}}},"last24h":{"type":"object","properties":{"plays":{"type":["integer","null"]},"playsDayBefore":{"type":["integer","null"]},"uniquePlayers":{"type":["integer","null"]},"minutesPlayed":{"type":["integer","null"]},"minutesPerPlayer":{"type":["number","null"]},"favorites":{"type":["integer","null"]},"recommendations":{"type":["integer","null"]}},"description":"The last complete UTC day (yesterday, once Epic has published it); playsDayBefore is the day before."},"retention":{"type":"object","properties":{"day1":{"type":["number","null"],"description":"Day-1 retention."},"day7":{"type":["number","null"],"description":"Day-7 retention."}}},"estimatedEarnings":{"oneOf":[{"type":"null"},{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"perDay":{"type":"integer"},"perMonth":{"type":"integer"},"low":{"type":"integer","description":"Low end of the daily range."},"high":{"type":"integer","description":"High end of the daily range."},"note":{"type":"string"}},"description":"A model based on playtime, not Epic's figures. Null for Epic's own modes and when the day's stats are missing."}]},"rank":{"type":"object","properties":{"overall":{"type":["integer","null"]},"inGenre":{"type":["integer","null"]}}},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["code","title","isEpic","url","image","players","last24h","retention","rank"]},"IslandDetail":{"allOf":[{"$ref":"#/components/schemas/Island"},{"type":"object","properties":{"description":{"type":["string","null"]},"version":{"type":["integer","null"]},"maxPlayers":{"type":["integer","null"]},"ageRating":{"type":["string","null"]},"lastUpdatedAt":{"type":["string","null"],"format":"date-time"}}}]},"IslandList":{"type":"object","properties":{"sort":{"type":"string","enum":["players","rising","falling","earnings","peak","plays","retention","newest"]},"limit":{"type":"integer"},"offset":{"type":"integer"},"count":{"type":"integer"},"islands":{"type":"array","items":{"$ref":"#/components/schemas/Island"}}},"required":["sort","limit","offset","count","islands"]},"IslandResponse":{"type":"object","properties":{"island":{"$ref":"#/components/schemas/IslandDetail"},"series":{"type":"object","properties":{"metric":{"type":"string","enum":["ccu","plays","uniq","minutes","avg_min","favs","recs","ret_d1","ret_d7","grank"]},"range":{"type":"string","enum":["6h","1d","1w","1m","3m","1y","all"]},"resolution":{"type":"string"},"points":{"type":"array","items":{"type":"array","prefixItems":[{"type":"string","format":"date-time"},{"type":["number","null"]}]}}}},"media":{"type":"object","properties":{"images":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"videos":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"hls":{"type":"string","format":"uri"},"durationSeconds":{"type":["number","null"]}}}}}},"versions":{"type":"array","items":{"type":"object","properties":{"version":{"type":"integer"},"publishedAt":{"type":"string","format":"date-time"},"title":{"type":["string","null"]},"changes":{"type":"array","items":{"type":"string"}},"avgPlayers24hBefore":{"type":["integer","null"]},"avgPlayers24hAfter":{"type":["integer","null"]}}}},"discover":{"type":"array","items":{"type":"object","properties":{"row":{"type":"string"},"positionNow":{"type":["integer","null"]},"bestPosition":{"type":"integer"},"secondsFeatured30d":{"type":"integer"},"stretches":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"position":{"type":"integer"}}}}}}},"totals30d":{"oneOf":[{"type":"null"},{"type":"object","properties":{"minutesPlayed":{"type":"integer"},"favorites":{"type":["integer","null"]},"plays":{"type":["integer","null"]},"recommendations":{"type":["integer","null"]},"days":{"type":"integer","description":"Complete UTC days counted."},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"coversWindow":{"type":"boolean","description":"False when FNTerminal's history of the island starts within the 30 days."}},"description":"Added up over the last 30 complete UTC days of FNTerminal's daily history (Epic keeps 7 days and gives no all-time total)."}]}},"required":["island"]},"Ecosystem":{"type":"object","properties":{"now":{"oneOf":[{"type":"null"},{"type":"object","properties":{"at":{"type":"string","format":"date-time"},"inMatch":{"type":["integer","null"]},"inClient":{"type":["integer","null"]},"comparedWith":{"type":"string"},"inMatchBefore":{"type":["integer","null"]},"todayPeakInMatch":{"type":["integer","null"]},"allTimePeakInMatch":{"type":["integer","null"]},"allTimePeakAt":{"type":["string","null"],"format":"date-time"}}}]},"creatorIslandsShare":{"type":"object","properties":{"day":{"type":["number","null"],"description":"Share of play on creator islands today."},"week":{"type":["number","null"],"description":"Over the last 7 days."}}},"today":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","format":"date-time"},"inMatch":{"type":["integer","null"]},"inClient":{"type":["integer","null"]}}}},"dailyPeaks":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string","format":"date"},"inMatch":{"type":["integer","null"]},"inClient":{"type":["integer","null"]}}}}}},"Heatmap":{"type":"object","properties":{"at":{"type":["string","null"],"format":"date-time","description":"Time of the latest reading."},"mode":{"type":"string","enum":["most","rising","falling"]},"genre":{"type":["string","null"]},"limit":{"type":"integer"},"count":{"type":"integer","description":"Islands in the response."},"genres":{"type":"array","description":"Biggest genre first.","items":{"type":"object","properties":{"genre":{"type":"string","description":"Genre slug (epic for Epic's own modes, other when unknown)."},"label":{"type":"string"},"players":{"type":"integer","description":"Players now on the islands listed."},"players24hAgo":{"type":["integer","null"],"description":"On the same islands 24 hours ago."},"change24h":{"type":["number","null"],"description":"Change over 24 hours (0.125 = +12.5%)."},"count":{"type":"integer"},"islands":{"type":"array","description":"Most players first.","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"image":{"type":"string","format":"uri","description":"256 px WebP thumbnail."},"players":{"type":"integer"},"players24hAgo":{"type":["integer","null"]},"change24h":{"type":["number","null"],"description":"Change over 24 hours."}}}}}}}},"required":["mode","limit","count","genres"]}}}}