R client for the Fortnite Ecosystem API, providing access to island metadata and engagement metrics.
# Install from GitHub
::install_github("econosopher/fortniteR")
devtools
# Or using pacman
if (!require(pacman)) install.packages("pacman")
::p_load_gh("econosopher/fortniteR") pacman
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.
library(fortniteR)
# Get list of islands
<- get_islands(limit = 50)
islands
# Get all islands with pagination (up to 1000)
<- get_all_islands()
all_islands
# Get specific island metadata
<- get_island_metadata("XXXX-XXXX-XXXX")
island_info
# Get island metrics (plays, retention, etc.)
<- get_island_metrics(
metrics code = "XXXX-XXXX-XXXX",
start_date = Sys.Date() - 7,
end_date = Sys.Date(),
interval = "day" # Options: "minute", "hour", "day"
)
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
Here’s an example of a GT table generated using real data from the Fortnite Ecosystem API:
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).
/islands
- Returns basic island metadata (code, name,
creator, platform, tags)/islands/{code}
- Returns detailed metadata for a
specific island/islands/{code}/metrics
- Returns engagement metrics
(plays, retention, etc.)