# 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.

- Page: https://fous.com/methods/fortnite.gg/get-player-count
- Method: `fortnite.gg/get_player_count`, version 1
- Website: fortnite.gg
- Returns: players online now, 24-hour peak, all-time peak and date, top islands, one island's counts
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `island` | string | no | `"BERRY GARDEN TYCOON"` | Creative island or map name to look up, for example BERRY GARDEN TYCOON. |
| `island_code` | string | no |  | Creative island code instead of a name, for example 2557-3355-0240. |
| `max_results` | integer | no | `10` | Number of top islands to return, for example 10. Maximum 50. Default 10. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "island": "BERRY GARDEN TYCOON",
  "max_results": 10
}
```

Its output:

```json
{
  "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"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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.

## Input schema

```json
{
  "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

```json
{
  "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"
    }
  }
}
```

## See more

- [Fortnite API: Get item shop](https://fous.com/methods/fortnite.gg/get-item-shop.md): Gets 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.
- [Steam API: Get player count history](https://fous.com/methods/store.steampowered.com/get-player-count-history.md): Gets 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.
- [Steam API: List most played games](https://fous.com/methods/store.steampowered.com/list-most-played.md): Lists the games with the most players on Steam right now, with current and peak players and prices for a chosen country.
- [Roblox API: Get game](https://fous.com/methods/roblox.com/get-game.md): Gets 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.
- [Epic Games API: List free games](https://fous.com/methods/store.epicgames.com/list-free-games.md): Lists current and upcoming free games on the Epic Games Store for a country, with giveaway dates, usual price, publisher, cover image and store link.
- [Twitch API: List top streams](https://fous.com/methods/twitch.tv/list-top-streams.md): Lists 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.
- [NHL API: Get player stats](https://fous.com/methods/nhl.com/get-player-stats.md): Looks up an NHL player by name, link or ID and returns the profile with regular-season stats for a season and career totals.
- [Premier League API: Get player stats](https://fous.com/methods/premierleague.com/get-player-stats.md): Looks 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.
- [All Fortnite methods](https://fous.com/methods/fortnite.gg.md)
