Fortnite API: Get player count
Gets Fortnite players online now, the 24-hour and all-time in-match peaks, and the most-played islands with their creators. Optionally looks up one island by name or code.
Unofficial. Not affiliated with or endorsed by Fortnite.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Island optional
island Creative island or map name to look up, for example BERRY GARDEN TYCOON.
BERRY GARDEN TYCOON
- Island Code optional
island_code Creative island code instead of a name, for example 2557-3355-0240.
Not set
- Max Results optional
max_results Number of top islands to return, for example 10. Maximum 50.
10
Whole number from 1 to 50. Default
10.
Input as JSON
{ "island": "BERRY GARDEN TYCOON", "max_results": 10}Output
{ "island": { "link": "https://fortnite.gg/island/2557-3355-0240" , "name": "BERRY GARDEN TYCOON", "creator": "wanderer", "peak_24h": 3560, "island_code": "2557-3355-0240", "players_now": 1742, "all_time_peak": 10240 }, "peak_24h": 1196901, "top_islands": [ { "link": "https://fortnite.gg/island/experience_br" , "name": "Battle Royale", "creator": "epic", "island_code": null, "players_now": 254263 }, { "link": "https://fortnite.gg/island/experience_reload" , "name": "Reload", "creator": "epic", "island_code": null, "players_now": 59916 }, { "link": "https://fortnite.gg/island/experience_og" , "name": "Fortnite OG", "creator": "epic", "island_code": null, "players_now": 27812 } ], "all_time_peak": 14343880, "players_right_now": 978285, "all_time_peak_date": "2024-11-30"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"fortnite.gg/get_player_count","input":{"island":"BERRY GARDEN TYCOON","max_results":10}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "fortnite.gg/get_player_count" , "input": { "island": "BERRY GARDEN TYCOON", "max_results": 10 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "fortnite.gg/get_player_count" , "input": { "island": "BERRY GARDEN TYCOON", "max_results": 10 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run fortnite.gg/get_player_count# with {"island":"BERRY GARDEN TYCOON","max_results":10}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "island": { "type": "string", "description": "Creative island or map name to look up, for example BERRY GARDEN TYCOON." }, "island_code": { "type": "string", "description": "Creative island code instead of a name, for example 2557-3355-0240." }, "max_results": { "type": "integer", "default": 10, "maximum": 50, "minimum": 1, "description": "Number of top islands to return, for example 10. Maximum 50." } }}Output schema
{ "type": "object", "required": [ "players_right_now", "peak_24h", "all_time_peak", "all_time_peak_date", "top_islands", "island" ], "properties": { "island": { "anyOf": [ { "type": "object", "required": [ "name", "creator", "players_now", "link", "island_code", "peak_24h", "all_time_peak" ], "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "creator": { "type": [ "string", "null" ] }, "peak_24h": { "type": [ "integer", "null" ] }, "island_code": { "type": [ "string", "null" ] }, "players_now": { "type": [ "integer", "null" ] }, "all_time_peak": { "type": [ "integer", "null" ] } } }, { "type": "null" } ] }, "peak_24h": { "type": "integer", "description": "24-hour in-match peak." }, "top_islands": { "type": "array", "items": { "type": "object", "required": [ "name", "creator", "players_now", "link", "island_code" ], "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "creator": { "type": [ "string", "null" ] }, "island_code": { "type": [ "string", "null" ] }, "players_now": { "type": [ "integer", "null" ] } } } }, "all_time_peak": { "type": "integer", "description": "All-time in-match peak." }, "players_right_now": { "type": "integer", "description": "Players online now." }, "all_time_peak_date": { "type": "string", "format": "date" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
fortnite.gg/get_player_count- Returns
- players online now, 24-hour peak, all-time peak and date, top islands, one island's counts
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method fortnite.gg/get_player_count with the inputs above.
Ask your agent
- How many people are playing Fortnite right now, and what was the peak in the last 24 hours?
- Check fortnite.gg for the current player count on island code 4826-1093-7752
- What are the top 25 most-played Fortnite Creative maps right now and who made them?
- Pull up live player numbers for the Fortnite map PILLAR BOX FIGHTS from fortnite.gg
- What's Fortnite's all-time concurrent player record and when did it happen? Also list the 5 busiest islands.
See more
All Fortnite methodsGets the Fortnite.GG Item Shop for the current or a given day in shop order, with V-Bucks prices, item types, series and each item's previous shop date, 200 items per page. Past dates work only if the site shows that day's shop; cash-only packs have no V-Bucks price.
fortnite.gg/get_item_shopGets a Steam game's current players, 24-hour peak, all-time peak and monthly player-count history from SteamCharts. Takes a game name, SteamCharts or Steam store link, or Steam app ID.
store.steampowered.com/get_player_count_historyLists the games with the most players on Steam right now, with current and peak players and prices for a chosen country.
store.steampowered.com/list_most_playedGets a Roblox experience by name or game link, with players online, visits, likes, creator, dates, maturity rating and icon. For names with several matches, returns the match with the most players.
roblox.com/get_gameLists current and upcoming free games on the Epic Games Store for a country, with giveaway dates, usual price, publisher, cover image and store link.
store.epicgames.com/list_free_gamesLists the most-watched live Twitch streams, optionally within a category and language. All-category results are limited to 30 streams; category results allow up to 100.
twitch.tv/list_top_streamsLooks up an NHL player by name, link or ID and returns the profile with regular-season stats for a season and career totals.
nhl.com/get_player_statsLooks up a Premier League player by name and returns the profile and either career totals or the stats for a chosen season. If names clash, a current Premier League player is preferred.
premierleague.com/get_player_stats