# FNTerminal

> Live analytics for every Fortnite Creative and UEFN island (players, rankings, retention, estimated earnings, Discover rows, update history), built on the official Fortnite Data API. A free public JSON API, with no key.

FNTerminal is an independent site, not affiliated with or endorsed by Epic Games. Data refreshes every 10 minutes. The API allows 120 requests per minute per IP and asks for a "Data: FNTerminal" link wherever its data is shown. Estimated earnings are a model based on playtime, not Epic's figures.

## API
- [OpenAPI 3.1 specification](https://fnterminal.live/api/v1/openapi.json): every endpoint, parameter and response field.
- [Integration brief for AI agents](https://fnterminal.live/llms-full.txt): rules, endpoints and a checklist for a coding agent (also on https://fnterminal.live/developers?tab=agents, in English and French).
- [Developer docs](https://fnterminal.live/developers): examples, live badges, embeddable widget, CSV exports.

## Endpoints
- [GET /api/v1/islands](https://fnterminal.live/api/v1/islands?sort=players&limit=10): list islands; sort=players|rising|falling|earnings|peak|plays|retention|newest, limit 1-200, offset, genre, tag, creator, q, minPlayers, epic.
- [GET /api/v1/islands/{code}](https://fnterminal.live/api/v1/islands/{code}): one island; series=6h|1d|1w|1m|3m|1y|all, metric=ccu|plays|uniq|minutes|avg_min|favs|recs|ret_d1|ret_d7|grank, include=media,versions,discover,totals.
- [GET /api/v1/ecosystem](https://fnterminal.live/api/v1/ecosystem): players in Fortnite right now, today's curve, daily peaks.
- [GET /api/v1/heatmap](https://fnterminal.live/api/v1/heatmap?mode=most&limit=100): the genre heatmap, live islands grouped by genre with players now and 24 hours ago; mode=most|rising|falling, genre, limit 1-600.

## Guides
- [Fortnite live stats: player counts and island rankings in real time](https://fnterminal.live/blog/fortnite-live-stats): Where to see live Fortnite stats: players right now, the most played islands, rising maps and records, updated every 10 minutes from Epic’s official data.
- [How many people are playing Fortnite right now?](https://fnterminal.live/blog/how-many-people-play-fortnite-right-now): The live number of Fortnite players right now, today’s peak and the record, with what “in a match” and “online” mean. Updated every 10 minutes.
- [The most played Fortnite maps right now (with codes)](https://fnterminal.live/blog/most-played-fortnite-maps-codes): The Fortnite creator maps with the most players right now, with their island codes and genres. A live list, refreshed every 10 minutes.
- [How much do Fortnite creators earn? Engagement payouts explained](https://fnterminal.live/blog/how-much-do-fortnite-creators-earn): How Fortnite pays island creators (engagement payouts), what decides the amount, and how to estimate what a map earns from its playtime.
- [Fortnite island stats explained: players, plays, retention and more](https://fnterminal.live/blog/fortnite-island-stats-explained): What every Fortnite island statistic means: concurrent players, plays, unique players, minutes played, retention, favourites and recommendations.
- [How Fortnite Discover works, and how to follow it](https://fnterminal.live/blog/how-fortnite-discover-works): What the Fortnite Discover screen is, how islands get into its rows, and how to see which maps it shows and for how long.
- [A free Fortnite stats API for every island (JSON, no key)](https://fnterminal.live/blog/free-fortnite-stats-api): Get live Fortnite island stats in JSON: players, rankings, retention, history and the genre heatmap. Free, no API key, CORS enabled.

## Optional
- [API terms of use](https://fnterminal.live/legal/terms#api)
- [How earnings are estimated](https://fnterminal.live/earnings#how)
- [Privacy policy](https://fnterminal.live/legal/privacy)
