x-ff-stalk

A lightweight Node.js library for retrieving public Free Fire account information using a player UID.

Features

• Fast Free Fire UID lookup
• Account information
• Rank & activity statistics
• Guild information
• Equipped items
• Pet information
• Promise-based API
• Node.js 18+

Installation

npm install x-ff-stalk

Usage

const stalkFF = require('x-ff-stalk')

async function main() {
  const result = await stalkFF('87980657')

  console.log(result)
}

main()

Example Response

{
  "success": true,
  "code": 200,
  "data": {
    "basic": {
      "uid": "87980657",
      "name": "Kyxzz",
      "level": 75,
      "region": "ID",
      "likes": 15000
    },
    "activity": {
      "last_login": "2026-06-10",
      "br_rank": "Heroic",
      "cs_rank": "Master"
    },
    "guild": {
      "name": "XYZ SQUAD",
      "id": "3000000000"
    }
  }
}

Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | uid | string | number | Yes | Free Fire player UID |

Return Structure

| Property | Description | |----------|-------------| | basic | Basic account information | | activity | Account activity and ranking data | | social | Social profile information | | overview | Profile showcase information | | equip | Equipped profile, character, outfit, weapon, and pet items | | pet | Active pet information | | guild | Guild details and leader information | | misc | Additional account metadata |

Error Response

UID Not Found

{
  "success": false,
  "code": 404,
  "message": "UID tidak ditemukan"
}

Request Failed

{
  "success": false,
  "code": 500,
  "message": "Internal Server Error"
}

Example

const stalkFF = require('x-ff-stalk')

const result = await stalkFF('87980657')

if (result.success) {
  console.log(result.data.basic.name)
  console.log(result.data.basic.level)
  console.log(result.data.guild.name)
} else {
  console.log(result.message)
}

Requirements

• Node.js >= 18

License

MIT © Xyraa