fortniteR logo

fortniteR

R client for the Fortnite Ecosystem API, providing access to island metadata and engagement metrics.

Installation

# Install from GitHub
devtools::install_github("econosopher/fortniteR")

# Or using pacman
if (!require(pacman)) install.packages("pacman")
pacman::p_load_gh("econosopher/fortniteR")

Usage

IMPORTANT: This package uses real API data only. NO MOCK DATA is used.

The Fortnite Ecosystem API is PUBLIC and does NOT require authentication. The API documentation incorrectly mentions OAuth2, but all endpoints work without any authentication.

Fetching Island Data

library(fortniteR)

# Get list of islands
islands <- get_islands(limit = 50)

# Get all islands with pagination (up to 1000)
all_islands <- get_all_islands()

# Get specific island metadata
island_info <- get_island_metadata("XXXX-XXXX-XXXX")

# Get island metrics (plays, retention, etc.)
metrics <- get_island_metrics(
  code = "XXXX-XXXX-XXXX",
  start_date = Sys.Date() - 7,
  end_date = Sys.Date(),
  interval = "day"  # Options: "minute", "hour", "day"
)

Creating Visualizations

The package includes a script to create beautiful GT tables from the API data:

# Run this script to generate the top 10 islands table
Rscript scripts/01_top_10_islands_table.R

Example Output

Here’s an example of a GT table generated using real data from the Fortnite Ecosystem API:

Top Fortnite Creative Islands

This table shows the top performing Fortnite Creative Islands ranked by unique players, displaying comprehensive engagement metrics (unique players, total plays, average play time, peak CCU) and retention data (D1 and D7 retention rates).

Features

API Endpoints

API Limitations