Cosmetics
All Cosmetics
Get all Fortnite cosmetics across all categories.
Endpoint
GET /api/fortnite/cosmetics
Query Parameters
Language for cosmetic names and descriptions (e.g. en, de, fr, es, it, ja, ko, pl, pt-BR, ru, tr, zh-CN, zh-Hant).
Example Request
curl -X GET "https://rocks.rive.wtf/api/fortnite/cosmetics?language=en" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://rocks.rive.wtf/api/fortnite/cosmetics?language=en', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();
console.log(data);
import requests
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
response = requests.get(
'https://rocks.rive.wtf/api/fortnite/cosmetics',
headers=headers,
params={'language': 'en'}
)
print(response.json())
Response Example
{
"status": 200,
"data": {
"br": [ { "id": "CID_001", "name": "Recon Scout", "rarity": { "value": "rare" }, "images": { "icon": "https://..." } } ],
"tracks": [],
"instruments": [],
"cars": [],
"lego": [],
"legoKits": [],
"beans": []
}
}
New Cosmetics
Get the most recently added cosmetics.
Endpoint
GET /api/fortnite/cosmetics/new
Query Parameters
Language for cosmetic names and descriptions.
Response Example
{
"status": 200,
"data": {
"date": "2024-01-15T00:00:00Z",
"build": "28.10",
"previousBuild": "28.00",
"hashes": { "all": "abc123", "br": "def456" },
"items": { "br": [], "tracks": [], "instruments": [] }
}
}
Battle Royale Cosmetics
Get all Battle Royale cosmetics.
Endpoint
GET /api/fortnite/cosmetics/br
Query Parameters
Language for cosmetic names and descriptions.
Battle Royale Cosmetic by ID
Get a specific Battle Royale cosmetic by its ID.
Endpoint
GET /api/fortnite/cosmetics/br/{cosmetic_id}
Path Parameters
The unique cosmetic ID (e.g. CID_001_Athena_Commando_F_Default).
Query Parameters
Language for cosmetic names and descriptions.
Response Example
{
"status": 200,
"data": {
"id": "CID_001_Athena_Commando_F_Default",
"name": "Recon Scout",
"description": "A classic recon outfit.",
"type": { "value": "outfit", "displayValue": "Outfit" },
"rarity": { "value": "rare", "displayValue": "Rare" },
"images": {
"smallIcon": "https://...",
"icon": "https://...",
"featured": "https://..."
},
"added": "2018-07-25T00:00:00Z"
}
}
Search Battle Royale Cosmetic
Search for a single Battle Royale cosmetic by various filters.
Endpoint
GET /api/fortnite/cosmetics/br/search
Query Parameters
Language for cosmetic names and descriptions.
Cosmetic name to search for.
Cosmetic type (e.g. outfit, backpack, pickaxe).
Rarity value (e.g. legendary, epic, rare, uncommon, common).
Search Battle Royale Cosmetics (Multiple)
Search for multiple Battle Royale cosmetics matching filters.
Endpoint
GET /api/fortnite/cosmetics/br/search/all
Query Parameters
Same as Search Battle Royale Cosmetic above.
Track Cosmetics
Get all Festival track cosmetics.
Endpoint
GET /api/fortnite/cosmetics/tracks
Response Example
{
"status": 200,
"data": [
{
"id": "SparksSong_0001",
"title": "Example Song",
"artist": "Example Artist",
"releaseYear": 2023,
"bpm": 120,
"duration": 210,
"difficulty": { "vocals": 2, "guitar": 3, "bass": 2, "drums": 3 },
"genres": ["Pop"],
"albumArt": "https://..."
}
]
}
Instrument Cosmetics
Get all Festival instrument cosmetics.
Endpoint
GET /api/fortnite/cosmetics/instruments
Query Parameters
Language for cosmetic names and descriptions.
Car Cosmetics
Get all Rocket Racing car cosmetics.
Endpoint
GET /api/fortnite/cosmetics/cars
Query Parameters
Language for cosmetic names and descriptions.
LEGO Cosmetics
Get all LEGO Fortnite cosmetics.
Endpoint
GET /api/fortnite/cosmetics/lego
LEGO Kit Cosmetics
Get all LEGO kit cosmetics.
Endpoint
GET /api/fortnite/cosmetics/lego/kits
Query Parameters
Language for cosmetic names and descriptions.
Bean Cosmetics
Get all Fall Guys (Bean) cosmetics.
Endpoint
GET /api/fortnite/cosmetics/beans
Query Parameters
Language for cosmetic names and descriptions.
Shop
Item Shop
Get the current Fortnite item shop.
Endpoint
Query Parameters
Language for item names and descriptions.
Example Request
curl -X GET "https://rocks.rive.wtf/api/fortnite/shop" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://rocks.rive.wtf/api/fortnite/shop', {
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();
console.log(data);
import requests
response = requests.get(
'https://rocks.rive.wtf/api/fortnite/shop',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())
Response Example
{
"status": 200,
"data": {
"hash": "abc123",
"date": "2024-01-15T00:00:00Z",
"vbuckIcon": "https://...",
"entries": [
{
"regularPrice": 1500,
"finalPrice": 1500,
"offerId": "v2:/...",
"giftable": true,
"refundable": false,
"brItems": [
{ "id": "CID_001", "name": "Recon Scout", "images": { "icon": "https://..." } }
]
}
]
}
}
AES Keys
Get AES Keys
Get the current Fortnite AES encryption keys.
Endpoint
Query Parameters
Key format. Options: hex, base64.
Response Example
{
"status": 200,
"data": {
"build": "28.10",
"mainKey": "0x1234...",
"dynamicKeys": [
{ "pakFilename": "pakchunk10-WindowsClient.pak", "pakGuid": "...", "key": "0x..." }
],
"updated": "2024-01-15T00:00:00Z"
}
}
Banners
Get Banners
Get all Fortnite banners.
Endpoint
GET /api/fortnite/banners
Query Parameters
Language for banner names and descriptions.
Get Banner Colors
Get all available banner colors.
Endpoint
GET /api/fortnite/banners/colors
Response Example
{
"status": 200,
"data": [
{ "id": "DefaultColor1", "color": "#FFFFFF", "category": "primary", "subCategoryGroup": 1 }
]
}
Creator Code
Get Creator Code
Look up a Fortnite Support-a-Creator code.
Endpoint
GET /api/fortnite/creatorcode
Query Parameters
The creator code to look up.
Example Request
curl -X GET "https://rocks.rive.wtf/api/fortnite/creatorcode?name=epicgames" \
-H "Authorization: Bearer YOUR_API_KEY"
Response Example
{
"status": 200,
"data": {
"code": "epicgames",
"account": { "id": "abc123", "name": "Epic Games" },
"status": "ACTIVE",
"verified": true
}
}
Map
Get Map
Get the current Fortnite map with POI data.
Endpoint
Query Parameters
Response Example
{
"status": 200,
"data": {
"images": {
"blank": "https://...",
"pois": "https://..."
},
"pois": [
{ "id": "Athena_POI_01", "name": "Tilted Towers", "location": { "x": 0.5, "y": 0.4, "z": 0.0 } }
]
}
}
News
Get All News
Get Fortnite news for all modes.
Endpoint
Query Parameters
Language for news content.
Response Example
{
"status": 200,
"data": {
"br": { "hash": "abc", "date": "2024-01-15T00:00:00Z", "motds": [], "messages": [] },
"stw": { "hash": "def", "date": "2024-01-15T00:00:00Z", "motds": [], "messages": [] }
}
}
Get Battle Royale News
Get news specific to Battle Royale mode.
Endpoint
GET /api/fortnite/news/br
Query Parameters
Language for news content.
Get Save the World News
Get news specific to Save the World mode.
Endpoint
GET /api/fortnite/news/stw
Query Parameters
Language for news content.
Playlists
Get All Playlists
Get all available Fortnite playlists.
Endpoint
GET /api/fortnite/playlists
Query Parameters
Language for playlist names and descriptions.
Example Request
curl -X GET "https://rocks.rive.wtf/api/fortnite/playlists" \
-H "Authorization: Bearer YOUR_API_KEY"
Response Example
{
"status": 200,
"data": [
{
"id": "Playlist_DefaultSolo",
"name": "Solo",
"description": "Drop in, loot up, and be the last one standing.",
"minPlayers": 1,
"maxPlayers": 1,
"isTournament": false,
"isLimitedTimeMode": false,
"images": { "showcase": "https://...", "missionIcon": "https://..." },
"added": "2018-07-25T00:00:00Z"
}
]
}
Get Playlist by ID
Get a specific playlist by its ID.
Endpoint
GET /api/fortnite/playlists/{playlist_id}
Path Parameters
The unique playlist ID (e.g. Playlist_DefaultSolo).
Query Parameters
Language for playlist names and descriptions.
Error Handling
All endpoints return a consistent error structure when something goes wrong.
{
"error": "Request to https://fortnite-api.com/... failed: ..."
}
| HTTP Status | Meaning |
|---|
200 | Success |
400 | Bad request — missing or invalid parameters |
404 | Resource not found |
500 | Internal server error |
All endpoints support both GET and OPTIONS methods. CORS headers are included on every response, so these endpoints can be called directly from browser-based applications.
