Fortnite API
Competitive events, live leaderboards, player earnings, shop, cosmetics, and news
Endpoints
/api/v1/fortniteDiscover supported Fortnite endpoints and current limitations
/api/v1/fortnite/matches/liveReturns active competitive events with optional live leaderboard rows
/api/v1/fortnite/tournamentsList historical, upcoming, and completed Fortnite tournaments
/api/v1/fortnite/tournaments/liveGet live competitive tournament windows and leaderboards
/api/v1/fortnite/tournaments/{id}/resultsGet tournament result rows when available
/api/v1/fortnite/players/top-earnersGet highest-earning competitive Fortnite players
/api/v1/fortnite/players/{identifier}Get a player profile, earnings, and tournament history
/api/v1/fortnite/shopGet current item shop data
/api/v1/fortnite/cosmeticsSearch cosmetics by type, rarity, or name
/api/v1/fortnite/newsGet Battle Royale, Save the World, or Creative news
Live Competitive Events
/api/v1/fortnite/matches/liveReturns currently active Fortnite competitive events. Match routes are aliases for tournament/event data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
includeLeaderboard | boolean | No | Set false to return live events without leaderboard rows |
limit | integer | No | Results per request where supported |
offset | integer | No | Pagination offset where supported |
region | string | No | Filter historical tournaments by region where supported |
year | integer | No | Filter historical tournaments by year where supported |
Example Request
curl -X GET "https://api.citoapi.com/api/v1/fortnite/matches/live?includeLeaderboard=true" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json"Example Response
{
"success": true,
"count": 1,
"data": [
{
"eventId": "epicgames_S37_FNCS",
"eventWindowId": "epicgames_S37_FNCS_Event1",
"name": "FNCS Major",
"regions": ["NAE", "EU"],
"startTime": "2026-04-29T18:00:00.000Z",
"endTime": "2026-04-29T21:00:00.000Z",
"isLive": true,
"leaderboardCount": 100,
"leaderboard": [
{
"rank": 1,
"displayName": "player_name",
"accountId": "account-id",
"score": 532,
"kills": 141,
"matchesPlayed": 10
}
]
}
]
}Player And Earnings Data
/api/v1/fortnite/players/{identifier}Get competitive player profiles, tournament history, and earnings data from the Fortnite database.
Example Response
{
"success": true,
"data": {
"id": "player-id",
"name": "Bugha",
"country": "United States",
"currentTeam": "Dignitas",
"totalEarnings": 3402100,
"tournaments": [
{
"name": "FNCS Major",
"placement": 1,
"earnings": 50000,
"date": "2026-04-20T00:00:00.000Z"
}
]
}
}Next