@yaelouuu/fortnite-api 9.1.1 → 9.2.0

package/README.md

@@ -47,16 +47,17 @@ const leaderboard = await client.tournaments.getLeaderboard({
 
 ### Shop
 
-Access the Fortnite Item Shop and Battle Pass data.
+Access the current Fortnite Item Shop.
 
 ```typescript
 // Get current item shop
 const shop = await client.shop.getCurrent();
-
-// Get current Battle Pass
-const battlePass = await client.battlepass.getBattlePass();
 ```
 
+> `client.battlepass.getBattlePass()` is deprecated: the endpoint behind it
+> (`/api/v1/shop/battlepass`) never returned the Battle Pass, only Epic's legacy 2021 news block.
+> For the Battle Pass call `GET /api/v2/battlepass`.
+
 ---
 
 ### Tournaments
@@ -158,7 +159,7 @@ if (session.inMatch && session.playlist === "playlist_showdown_cts_solo") {
 }
 ```
 
-Read before building on it: the token flow authenticates as the Fortnite client, not as your application — Epic warns the player accordingly, and if you ship an Epic Account Services application its developer terms do not allow routing your users through it (suited to tools a player runs for themselves, not third-party apps asking other players to log in); the token must be that player's **own** (verified — any other account's token is `403`); Fortnite kills every other session of an account when the game launches, so mint it from stored device auth (`/oauth/link`, then `/oauth/refresh-device` on `401`); the response is cached 10 s per account and Epic's party state lags the real match by about 1–2 minutes; the custom key is never returned (`hasCustomKey` only) and teammates appear as account ids only.
+Read before building on it: the token flow authenticates as the Fortnite client, not as your application — Epic warns the player accordingly, and if you ship an Epic Account Services application its developer terms do not allow routing your users through it (suited to tools a player runs for themselves, not third-party apps asking other players to log in); the token must be that player's **own** (verified — any other account's token is `403`); Fortnite kills every other session of an account when the game launches, so store the `deviceAuth` that `/oauth/complete` returns and re-authenticate with `/oauth/refresh-device` on `401`; the response is cached 10 s per account and Epic's party state lags the real match by about 1–2 minutes; the custom key is never returned (`hasCustomKey` only) and teammates appear as account ids only.
 
 #### Check Tournament Eligibility
 Verify if a player meets requirements for major tournaments (e.g., 14 tournaments in 180 days):
@@ -438,26 +439,34 @@ const psnAuth = await client.account.getExternalAuth('accountId123', 'psn');
 
 ---
 
-### News - **NEW**
+### News
 
-Get Fortnite news and announcements for all game modes.
+The in-game lobby news carousel (Epic's "message of the day"), fetched live from Epic as a
+generic account and cached 10 minutes, plus the emergency notices. Pro and Custom plans.
 
 ```typescript
-// Get Battle Royale news
-const brNews = await client.news.getBRNews();
-// Returns: MOTDs, platform messages, images, and videos
+// Battle Royale lobby news — optional language and platform (default en / Windows)
+const br = await client.news.getBRNews();
+const brFr = await client.news.getBRNews("fr", "PS5");
+// br.motds[0] → { id, position, title, body, tileTitle, image, tileImage,
+//                  images, tileImages, buttons: [{ text, action, offerId, linkId }], contentHash }
+
+// Fortnite Festival has its own rotation
+const festival = await client.news.getFestivalNews();
 
-// Get Save The World news
-const stwNews = await client.news.getSTWNews();
+// Save the World / Creative: Epic currently serves its general lobby rotation for both
+const stw = await client.news.getSTWNews();
+const creative = await client.news.getCreativeNews();
 
-// Get Creative news
-const creativeNews = await client.news.getCreativeNews();
+// Emergency notices (warning banners), e.g. a mode leaving
+const notices = await client.news.getNotices();
 
-// Get all news at once
-const allNews = await client.news.getAllNews();
-// Returns: { br, stw, creative, lastModified }
+// Everything at once: { br, stw, creative, festival, notices }
+const all = await client.news.getAllNews("en", "Android");
 ```
 
+Epic personalises the carousel per player, so a real account may see a slightly different set.
+
 ---
 
 ### Cosmetics - **NEW**
@@ -736,6 +745,14 @@ MIT
 
 ## 🆕 Changelog
 
+### v9.2.0 (2026-09-27)
+- 🐛 **News now returns the live lobby news.** `/api/v1/news*` used to return Epic's legacy CMS
+  news blocks, which Epic stopped updating in 2020–2023. They now return the carousel the game
+  shows today, with a new shape (`NewsFeed`: `motds[]` with title, body, images, shop/island
+  buttons). The old `NewsResponse`/`BRNews`/`STWNews`/`CreativeNews` types are deprecated aliases.
+- ✨ `news.getFestivalNews()`, `news.getNotices()`; every news method takes an optional `platform`.
+- ⚠️ `battlepass.getBattlePass()` deprecated — its endpoint never returned the Battle Pass.
+
 ### v4.3.0 (2026-01-08)
 - ✨ **NEW** `NewsResource` with 4 methods:
   - Battle Royale news

package/dist/resources/battlepass.d.ts

@@ -4,7 +4,10 @@ export declare class BattlePassResource {
     private client;
     constructor(client: FortniteAPI);
     /**
-     * Get current Battle Pass content and rewards
+     * @deprecated Despite its name, GET /api/v1/shop/battlepass never returned the Battle Pass:
+     * it returns Epic's legacy "battleroyalenews" CMS block, which Epic stopped updating in 2021.
+     * For current lobby news use `client.news.getBRNews()`; for the Battle Pass call
+     * GET /api/v2/battlepass.
      * @param lang - Language code (default: en)
      */
     getBattlePass(lang?: string): Promise<BattlePass>;

package/dist/resources/battlepass.js

@@ -6,7 +6,10 @@ class BattlePassResource {
         this.client = client;
     }
     /**
-     * Get current Battle Pass content and rewards
+     * @deprecated Despite its name, GET /api/v1/shop/battlepass never returned the Battle Pass:
+     * it returns Epic's legacy "battleroyalenews" CMS block, which Epic stopped updating in 2021.
+     * For current lobby news use `client.news.getBRNews()`; for the Battle Pass call
+     * GET /api/v2/battlepass.
      * @param lang - Language code (default: en)
      */
     async getBattlePass(lang) {

package/dist/resources/news.d.ts

@@ -1,26 +1,34 @@
 import { FortniteAPI } from "../client";
-import { NewsResponse, BRNews, STWNews, CreativeNews, AllNews } from "../types";
+import { NewsFeed, NewsNotice, NewsPlatform, AllNews } from "../types";
+/**
+ * The in-game lobby news carousel, fetched live from Epic as a generic account (no Battle
+ * Pass, US / NA-East) and cached 10 minutes. Epic personalises the carousel per player, so a
+ * real account may see a slightly different set. Pro and Custom plans.
+ */
 export declare class NewsResource {
     private client;
     constructor(client: FortniteAPI);
+    private query;
     /**
-     * Get Battle Royale news
+     * Battle Royale lobby news
      * @param lang - Language code (default: en)
+     * @param platform - Platform (default: Windows); Epic varies some entries by platform
      */
-    getBRNews(lang?: string): Promise<NewsResponse<BRNews>>;
+    getBRNews(lang?: string, platform?: NewsPlatform | string): Promise<NewsFeed>;
     /**
-     * Get Save The World news
-     * @param lang - Language code (default: en)
+     * Lobby news Epic serves for Save the World. As of September 2026 Epic runs no separate
+     * rotation for it: this is Epic's general lobby rotation (same entries as getCreativeNews).
      */
-    getSTWNews(lang?: string): Promise<NewsResponse<STWNews>>;
+    getSTWNews(lang?: string, platform?: NewsPlatform | string): Promise<NewsFeed>;
     /**
-     * Get Creative news
-     * @param lang - Language code (default: en)
-     */
-    getCreativeNews(lang?: string): Promise<NewsResponse<CreativeNews>>;
-    /**
-     * Get all news (BR, STW, Creative)
-     * @param lang - Language code (default: en)
+     * Lobby news Epic serves for Creative. As of September 2026 Epic runs no separate rotation
+     * for it: this is Epic's general lobby rotation (same entries as getSTWNews).
      */
-    getAllNews(lang?: string): Promise<NewsResponse<AllNews>>;
+    getCreativeNews(lang?: string, platform?: NewsPlatform | string): Promise<NewsFeed>;
+    /** Fortnite Festival lobby news. */
+    getFestivalNews(lang?: string, platform?: NewsPlatform | string): Promise<NewsFeed>;
+    /** Current emergency notices (in-game warning banners). Empty when Epic has none up. */
+    getNotices(lang?: string): Promise<NewsNotice[]>;
+    /** Every mode's lobby news plus the emergency notices, in one call. */
+    getAllNews(lang?: string, platform?: NewsPlatform | string): Promise<AllNews>;
 }

package/dist/resources/news.js

@@ -1,41 +1,57 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NewsResource = void 0;
+/**
+ * The in-game lobby news carousel, fetched live from Epic as a generic account (no Battle
+ * Pass, US / NA-East) and cached 10 minutes. Epic personalises the carousel per player, so a
+ * real account may see a slightly different set. Pro and Custom plans.
+ */
 class NewsResource {
     constructor(client) {
         this.client = client;
     }
-    /**
-     * Get Battle Royale news
-     * @param lang - Language code (default: en)
-     */
-    async getBRNews(lang) {
-        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
-        return this.client.request(`/news/br${query}`);
+    query(lang, platform) {
+        const params = new URLSearchParams();
+        if (lang)
+            params.set("lang", lang);
+        if (platform)
+            params.set("platform", platform);
+        const q = params.toString();
+        return q ? `?${q}` : "";
     }
     /**
-     * Get Save The World news
+     * Battle Royale lobby news
      * @param lang - Language code (default: en)
+     * @param platform - Platform (default: Windows); Epic varies some entries by platform
      */
-    async getSTWNews(lang) {
-        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
-        return this.client.request(`/news/stw${query}`);
+    async getBRNews(lang, platform) {
+        return this.client.request(`/news/br${this.query(lang, platform)}`);
     }
     /**
-     * Get Creative news
-     * @param lang - Language code (default: en)
+     * Lobby news Epic serves for Save the World. As of September 2026 Epic runs no separate
+     * rotation for it: this is Epic's general lobby rotation (same entries as getCreativeNews).
      */
-    async getCreativeNews(lang) {
-        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
-        return this.client.request(`/news/creative${query}`);
+    async getSTWNews(lang, platform) {
+        return this.client.request(`/news/stw${this.query(lang, platform)}`);
     }
     /**
-     * Get all news (BR, STW, Creative)
-     * @param lang - Language code (default: en)
+     * Lobby news Epic serves for Creative. As of September 2026 Epic runs no separate rotation
+     * for it: this is Epic's general lobby rotation (same entries as getSTWNews).
      */
-    async getAllNews(lang) {
-        const query = lang ? `?lang=${encodeURIComponent(lang)}` : "";
-        return this.client.request(`/news${query}`);
+    async getCreativeNews(lang, platform) {
+        return this.client.request(`/news/creative${this.query(lang, platform)}`);
+    }
+    /** Fortnite Festival lobby news. */
+    async getFestivalNews(lang, platform) {
+        return this.client.request(`/news/festival${this.query(lang, platform)}`);
+    }
+    /** Current emergency notices (in-game warning banners). Empty when Epic has none up. */
+    async getNotices(lang) {
+        return this.client.request(`/news/notices${this.query(lang)}`);
+    }
+    /** Every mode's lobby news plus the emergency notices, in one call. */
+    async getAllNews(lang, platform) {
+        return this.client.request(`/news${this.query(lang, platform)}`);
     }
 }
 exports.NewsResource = NewsResource;

package/dist/resources/tournaments.d.ts

@@ -282,8 +282,8 @@ export declare class TournamentsResource {
      * Requires that player's OWN Fortnite token: it is verified against `accountId` before
      * anything is forwarded (any other account's token returns **403**). Fortnite kills every
      * other session of an account when the game launches, so a token obtained before the
-     * player started playing is dead by the time they play — obtain it from stored device
-     * auth (`/oauth/link` once, then `/oauth/refresh-device` on 401), not a one-off login.
+     * player started playing is dead by the time they play — store the `deviceAuth` that
+     * `/oauth/complete` returns and re-authenticate with `/oauth/refresh-device` on 401.
      *
      * While the player is in a game, `sessionId` is the replay match ID: pass it to the
      * replay endpoints once the match has ended. `playlist` lets you filter (e.g. scrims)

package/dist/resources/tournaments.js

@@ -375,8 +375,8 @@ class TournamentsResource {
      * Requires that player's OWN Fortnite token: it is verified against `accountId` before
      * anything is forwarded (any other account's token returns **403**). Fortnite kills every
      * other session of an account when the game launches, so a token obtained before the
-     * player started playing is dead by the time they play — obtain it from stored device
-     * auth (`/oauth/link` once, then `/oauth/refresh-device` on 401), not a one-off login.
+     * player started playing is dead by the time they play — store the `deviceAuth` that
+     * `/oauth/complete` returns and re-authenticate with `/oauth/refresh-device` on 401.
      *
      * While the player is in a game, `sessionId` is the replay match ID: pass it to the
      * replay endpoints once the match has ended. `playlist` lets you filter (e.g. scrims)

package/dist/types/index.d.ts

@@ -887,38 +887,77 @@ export interface EventRewards {
         currency?: string;
     }>;
 }
-export interface NewsResponse<T> {
-    status: number;
-    data: T;
+/** Platforms accepted by the news endpoints (aliases pc, playstation, xbox also work). */
+export type NewsPlatform = "Windows" | "Mac" | "PS4" | "PS5" | "XboxOneGDK" | "XSX" | "Switch" | "Switch2" | "Android" | "IOS";
+export interface NewsImage {
+    width: number;
+    height: number;
+    url: string;
+}
+/**
+ * A call-to-action button. `action` is "shop" (see `offerId`), "island" (see `linkId`: an
+ * island code like "0017-2877-1308" or a playlist id like "playlist_juno"), or Epic's raw
+ * action type when it is neither.
+ */
+export interface NewsButton {
+    text: string | null;
+    action: "shop" | "island" | string;
+    offerId: string | null;
+    linkId: string | null;
 }
+/** One entry of the lobby news carousel. */
 export interface MOTD {
     id: string;
-    title: string;
-    body: string;
-    image: string;
-    tileImage?: string;
-    videoURL?: string;
-    [key: string]: any;
-}
-export interface BRNews {
+    position: number;
+    /** Full-screen title. */
+    title: string | null;
+    /** Full-screen body text. */
+    body: string | null;
+    /** Title shown on the carousel tile. */
+    tileTitle: string | null;
+    /** Largest full-screen image. */
+    image: string | null;
+    /** Largest tile image. */
+    tileImage: string | null;
+    images: NewsImage[];
+    tileImages: NewsImage[];
+    buttons: NewsButton[];
+    contentHash: string | null;
+}
+/** The lobby news carousel for one mode, as a generic account sees it. */
+export interface NewsFeed {
+    mode: "br" | "stw" | "creative" | "festival";
+    /** Epic product tag queried, e.g. "Product.BR". */
+    tag: string;
+    language: string;
+    platform: NewsPlatform;
+    fetchedAt: string;
     motds: MOTD[];
-    platform_motds?: MOTD[];
-    [key: string]: any;
 }
-export interface STWNews {
-    motds: MOTD[];
-    [key: string]: any;
-}
-export interface CreativeNews {
-    motds: MOTD[];
-    [key: string]: any;
+/** An in-game emergency notice banner. */
+export interface NewsNotice {
+    title: string | null;
+    body: string | null;
+    /** Playlists or experiences the notice is shown in. */
+    playlists: string[];
+    /** When present, the notice is limited to these platforms. */
+    platforms: string[] | null;
 }
 export interface AllNews {
-    br: BRNews;
-    stw: STWNews;
-    creative: CreativeNews;
-    lastModified: string;
-}
+    br: NewsFeed;
+    stw: NewsFeed;
+    creative: NewsFeed;
+    festival: NewsFeed;
+    notices: NewsNotice[];
+}
+/** @deprecated The API never wrapped news in { status, data }; this is now just `T`. */
+export type NewsResponse<T> = T;
+/** @deprecated Use NewsFeed. */
+export type BRNews = NewsFeed;
+/** @deprecated Use NewsFeed. */
+export type STWNews = NewsFeed;
+/** @deprecated Use NewsFeed. */
+export type CreativeNews = NewsFeed;
 export interface CosmeticsResponse<T> {
     status: number;
     data: T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaelouuu/fortnite-api",
-  "version": "9.1.1",
+  "version": "9.2.0",
   "description": "SDK for Fortnite API - api-fortnite.com - Author : Yael Brinkert",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",