Player Info API Docs - FAST API HUB

Base URL

https://api.teamfast.shop/api.php

Authentication

All API requests require an API key. You can pass it via:

Query Parameter: ?key=YOUR_API_KEY
Header: X-API-Key: YOUR_API_KEY

Endpoint

GET /api.php?uid=UID&region=BD&key=API_KEY

Parameters

Parameter	Type	Required	Description
uid	string	Yes	Free Fire player UID (numbers only)
region	string	No	Server region code, e.g. `BD`, `IND`, `SG`. Default: `BD`
key	string	Yes	Your API key

Example Request

https://api.teamfast.shop/api.php?uid=3077799485&region=BD&key=DXR-XXXXXXXX

Success Response

{
  "status": true,
  "data": {
    "username": "ᏩᎱ̵ㄨ　Ｒ么ʜᴜᏞ　모",
    "region": "BD",
    "developer": "Developer Tg: @TFDEV_X_TASKIN",
    "basicInfo": {
      "accountId": "3077799485",
      "nickname": "ᏩᎱ̵ㄨ　Ｒ么ʜᴜᏞ　모",
      "level": 58,
      "exp": 781040,
      "liked": 4173,
      "region": "BD",
      "rank": 301,
      "maxRank": 301,
      "rankingPoints": 1000,
      "csRank": 301,
      "csMaxRank": 301,
      "createAt": "1619592599",
      "lastLoginAt": "1785472139",
      "releaseVersion": "OB54",
      "seasonId": 53,
      "badgeId": 1001000101,
      "bannerId": 901000171,
      "headPic": 902000123,
      "title": 904490053,
      "weaponSkinShows": [907194202]
    },
    "captainBasicInfo": {
      "accountId": "2920302201",
      "nickname": "—͟͞ʜꫝ፝֟sᴀɴᥫ᭡",
      "level": 67,
      "liked": 7425,
      "rank": 325,
      "maxRank": 325,
      "rankingPoints": 5740,
      "csRank": 314,
      "...": "..."
    },
    "clanBasicInfo": {
      "clanId": "3084110383",
      "clanName": "ᴹᴮメᎬ-ꮪꮲꭷꮢꭲꮪ",
      "clanLevel": 2,
      "captainId": "2920302201",
      "memberNum": 24,
      "capacity": 35
    },
    "creditScoreInfo": {
      "creditScore": 100,
      "periodicSummaryEndTime": "1791717121",
      "rewardState": "REWARD_STATE_UNCLAIMED"
    },
    "diamondCostRes": { "diamondCost": 390 },
    "petInfo": {
      "id": 1300000118,
      "level": 7,
      "exp": 6000,
      "isSelected": true,
      "selectedSkillId": 1315000017,
      "skinId": 1310000182
    },
    "profileInfo": {
      "avatarId": 102000007,
      "clothes": [214039004, 211000860, 211001161, 204000181, 205041039, 203034021],
      "equipedSkills": [16, 706, 8, 1, 16, 606, 8, 2, 16, 1206, 8, 3, 16, 1805],
      "isSelected": true,
      "isSelectedAwaken": true,
      "skinColor": 50
    },
    "socialInfo": {
      "accountId": "3077799485",
      "gender": "Gender_MALE",
      "language": "Language_EN",
      "modePrefer": "ModePrefer_CS",
      "rankShow": "RankShow_CS",
      "signature": "GFX RAHUL",
      "timeActive": "TimeActive_AFTERNOON",
      "battleTag": ["PlayerBattleTagID_BESTPARTNER", "PlayerBattleTagID_PEACEMAKER"],
      "battleTagCount": [84, 419],
      "socialTag": ["SocialTag_NEWBIE", "SocialTag_PLAYFORFUN"]
    }
  }
}

Note: username (same as basicInfo.nickname) is kept for backward compatibility with older clients.

Error Response

{
  "status": false,
  "message": "Invalid or inactive API Key"
}

Response Fields

Object	Contains
`basicInfo`	Player profile: accountId, nickname, level, exp, liked, region, BR rank (`rank`, `maxRank`, `rankingPoints`), CS rank (`csRank`, `csMaxRank`), createAt / lastLoginAt (unix time), releaseVersion, seasonId, badge / banner / headPic / title IDs, weaponSkinShows
`captainBasicInfo`	Guild leader's profile (same style as basicInfo)
`clanBasicInfo`	Guild: clanId, clanName, clanLevel, captainId, memberNum, capacity
`creditScoreInfo`	creditScore, periodicSummaryEndTime, rewardState
`diamondCostRes`	diamondCost
`petInfo`	Selected pet: id, level, exp, skinId, selectedSkillId, isSelected
`profileInfo`	Avatar, clothes, equipped skills, skinColor
`socialInfo`	signature (bio), gender, language, modePrefer, rankShow, timeActive, battleTag, socialTag

Some objects (e.g. clanBasicInfo, petInfo) may be missing if the player has no guild / pet. Always check before reading them. Time fields like createAt and lastLoginAt are Unix timestamps (seconds).

Error Messages

message	Meaning
API Key is required	`key` missing
UID is required	`uid` missing
Invalid or inactive API Key	Wrong key or key disabled
API Key has expired	Plan expired - renew your key
Request limit exceeded	Plan request limit used up
UID not found / invalid	No player found for this UID in the given region (try another `region`)
Upstream error / Invalid response from upstream	Info server is temporarily unreachable - retry later

Code Examples

JavaScript (Fetch)

fetch('https://api.teamfast.shop/api.php?uid=3077799485&region=BD&key=YOUR_KEY')
  .then(res => res.json())
  .then(res => {
    if (!res.status) return console.error(res.message);
    const p = res.data.basicInfo;
    console.log(p.nickname, 'Lv', p.level, 'Likes', p.liked);
    console.log('Guild:', res.data.clanBasicInfo?.clanName);
  });

Python

import requests
r = requests.get('https://api.teamfast.shop/api.php',
    params={'uid': '3077799485', 'region': 'BD', 'key': 'YOUR_KEY'}).json()
if r['status']:
    info = r['data']['basicInfo']
    print(info['nickname'], info['level'], info['liked'])
else:
    print(r['message'])

PHP

$url = 'https://api.teamfast.shop/api.php?' . http_build_query([
    'uid' => '3077799485', 'region' => 'BD', 'key' => 'YOUR_KEY'
]);
$res = json_decode(file_get_contents($url), true);
echo $res['status'] ? $res['data']['basicInfo']['nickname'] : $res['message'];

cURL

curl -X GET "https://api.teamfast.shop/api.php?uid=3077799485&region=BD&key=YOUR_KEY"

Player Info API Documentation