Souce Code: `https://github.com/0xMe/FreeFire-Api`

Last Update

Date: 8 oct

Changes Implemented:

Cache System
- Data is cached for a duration of 5 minutes, improving the efficiency of repeated requests.

📝 API Documentation

📌 Table of Contents

🪪 Account Information

Endpoint: /api/v1/account
Method: GET
Description This endpoint retrieves account information based on the specified region and user ID.

☑️ Query Parameters

Parameter	Type	Required	Description
`region`	string	Yes	The region code (`IND`, `BR`, `SG`, `RU`, `ID`, `TW`, `US`, `VN`, `TH`, `ME`, `PK`, `CIS`, `BD`).
`uid`	string	Yes	The user ID.

📨 Request Example

GET https://free-ff-api-src-5plp.onrender.com/api/v1/account?region=IND&uid=1633864660

💬 Response Example

{ "basicInfo": { "accountId": "1633864660", "accountType": 1, "nickname": "╰ᴼᴰ╯✿Lɪᴘᴀɴ࿐", "region": "IND", "level": 73, "exp": 4027433, "bannerId": 901000009, "headPic": 902000045, "rank": 220, "rankingPoints": 3896, "badgeCnt": 105, "badgeId": 1001000072, "seasonId": 39, "liked": 20134, "showRank": true, "lastLoginAt": "1717066157", "csRank": 219, "csRankingPoints": 88, "weaponSkinShows": [ 907192607, 912034002 ], "maxRank": 220, "csMaxRank": 219, "accountPrefers": {}, "createAt": "1574902662", "title": 904190039, "externalIconInfo": { "status": "ExternalIconStatus_NOT_IN_USE", "showType": "ExternalIconShowType_FRIEND" }, "releaseVersion": "OB44", "showBrRank": true, "showCsRank": true, "socialHighLightsWithBasicInfo": {} }, "profileInfo": { "avatarId": 102000007, "clothes": [ 50 ], "equipedSkills": [ 211000032, 205000059, 214000067, 203000191, 204000515, 211000859 ], "pvePrimaryWeapon": 1, "endTime": 1, "clothesTailorEffects": [ 1 ] }, "historyEpInfo": [ { "epEventId": 71, "epBadge": 1001000071, "badgeCnt": 128, "bpIcon": "UI_BP_Emoji_Pointed", "maxLevel": 100, "eventName": "T_43_H_BP71_NAME" }, { "epEventId": 70, "ownedPass": true, "epBadge": 1001000070, "badgeCnt": 145, "bpIcon": "UI_BP_Emoji_Frog", "maxLevel": 100, "eventName": "T_43_H_BP70_NAME" }, { "epEventId": 69, "epBadge": 1001000069, "badgeCnt": 151, "bpIcon": "UI_BP_Emoji_Asura", "maxLevel": 100, "eventName": "T_43_H_BP69_NAME" }, { "epEventId": 68, "epBadge": 1001000068, "badgeCnt": 158, "bpIcon": "UI_BP_Emoji_Electri", "maxLevel": 150, "eventName": "T_42_H_BP68_NAME" }, { "epEventId": 67, "epBadge": 1001000067, "badgeCnt": 139, "bpIcon": "UI_BP_Emoji_Watcher", "maxLevel": 150, "eventName": "T_42_H_BP67_NAME" }, { "epEventId": 66, "epBadge": 1001000066, "badgeCnt": 128, "bpIcon": "UI_BP_Emoji_Puppets", "maxLevel": 150, "eventName": "T_42_H_BP66_NAME" }, { "epEventId": 65, "epBadge": 1001000065, "badgeCnt": 150, "bpIcon": "UI_BP_Emoji_Fishing", "maxLevel": 150, "eventName": "T_41_JC_BP65_NAME" }, { "epEventId": 64, "epBadge": 1001000064, "badgeCnt": 144, "bpIcon": "UI_BP_Emoji_Slime", "maxLevel": 150, "eventName": "T_41_JC_BP64_NAME" }, { "epEventId": 63, "epBadge": 1001000063, "badgeCnt": 119, "bpIcon": "UI_BP_Emoji_Sonia", "maxLevel": 150, "eventName": "T_40_JC_BP63_NAME" }, { "epEventId": 60, "epBadge": 1001000060, "badgeCnt": 127, "bpIcon": "UI_BP_Emoji_Rollerskating", "maxLevel": 150, "eventName": "T_39_FH_BP61_NAME" }, { "epEventId": 59, "epBadge": 1001000059, "badgeCnt": 150, "bpIcon": "UI_BP_Emoji_Fishtank", "maxLevel": 150, "eventName": "T_39_FH_BP59_NAME" }, { "epEventId": 58, "epBadge": 1001000058, "badgeCnt": 154, "bpIcon": "UI_BP_Emoji_Cybermech", "maxLevel": 150, "eventName": "T_38_FH_BP58_NAME" }, { "epEventId": 57, "epBadge": 1001000057, "badgeCnt": 121, "bpIcon": "UI_BP_Emoji_Alligator", "maxLevel": 150, "eventName": "T_38_FH_BP57_NAME" }, { "epEventId": 56, "epBadge": 1001000056, "badgeCnt": 127, "bpIcon": "UI_BP_Emoji", "maxLevel": 150, "eventName": "T_37_FH_BP56_NAME" }, { "epEventId": 55, "ownedPass": true, "epBadge": 1001000055, "badgeCnt": 496, "eventName": "T_36_JL_EP55_BADGENAME" }, { "epEventId": 54, "epBadge": 1001000054, "badgeCnt": 411, "eventName": "T_36_JL_EP54_BADGENAME" }, { "epEventId": 53, "epBadge": 1001000053, "badgeCnt": 304, "eventName": "T_35_JL_EP53_BADGENAME" }, { "epEventId": 52, "epBadge": 1001000052, "badgeCnt": 355, "eventName": "T_35_JL_EP52_BADGENAME" }, { "epEventId": 51, "ownedPass": true, "epBadge": 1001000051, "badgeCnt": 460, "eventName": "T_34_JL_EP51_BADGENAME" }, { "epEventId": 50, "epBadge": 1001000050, "badgeCnt": 263, "eventName": "T_34_JL_EP50_BADGENAME" } ], "clanBasicInfo": { "clanId": "3033195648", "clanName": "2ɢʙㅤᴏᴅɪsʜᴀ࿐", "captainId": "1633864660", "clanLevel": 3, "capacity": 30, "memberNum": 20 }, "captainBasicInfo": { "accountId": "1633864660", "accountType": 1, "nickname": "╰ᴼᴰ╯✿Lɪᴘᴀɴ࿐", "region": "IND", "level": 73, "exp": 4027433, "bannerId": 901000009, "headPic": 902000045, "rank": 220, "rankingPoints": 3896, "badgeCnt": 105, "badgeId": 1001000072, "seasonId": 39, "liked": 20134, "showRank": true, "lastLoginAt": "1717066157", "csRank": 219, "csRankingPoints": 88, "weaponSkinShows": [ 907192607, 912034002 ], "maxRank": 220, "csMaxRank": 219, "accountPrefers": {}, "createAt": "1574902662", "title": 904190039, "externalIconInfo": { "status": "ExternalIconStatus_NOT_IN_USE", "showType": "ExternalIconShowType_FRIEND" }, "releaseVersion": "OB44", "showBrRank": true, "showCsRank": true, "socialHighLightsWithBasicInfo": {} }, "petInfo": { "id": 1300000001, "name": "Legend", "level": 6, "exp": 3018, "isSelected": true, "skinId": 1310000004, "selectedSkillId": 1315000010 }, "socialInfo": { "accountId": "1633864660", "gender": "Gender_MALE", "language": "Language_EN", "modePrefer": "ModePrefer_BR", "signature": "I may be slow to respond.", "rankShow": "RankShow_BR" }, "diamondCostRes": { "diamondCost": 390 }, "creditScoreInfo": { "creditScore": 100, "rewardState": "REWARD_STATE_UNCLAIMED", "periodicSummaryLikeCnt": 30, "periodicSummaryIllegalCnt": 1, "periodicSummaryStartTime": "15", "periodicSummaryEndTime": "1716776753" }, "equippedAch": [ { "achId": 13002, "level": 3 }, { "achId": 13001, "level": 3 }, { "achId": 13006, "level": 3 }, { "achId": 13005, "level": 3 } ] }

⚙️ Craftland Profile Information

Endpoint: /api/v1/craftlandProfile
Method: GET
Description: Retrieve detailed information about a specific Craftland profile, including user statistics, created maps, resources used, and other related data.

☑️ Query Parameters

Parameter	Type	Required	Description
`region`	string	Yes	The region code (`IND`, `BR`, `SG`, `RU`, `ID`, `TW`, `US`, `VN`, `TH`, `ME`, `PK`, `CIS`, `BD`).
`uid`	string	Yes	The user ID.

📨 Request Example

GET https://free-ff-api-src-5plp.onrender.com/api/v1/craftlandProfile?region=IND&uid=1633864660

💬 Response Example

{ "authorSlotsInfo": [ { "slotId": 1, "slotState": "SlotState_PUBLISHED", "workshopCode": "2D1AA949DD77714ABB1FA0CE3ECCAFB34660", "workshopBasicInfo": { "workshopName": "FireZone", "authorId": "1633864660", "perfCost": "5", "updateTime": "1706154163", "resourceStatistics": "1", "authorName": "╰ᴼᴰ╯✿Lɪᴘᴀɴ࿐", "workshopDesc": "An exciting map in Craftland", "gameMode": 53, "tags": [ 17, 25 ], "modeSettings": "CoUHCgQIARgDCgIIGwoJCAgYAyUAAEBACgkIHRgFJQAAoEAKCggJGLQBJQAANEMKAggKCgkIBhgCJQAAAEAKCQgHGAElAACAPwoECAsQAQoJCAwYZCUAAMhCCgkIDRg8JQAAcEIKCQgcGDwlAABwQgoJCA4YFCUAAKBBCgIIAwoCCBoKAggFCgkIUhgCJQAAAEAKCggPGMgBJQAASEMKCggQGMgBJQAASEMKAggRCgIIEgoECBcQAQoDCJABCgMIkQEKAwiSAQoJCBMYZCUAAMhCCgkIFBhkJQAAyEIKCQgVGGQlAADIQgoJCBYYZCUAAMhCCgQIHhABCgQIHxABCgkIIBhkJQAAyEIKCQghGGQlAADIQgoJCCIYZCUAAMhCCgkIIxhkJQAAyEIKCQgkGGQlAADIQgoJCCUYZCUAAMhCCgkIJhhkJQAAyEIKAggnCgkIKBhkJQAAyEIKCQgpGGQlAADIQgoJCCoYZCUAAMhCCgkIKxhkJQAAyEIKCQgsGGQlAADIQgoKCEsY6AclAAB6RAoKCEwYyAElAABIQwoKCE0Y9AMlAAD6QwoECE4QAQoJCDEYPCUAAHBCCgkIMhhkJQAAyEIKCQgzGGQlAADIQgoJCDQYZCUAAMhCCgkINRhkJQAAyEIKCQg2GGQlAADIQgoJCDcYZCUAAMhCCgkIOBhkJQAAyEIKCQg5GGQlAADIQgoJCDoYZCUAAMhCCgkIPBhkJQAAyEIKCQg9GGQlAADIQgoJCD4YZCUAAMhCCgkIPxhkJQAAyEIKCQhAGGQlAADIQgoJCEEYZCUAAMhCCgkIQhhkJQAAyEIKCQhDGGQlAADIQgoJCEQYZCUAAMhCCgkIRRhkJQAAyEIKAghGCgkISBgPJQAAcEEKBAhJEAEKBAhKEAEKBAhYEAEKBAhZEAEKCQhaGB4lAADwQQoECFEQAQoJCF8YZCUAAMhCCgkIYBhkJQAAyEIKCQhhGGQlAADIQgoJCGIYZCUAAMhCCgoIngEYZCUAAMhCCgoIpgEYZCUAAMhCCgoIpwEYZCUAAMhCCgoIqAEYZCUAAMhCCgoIrwEYZCUAAMhCCgkIYxgBJQAAgD8KAghmCgkIZxgKJQAAIEEKAwiTAQoDCIEBCgUIggEQAQoFCI8BEAEKBQiNARABCgUIjgEQAQoDCJcBCgMImAEKAwiZAQoFCJoBEAEKAwibARgB", "teamCount": 2, "miniMapSettings": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "miniMapObjectSettings": "CgcIjwEQFhgj", "mapId": 10, "commentInfo": {}, "modeTemplateId": 3, "obVersion": 106, "createTime": "1706154163", "matchmakingRule": {} } } ], "accountInfo": { "exp": 20110, "createTimes": 5, "authorTag": 1 }, "authorId": "1633864660" }

🏠 Craftland Map Information

Endpoint: /api/v1/craftlandInfo
Method: GET
Description: Retrieve detailed information about a specific Craftland map, including map details, resources used, and other related data.

☑️ Query Parameters

Parameter	Type	Required	Description
`region`	string	Yes	The region code (`IND`, `BR`, `SG`, `RU`, `ID`, `TW`, `US`, `VN`, `TH`, `ME`, `PK`, `CIS`, `BD`).
`map_code`	string	Yes	The unique code of the Craftland map.

📨 Request Example

GET https://free-ff-api-src-5plp.onrender.com/api/v1/craftlandInfo?region=IND&map_code=2D1AA949DD77714ABB1FA0CE3ECCAFB34660

💬 Response Example

{ "workshopBasicInfo": { "workshopName": "FireZone", "authorId": "1633864660", "perfCost": "5", "updateTime": "1706154163", "resourceStatistics": "1", "authorName": "╰ᴼᴰ╯✿Lɪᴘᴀɴ࿐", "workshopDesc": "An exciting map in Craftland", "gameMode": 53, "tags": [ 17, 25 ], "modeSettings": "CoUHCgQIARgDCgIIGwoJCAgYAyUAAEBACgkIHRgFJQAAoEAKCggJGLQBJQAANEMKAggKCgkIBhgCJQAAAEAKCQgHGAElAACAPwoECAsQAQoJCAwYZCUAAMhCCgkIDRg8JQAAcEIKCQgcGDwlAABwQgoJCA4YFCUAAKBBCgIIAwoCCBoKAggFCgkIUhgCJQAAAEAKCggPGMgBJQAASEMKCggQGMgBJQAASEMKAggRCgIIEgoECBcQAQoDCJABCgMIkQEKAwiSAQoJCBMYZCUAAMhCCgkIFBhkJQAAyEIKCQgVGGQlAADIQgoJCBYYZCUAAMhCCgQIHhABCgQIHxABCgkIIBhkJQAAyEIKCQghGGQlAADIQgoJCCIYZCUAAMhCCgkIIxhkJQAAyEIKCQgkGGQlAADIQgoJCCUYZCUAAMhCCgkIJhhkJQAAyEIKAggnCgkIKBhkJQAAyEIKCQgpGGQlAADIQgoJCCoYZCUAAMhCCgkIKxhkJQAAyEIKCQgsGGQlAADIQgoKCEsY6AclAAB6RAoKCEwYyAElAABIQwoKCE0Y9AMlAAD6QwoECE4QAQoJCDEYPCUAAHBCCgkIMhhkJQAAyEIKCQgzGGQlAADIQgoJCDQYZCUAAMhCCgkINRhkJQAAyEIKCQg2GGQlAADIQgoJCDcYZCUAAMhCCgkIOBhkJQAAyEIKCQg5GGQlAADIQgoJCDoYZCUAAMhCCgkIPBhkJQAAyEIKCQg9GGQlAADIQgoJCD4YZCUAAMhCCgkIPxhkJQAAyEIKCQhAGGQlAADIQgoJCEEYZCUAAMhCCgkIQhhkJQAAyEIKCQhDGGQlAADIQgoJCEQYZCUAAMhCCgkIRRhkJQAAyEIKAghGCgkISBgPJQAAcEEKBAhJEAEKBAhKEAEKBAhYEAEKBAhZEAEKCQhaGB4lAADwQQoECFEQAQoJCF8YZCUAAMhCCgkIYBhkJQAAyEIKCQhhGGQlAADIQgoJCGIYZCUAAMhCCgoIngEYZCUAAMhCCgoIpgEYZCUAAMhCCgoIpwEYZCUAAMhCCgoIqAEYZCUAAMhCCgoIrwEYZCUAAMhCCgkIYxgBJQAAgD8KAghmCgkIZxgKJQAAIEEKAwiTAQoDCIEBCgUIggEQAQoFCI8BEAEKBQiNARABCgUIjgEQAQoDCJcBCgMImAEKAwiZAQoFCJoBEAEKAwibARgB", "teamCount": 2, "miniMapSettings": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "miniMapObjectSettings": "CgcIjwEQFhgj", "mapId": 10, "commentInfo": {}, "modeTemplateId": 3, "createTime": "1706154163", "matchmakingRule": {} } }

📊 Player Stats

Endpoint: /api/v1/playerstats
Method: GET
Description: Retrieve detailed statistics for a specific player, including matches played, wins, kills, and other related data.

☑️ Query Parameters

Parameter	Type	Required	Description
`region`	string	Yes	The region code (`IND`, `BR`, `SG`, `RU`, `ID`, `TW`, `US`, `VN`, `TH`, `ME`, `PK`, `CIS`, `BD`).
`uid`	string	Yes	The user ID of the player.

📨 Request Example

GET https://free-ff-api-src-5plp.onrender.com/api/v1/playerstats?region=IND&uid=1633864660

💬 Response Example

{ "soloStats": { "accountId": "1633864660", "gamesPlayed": 12, "wins": 2, "kills": 55, "detailedStats": { "deaths": 10, "topNTimes": 5, "distanceTravelled": 45943, "survivalTime": 4585, "highestKills": 14, "damage": 17442, "headshots": 49, "headshotKills": 14, "pickUps": 1382 } }, "duoStats": { "accountId": "1633864660", "detailedStats": {} }, "quadStats": { "accountId": "1633864660", "gamesPlayed": 26, "wins": 5, "kills": 110, "detailedStats": { "deaths": 21, "topNTimes": 9, "distanceTravelled": 112408, "survivalTime": 16246, "revives": 19, "highestKills": 11, "damage": 51276, "roadKills": 1, "headshots": 55, "headshotKills": 15, "knockDown": 123, "pickUps": 3133 } } }

🎫 Wishlist Items

Endpoint: /api/v1/wishlistitems
Method: GET
Description: Retrieve a list of items from a user's wishlist, including item IDs and their release times.

☑️ Query Parameters:

Parameter	Type	Required	Description
`region`	string	Yes	The region code (`IND`, `BR`, `SG`, `RU`, `ID`, `TW`, `US`, `VN`, `TH`, `ME`, `PK`, `CIS`, `BD`).
`uid`	string	Yes	The user ID of the player.

📨 Request Example

GET https://free-ff-api-src-5plp.onrender.com/api/v1/wishlistitems?region=IND&uid=1187946149

💬 Response Example

{ "items": [ { "itemId": 203043011, "releaseTime": "1707786123" }, { "itemId": 204043011, "releaseTime": "1707786123" }, { "itemId": 205043011, "releaseTime": "1707786123" }, { "itemId": 211000589, "releaseTime": "1706471849" }, { "itemId": 211043017, "releaseTime": "1707786123" }, { "itemId": 904026008, "releaseTime": "1709657470" }, { "itemId": 905042004, "releaseTime": "1715897897" } ] }

👨‍👨‍👦‍👦 Guild Information

Endpoint: /api/v1/guildInfo
Method: GET
Description: Retrieve detailed information about Free Fire guilds by querying this API with the guild's region and ID. Receive data such as guild name, creation date, level, member count, and more in JSON format.

☑️ Query Parameters:

Parameter	Type	Required	Description
`region`	string	Yes	The region code (`IND`, `BR`, `SG`, `RU`, `ID`, `TW`, `US`, `VN`, `TH`, `ME`, `PK`, `CIS`, `BD`).
`guildID`	string	Yes	The Guild ID.

📨 Request Example

GET https://free-ff-api-src-5plp.onrender.com/api/v1/guildInfo?region=IND&guildID=3033195648

💬 Response Example

{ "clanId": "3033195648", "clanName": "2ɢʙㅤᴏᴅɪsʜᴀ࿐", "createAt": "1716084498", "captainId": "1633864660", "clanLevel": 4, "capacity": 35, "memberNum": 23, "entryType": 2, "slogan": "Welcome!", "region": "IND", "misc": "{\"tags\": [14]}", "viceCaptains": "[1225808035,1447912709,2403464644]", "areaId": 51930, "deputyCaptain": "2000209368", "frameId": 16, "lastModifyAnnounceAt": "29831", "serialInactiveNum": 190, "isCertification": true }

😵 Error Responses

If there are errors in the request, the API will return an appropriate error message.

⚠️ Error Example (Invalid uid)

{ "error": "Invalid request", "message": "Empty 'uid' parameter. Please provide a valid 'uid'." }

⚠️ Error Example (Invalid region)

{ "error": "Invalid request", "message": "Empty 'region' parameter. Please provide a valid 'region'." }

{ "error": "Invalid request", "message": "Unsupported 'region' parameter. Supported regions are: IND, BR, SG, RU, ID, TW, US, VN, TH, ME, PK, CIS, BD." }

⚠️ Error Example (Invalid map_code)

{ "error": "Invalid request", "message": "Empty 'map_code' parameter. Please provide a valid 'map_code'." }

⚠️ Error Example (Invalid guildID)

{ "error": "Invalid request", "message": "Empty 'guildID' parameter. Please provide a valid 'guildID'." }

⭐️ Star Our Repository

If you find this project helpful, please consider giving it a star on GitHub! 🌟

Starring the repository helps us know that our work is valuable to you and motivates us to keep improving and adding new features.

Star the Repository on GitHub

Thank you for your support!

Name		Name	Last commit message	Last commit date
Latest commit History 61 Commits
.github/workflows		.github/workflows
LICENSE		LICENSE
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

Souce Code: https://github.com/0xMe/FreeFire-Api

Last Update

Changes Implemented:

📝 API Documentation

📌 Table of Contents

🪪 Account Information

☑️ Query Parameters

📨 Request Example

💬 Response Example

⚙️ Craftland Profile Information

☑️ Query Parameters

📨 Request Example

💬 Response Example

🏠 Craftland Map Information

☑️ Query Parameters

📨 Request Example

💬 Response Example

📊 Player Stats

☑️ Query Parameters

📨 Request Example

💬 Response Example

🎫 Wishlist Items

☑️ Query Parameters:

📨 Request Example

💬 Response Example

👨‍👨‍👦‍👦 Guild Information

☑️ Query Parameters:

📨 Request Example

💬 Response Example

😵 Error Responses

⚠️ Error Example (Invalid uid)

⚠️ Error Example (Invalid region)

⚠️ Error Example (Invalid map_code)

⚠️ Error Example (Invalid guildID)

⭐️ Star Our Repository

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Uh oh!

Contributors 1

Souce Code: `https://github.com/0xMe/FreeFire-Api`