shan-ffapi

Unofficial Free Fire player data SDK for Node.js.
Search players, fetch profiles, stats, equipped items, and send likes — with auto-managed guest authentication.

npm install shan-ffapi

Quick start

const { FreeFireAPI } = require('shan-ffapi');

const api = new FreeFireAPI(); // auto-picks credentials from built-in pool
const profile = await api.getPlayerProfile('2216160076');
console.log(profile.basicinfo.nickname);

API

new FreeFireAPI(region?)

Region alias	Server
SG, BD, TH, VN, ID, MY, PH, ME	Singapore
IND, IN	India
RU, CIS	Russia
BR, US, NA, SAC	Brazil / Americas

Omit region to have the SDK pick credentials from any available pool.

---

api.getPlayerProfile(uid)

Returns the full raw decoded player profile (basicinfo, petinfo, clanbasicinfo, socialinfo, profileinfo, rankingleaderboardpos, etc.).

---

api.getPlayerItems(uid)

Returns structured equipped-item details with item metadata (name, rarity, image URL, …).

---

api.searchAccount(keyword)

Returns an array of matching player objects. Keyword must be ≥ 3 characters.

---

api.getPlayerStats(uid, mode?, matchType?)

Param	Options	Default
mode	'br' | 'cs'	'br'
matchType	'career' | 'ranked' | 'normal'	'career'

---

api.login(uid, password)

Authenticate with an explicit credential. Returns the session object.

---

api.register(region, nickname?)

Register a new guest account. Returns { uid, password, passwordHash, region, nickname }.

---

new LikeAPI()

const { LikeAPI } = require('shan-ffapi');
const likes = new LikeAPI();
const result = await likes.sendLikes('2216160076', 'BD', 10);
console.log(result.sent, 'likes sent');

---

Utilities

const { getItemDetails, processPlayerItems } = require('shan-ffapi');

Notes

• Built-in credential pool covers BD, SG, IND, and RU regions.
• Token sessions are reused across calls and refreshed automatically on 401.
• Current game version: OB54.

License

MIT