Patch 6.2.0 is live — Clean up of duplicated endpoints & improvement of Typescript SDK.
api-fortnite
← Back to Blog

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.

cosmeticsskinsguide

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/all

Returns 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=Raven

Requires the q parameter. Supports the same type, rarity, set, page, pageSize, and lang filters as the all endpoint.


Newest Cosmetics


GET /api/v2/cosmetics/new

Returns 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


  • Cosmetics browser — Searchable catalog with type/rarity filters and item images
  • "What's new?" page — Use /api/v2/cosmetics/new to automatically surface this patch's additions
  • Chapter/season filter — Show all cosmetics introduced in a specific chapter using the chapter and season parameters
  • Set explorer — Group cosmetics by set name for a "collections" view

  • Performance Tips


  • Paginate with pageSize=25 or 50 — avoid fetching the entire catalog in one request.
  • Cache the catalog between patch days. Cosmetics are only added during game updates.
  • Use /api/v2/cosmetics/search for user-driven search, and /api/v2/cosmetics/all with filters for browse pages.

  • Related Guides


  • Fortnite Item Shop API - Complete Guide
  • Getting Started with the Fortnite API