ClanInfo API

The ClanInfo API provides programmatic access to clan rosters, levels, activities, and structures.

Basic Docs

Query `/api/v1/clan/info` providing a valid `clan_id` to retrieve high-level clan statistics.

GET/api/v1/clan/info

Cost: 1.00 (basic) | 3.00 (detailed) | 5.00 (full) Credits per request

Advanced Docs

Specify depth levels (`basic`, `detailed`, `full`) to change the response complexity:

basic

Returns high-level profile statistics: `clan_id`, `clan_name`, `create_at`, `captain_id`, `clan_level`, `capacity`, `member_num`, `slogan`, `region`.

detailed

Adds announcements, active vice captains list, accumulated weekly activeness scores, and current unlocked badge information.

full

Includes full underlying Garena server response details, including regional title equipping metadata, tournament ban parameters, and raw protobuf sub-elements.

Code Examples

python

import requests

url = "https://ffdata-api.onrender.com/api/v1/clan/info"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}
params = {
    "clan_id": 3022208474,
    "region": "ind",
    "detail": "detailed"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())())

API Details

Terminology alignment: Note that within Free Fire's client application, group affiliations are labeled as Guilds. The official REST API maps these entities under the name **Clan** (e.g. `clan_id`, `clan_name`).

Parameter	Type	Required	Description
clan_id	integer	Yes	Unique Clan/Guild ID (6-14 digits)
region	string	No	Server region code. Default is `ind` (India).
detail	string	No	Response depth. `basic`, `detailed`, `full`

Response Structure

json

{
  "success": true,
  "data": {
    "clan_id": 3022208474,
    "clan_name": "ˢᵗᵃʳ★ᴛᴇᴀᴍ࿐",
    "clan_level": 4,
    "capacity": 50,
    "member_num": 50,
    "captain_id": 2356545819,
    "region": "IND",
    "slogan": "Found a bug Report! ig:maybedishan",
    "total_activeness": 31729,
    "weekly_activeness": 2230,
    "create_at": 1644567713,
    "vice_captains": "[1959976633,2255156412]"
  },
  "meta": {
    "time_ms": 1165,
    "request_id": "b866587c-a913-42da-9f34-2616e66d354c"
  }
}
  }
}