@yaelouuu/fortnite-api 4.6.0 → 5.1.0

package/dist/resources/cosmetics.js

@@ -22,6 +22,10 @@ class CosmeticsResource {
             queryParams.set("set", params.set);
         if (params?.search)
             queryParams.set("search", params.search);
+        if (params?.season)
+            queryParams.set("season", params.season.toString());
+        if (params?.chapter)
+            queryParams.set("chapter", params.chapter.toString());
         const query = queryParams.toString();
         const endpoint = query ? `/cosmetics/all?${query}` : "/cosmetics/all";
         return this.client.request(endpoint);

package/dist/resources/map.d.ts

@@ -5,14 +5,21 @@ export declare class MapResource {
     constructor(client: FortniteAPI);
     /**
      * Get current Fortnite map with POIs
+     * @param version - Optional specific map version to retrieve
      */
-    getCurrent(): Promise<MapResponse>;
+    getCurrent(version?: string): Promise<MapResponse>;
     /**
      * Get current map image URL
+     * @param version - Optional specific map version to retrieve
      */
-    getImage(): Promise<MapImageResponse>;
+    getImage(version?: string): Promise<MapImageResponse>;
     /**
      * Get historical map data
+     * @param options.chapter - Filter by chapter number
+     * @param options.season - Filter by season number
      */
-    getHistory(): Promise<MapHistoryResponse>;
+    getHistory(options?: {
+        chapter?: number;
+        season?: number;
+    }): Promise<MapHistoryResponse>;
 }

package/dist/resources/map.js

@@ -7,21 +7,33 @@ class MapResource {
     }
     /**
      * Get current Fortnite map with POIs
+     * @param version - Optional specific map version to retrieve
      */
-    async getCurrent() {
-        return this.client.request("/map");
+    async getCurrent(version) {
+        const query = version ? `?version=${encodeURIComponent(version)}` : "";
+        return this.client.request(`/map${query}`);
     }
     /**
      * Get current map image URL
+     * @param version - Optional specific map version to retrieve
      */
-    async getImage() {
-        return this.client.request("/map/image");
+    async getImage(version) {
+        const query = version ? `?version=${encodeURIComponent(version)}` : "";
+        return this.client.request(`/map/image${query}`);
     }
     /**
      * Get historical map data
+     * @param options.chapter - Filter by chapter number
+     * @param options.season - Filter by season number
      */
-    async getHistory() {
-        return this.client.request("/map/history");
+    async getHistory(options) {
+        const params = new URLSearchParams();
+        if (options?.chapter)
+            params.set("chapter", options.chapter.toString());
+        if (options?.season)
+            params.set("season", options.season.toString());
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.client.request(`/map/history${query}`);
     }
 }
 exports.MapResource = MapResource;

package/dist/resources/shop.d.ts

@@ -4,7 +4,17 @@ export declare class ShopResource {
     private client;
     constructor(client: FortniteAPI);
     /**
-     * Get current shop items
+     * Get current shop items with optional filtering
+     * @param options - Query options
+     * @param options.type - Filter by cosmetic type: outfit, emote, pickaxe, glider, backpack, wrap, music, loadingscreen, contrail, spray, toy, emoji, pet, bundle
+     * @param options.section - Filter by shop section name (e.g. "Featured", "Daily", "Kicks")
+     * @param options.rarity - Filter by rarity: common, uncommon, rare, epic, legendary, mythic
+     * @param options.search - Search items by name (e.g. "galaxy", "travis")
      */
-    getCurrent(): Promise<Shop>;
+    getCurrent(options?: {
+        type?: string;
+        section?: string;
+        rarity?: string;
+        search?: string;
+    }): Promise<Shop>;
 }

package/dist/resources/shop.js

@@ -6,10 +6,25 @@ class ShopResource {
         this.client = client;
     }
     /**
-     * Get current shop items
+     * Get current shop items with optional filtering
+     * @param options - Query options
+     * @param options.type - Filter by cosmetic type: outfit, emote, pickaxe, glider, backpack, wrap, music, loadingscreen, contrail, spray, toy, emoji, pet, bundle
+     * @param options.section - Filter by shop section name (e.g. "Featured", "Daily", "Kicks")
+     * @param options.rarity - Filter by rarity: common, uncommon, rare, epic, legendary, mythic
+     * @param options.search - Search items by name (e.g. "galaxy", "travis")
      */
-    async getCurrent() {
-        return this.client.request("/shop");
+    async getCurrent(options) {
+        const params = new URLSearchParams();
+        if (options?.type)
+            params.set("type", options.type);
+        if (options?.section)
+            params.set("section", options.section);
+        if (options?.rarity)
+            params.set("rarity", options.rarity);
+        if (options?.search)
+            params.set("search", options.search);
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.client.request(`/shop${query}`);
     }
 }
 exports.ShopResource = ShopResource;

package/dist/resources/tournaments.d.ts

@@ -4,17 +4,15 @@ export declare class TournamentsResource {
     private client;
     constructor(client: FortniteAPI);
     /**
-     * Get current events
-     * No parameters needed - uses API's default account
+     * Get currently active and upcoming tournaments, enriched with CMS metadata
      */
     getCurrent(): Promise<any>;
     /**
-     * Get past events
-     * No parameters needed - uses API's default account
+     * Get all tournaments including past ones, enriched with CMS metadata
      */
     getPast(): Promise<any>;
     /**
-     * Get global events with metadata
+     * Get global events with metadata (alias for getCurrent)
      */
     getGlobal(): Promise<any>;
     getSessions(params: {

package/dist/resources/tournaments.js

@@ -6,21 +6,19 @@ class TournamentsResource {
         this.client = client;
     }
     /**
-     * Get current events
-     * No parameters needed - uses API's default account
+     * Get currently active and upcoming tournaments, enriched with CMS metadata
      */
     async getCurrent() {
-        return this.client.request("/events/data/current");
+        return this.client.request("/events/global");
     }
     /**
-     * Get past events
-     * No parameters needed - uses API's default account
+     * Get all tournaments including past ones, enriched with CMS metadata
      */
     async getPast() {
-        return this.client.request("/events/data/past");
+        return this.client.request("/events/global/history");
     }
     /**
-     * Get global events with metadata
+     * Get global events with metadata (alias for getCurrent)
      */
     async getGlobal() {
         return this.client.request("/events/global");
@@ -43,7 +41,7 @@ class TournamentsResource {
             region: params.region,
             platform: params.platform,
         }).toString();
-        return this.client.request(`/events/download?${query}`, {
+        return this.client.request(`/events/player?${query}`, {
             headers: {
                 "x-fortnite-token": fortniteToken,
             },
@@ -78,7 +76,7 @@ class TournamentsResource {
                 },
             }
             : undefined;
-        return this.client.request(`/events/leaderboard?${query.toString()}`, options);
+        return this.client.request(`/events/global/leaderboard?${query.toString()}`, options);
     }
     /**
      * Get tournament participation history for a player

package/dist/resources/weapons.d.ts

@@ -1,19 +1,33 @@
 import { FortniteAPI } from "../client";
-import { WeaponsResponse } from "../types";
+import { WeaponsResponse, RarityDefinitionsResponse } from "../types";
 export declare class WeaponsResource {
     private client;
     constructor(client: FortniteAPI);
     /**
      * Get weapons data with optional filtering
      * @param options - Query options
-     * @param options.version - Version filter: "current" (current season), "all" (every weapon), "unversioned", or a specific version like "39.50"
-     * @param options.category - Filter by category: assault-rifles, shotguns, smgs, snipers, pistols, explosives, marksman-rifles, bows, crossbows, melee, light-machine-guns
+     * @param options.version - Version filter: "current" (loot pool), "all" (every weapon), or a specific patch like "39.50"
+     * @param options.category - Filter by category: assault-rifle, shotgun, smg, sniper, pistol, explosive, bow, crossbow, melee, light-machine-gun
      * @param options.search - Search weapons by name (e.g. "pump", "assault", "bolt")
-     * @returns Weapons response with metadata and data
+     * @param options.gamemode - Filter by gamemode: "br" (Battle Royale) or "og" (OG mode)
+     * @param options.rarity - Filter by rarity: common, uncommon, rare, epic, legendary, mythic, transcendent
+     * @param options.type - Filter by weapon type: ranged, melee, consumable, trap, gadget
+     * @param options.ammoType - Filter by ammo type: light, medium, heavy, shells, rockets, energy, arrows
+     * @param options.season - Filter by season availability: "CH6S7" or "6.7" format
+     * @returns Weapons response with metadata, availableSeasons, and weapon data
      */
     getWeapons(options?: {
         version?: string;
         category?: string;
         search?: string;
+        gamemode?: "br" | "og";
+        rarity?: string;
+        type?: string;
+        ammoType?: string;
+        season?: string;
     }): Promise<WeaponsResponse>;
+    /**
+     * Get rarity definitions (colors, display names, backend values)
+     */
+    getRarityDefinitions(): Promise<RarityDefinitionsResponse>;
 }

package/dist/resources/weapons.js

@@ -8,10 +8,15 @@ class WeaponsResource {
     /**
      * Get weapons data with optional filtering
      * @param options - Query options
-     * @param options.version - Version filter: "current" (current season), "all" (every weapon), "unversioned", or a specific version like "39.50"
-     * @param options.category - Filter by category: assault-rifles, shotguns, smgs, snipers, pistols, explosives, marksman-rifles, bows, crossbows, melee, light-machine-guns
+     * @param options.version - Version filter: "current" (loot pool), "all" (every weapon), or a specific patch like "39.50"
+     * @param options.category - Filter by category: assault-rifle, shotgun, smg, sniper, pistol, explosive, bow, crossbow, melee, light-machine-gun
      * @param options.search - Search weapons by name (e.g. "pump", "assault", "bolt")
-     * @returns Weapons response with metadata and data
+     * @param options.gamemode - Filter by gamemode: "br" (Battle Royale) or "og" (OG mode)
+     * @param options.rarity - Filter by rarity: common, uncommon, rare, epic, legendary, mythic, transcendent
+     * @param options.type - Filter by weapon type: ranged, melee, consumable, trap, gadget
+     * @param options.ammoType - Filter by ammo type: light, medium, heavy, shells, rockets, energy, arrows
+     * @param options.season - Filter by season availability: "CH6S7" or "6.7" format
+     * @returns Weapons response with metadata, availableSeasons, and weapon data
      */
     async getWeapons(options) {
         const params = new URLSearchParams();
@@ -21,8 +26,24 @@ class WeaponsResource {
             params.set("category", options.category);
         if (options?.search)
             params.set("search", options.search);
+        if (options?.gamemode)
+            params.set("gamemode", options.gamemode);
+        if (options?.rarity)
+            params.set("rarity", options.rarity);
+        if (options?.type)
+            params.set("type", options.type);
+        if (options?.ammoType)
+            params.set("ammoType", options.ammoType);
+        if (options?.season)
+            params.set("season", options.season);
         const query = params.toString() ? `?${params.toString()}` : "";
         return this.client.request(`/weapons${query}`, {}, "v2");
     }
+    /**
+     * Get rarity definitions (colors, display names, backend values)
+     */
+    async getRarityDefinitions() {
+        return this.client.request("/rarity", {}, "v2");
+    }
 }
 exports.WeaponsResource = WeaponsResource;

package/dist/types/index.d.ts

@@ -12,7 +12,7 @@ export interface CatalogEntry {
     offerId: string;
     devName: string;
     offerType: string;
-    prices: Price[];
+    prices: ShopPrice[];
     categories: string[];
     dailyLimit: number;
     weeklyLimit: number;
@@ -28,18 +28,57 @@ export interface CatalogEntry {
     shortDescription: string;
     description: string;
     displayAssetPath: string;
-    itemGrants: ItemGrant[];
+    itemGrants: EnrichedItemGrant[];
     giftInfo?: GiftInfo;
+    bundle: ShopBundle | null;
+    sectionId: string | null;
+    sectionDisplayName: string;
+    sectionPriority: number;
+    sectionBackground: string | null;
+    offerVisual: string | null;
+    tileSize: string | null;
 }
-export interface Price {
+export interface ShopPrice {
     currencyType: string;
-    currencySubType: string;
     regularPrice: number;
-    dynamicRegularPrice: number;
     finalPrice: number;
-    saleExpiration: string;
-    basePrice: number;
-    saleType?: string;
+    saleType: string | null;
+}
+export interface ShopBundle {
+    name: string | null;
+    info: string;
+    items: number;
+    regularPrice: number;
+    finalPrice: number;
+    discount: number | null;
+}
+export interface EnrichedItemGrant {
+    templateId: string;
+    quantity: number;
+    attributes: Record<string, any>;
+    cosmetic: CosmeticEnrichment | null;
+}
+export interface CosmeticEnrichment {
+    type: string;
+    name: string;
+    displayName: string;
+    description: string;
+    shortDescription: string;
+    rarity: string;
+    images: {
+        icon: string | null;
+        largeIcon: string | null;
+    };
+    gender: string | null;
+    tags: string[];
+    set: {
+        value: string;
+        backendValue: string;
+    } | null;
+    introduction: {
+        chapter: number | null;
+        season: number | null;
+    };
 }
 export interface Requirement {
     requirementType: string;
@@ -50,11 +89,6 @@ export interface MetaInfo {
     key: string;
     value: string;
 }
-export interface ItemGrant {
-    templateId: string;
-    quantity: number;
-    attributes: Record<string, any>;
-}
 export interface GiftInfo {
     bIsEnabled: boolean;
     forcedGiftBoxTemplateId: string;
@@ -180,17 +214,21 @@ export interface TournamentEligibilityResponse {
     newest_tournament_date: string | null;
     recent_tournaments: TournamentTrackerEntry[];
 }
+export interface SeasonEntry {
+    chapter: number;
+    season: number;
+    patch: string;
+}
 export interface WeaponsResponse {
     version: string;
     count: number;
-    source: "iesdev" | "lootpool" | "codenames" | "none";
-    codenames?: string[];
+    source: "cue4parse" | "lootpool" | "map-archives";
+    availableSeasons: SeasonEntry[];
     lootPool?: {
         patchVersion: string;
         lastUpdated: string;
         replaysProcessed: number;
     };
-    message?: string;
     data: Record<string, WeaponsInfos>;
 }
 /** @deprecated Use WeaponsResponse instead */
@@ -200,13 +238,22 @@ export interface WeaponsInfos {
     displayName: string;
     description: string;
     rarity: string;
-    gameplayTags: GameplayTags;
-    icon: string;
     type: string;
     category: string | null;
-    season: number | null;
-    unversioned: boolean;
-    series: string;
+    season: {
+        chapter: number;
+        season: number;
+    } | null;
+    introductionSeason: {
+        chapter: number;
+        season: number;
+    } | null;
+    seasons: SeasonEntry[];
+    gamemode: "br" | "og";
+    ammoType: string | null;
+    triggerType: string | null;
+    tags: string[];
+    searchTags: string;
     stats: WeaponsStats;
     images: {
         icon: string | null;
@@ -214,9 +261,6 @@ export interface WeaponsInfos {
         largeIcon: string | null;
     };
 }
-export interface GameplayTags {
-    gameplayTags: Array<String>;
-}
 export interface WeaponsStats {
     firingRate: number;
     dynamicFiringRate: number;
@@ -676,6 +720,18 @@ export interface CosmeticsSearchParams {
     rarity?: string;
     set?: string;
     search?: string;
+    season?: number;
+    chapter?: number;
+}
+export interface RarityDefinition {
+    value: string;
+    displayValue: string;
+    backendValue: string;
+    color: string;
+}
+export interface RarityDefinitionsResponse {
+    status: number;
+    data: RarityDefinition[];
 }
 export interface CrewPackResponse {
     status: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaelouuu/fortnite-api",
-  "version": "4.6.0",
+  "version": "5.1.0",
   "description": "SDK for Fortnite Tournaments API by Royal Arena - Author : Yael Brinkert",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",