Fortnite Cosmetics API - Browse Skins, Emotes & More
Learn how to use the Fortnite API to browse the full cosmetics catalog. Filter by type, rarity, set, chapter/season, and search by name.
The Fortnite Cosmetics Catalog
Fortnite has thousands of cosmetic items — outfits, back blings, harvesting tools, gliders, emotes, sprays, wraps, and more. The Fortnite API gives you paginated, filterable access to the entire catalog.
Base URL: https://prod.api-fortnite.com
Auth: x-api-key: YOUR_API_KEY
Cosmetics Endpoints
Get All Cosmetics
GET /api/v2/cosmetics/allReturns the full catalog, paginated. Available query parameters:
| Parameter | Description |
|-----------|-------------|
| page | Page number (default: 1) |
| pageSize | Items per page (default: 25) |
| type | Item type (e.g. outfit, emote, pickaxe) |
| rarity | Rarity (e.g. legendary, epic, rare) |
| set | Cosmetic set name |
| search | Filter by name |
| season | Season number |
| chapter | Chapter number |
| lang | Language code |
Search Cosmetics
GET /api/v2/cosmetics/search?q=RavenRequires the q parameter. Supports the same type, rarity, set, page, pageSize, and lang filters as the all endpoint.
Newest Cosmetics
GET /api/v2/cosmetics/newReturns the most recently added cosmetics. Useful for "new this patch" features. Supports page, pageSize, and lang.
Get a Single Cosmetic
GET /api/v2/cosmetics/{id}Returns full details for a specific item by its internal ID. Supports lang.
Example: Filter Legendary Outfits
const res = await fetch(
"https://prod.api-fortnite.com/api/v2/cosmetics/all?type=outfit&rarity=legendary&pageSize=50",
{ headers: { "x-api-key": process.env.FORTNITE_API_KEY } }
);
const { data } = await res.json();
data.items.forEach((skin) => {
console.log(`${skin.name} (set: ${skin.set ?? "none"})`);
});Example: Search by Name
const res = await fetch(
"https://prod.api-fortnite.com/api/v2/cosmetics/search?q=Raven&lang=en",
{ headers: { "x-api-key": process.env.FORTNITE_API_KEY } }
);
const { data } = await res.json();Common Use Cases
/api/v2/cosmetics/new to automatically surface this patch's additionschapter and season parametersPerformance Tips
pageSize=25 or 50 — avoid fetching the entire catalog in one request./api/v2/cosmetics/search for user-driven search, and /api/v2/cosmetics/all with filters for browse pages.