FreeFire-API

Free Fire API for player info, career stats, ban check, Craftland maps, wishlist data, and game assets across all regions.

原始信息汇总

数据集概述：FreeFire-API

这是一个面向开发者的 Free Fire 社区 REST API，用于访问 Free Fire 游戏中的玩家数据、统计数据、Craftland 地图信息、愿望清单、封禁状态及游戏内资产。

核心功能与提供的数据

该 API 提供以下主要数据接口：

• 玩家信息查询 (GET /info)：通过 region 和 uid 获取玩家资料，包括昵称、等级、段位、点赞数、徽章、战队详情、宠物数据及个人资料信息。
• 职业生涯统计 (GET /stats)：通过 region 和 uid 获取详细的战斗模式统计数据，包含总场次、胜利数、淘汰数、爆头数、载具击杀、击倒、救援及前十名次等。
• Craftland 地图信息 (GET /craftland)：通过 region 和 code 查询自定义地图的详细信息。
• 玩家愿望清单 (GET /wishlist)：通过 region 和 uid 读取玩家账户绑定的愿望清单物品。
• 封禁状态检查 (GET /bancheck)：通过 uid 验证玩家账户当前是否被封禁，支持多语言响应（可选参数 lang）。
• 游戏资产与图像检索 (GET /image)：通过 itemID 获取游戏内图标、皮肤、头像、徽章、横幅、宠物图像等相关资源。

支持的地区

API 支持以下三个 region 参数值：

• sg：适用于 SG、ID、ME、VN、TH、CIS、EU、TW、MY、PK、BD 等区域。
• ind：适用于印度。
• br：适用于 BR、US、NA、LATAM 等区域。

认证方式

• 推荐方式：使用请求头 x-api-key 传递 API 密钥。
• 备用方式：在请求 URL 中添加查询参数 ?key=your_api_key_here。

使用限制与定价

API 提供不同等级的订阅计划，每个计划包含每月请求次数、每分钟及每小时请求速率限制：

计划等级	每月请求数	每分钟限制	每小时限制
Trial	仅限 Playground 使用	—	—
Trial Pass	300 次（24 小时通行证）	20 次/分钟	100 次/小时
Beginner	3,000 次	30 次/分钟	500 次/小时
Developer	12,000 次	60 次/分钟	2,000 次/小时
Pro	30,000 次	120 次/分钟	6,000 次/小时
Enterprise	100,000 次以上	自定义限制	自定义限制

响应头部会包含 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 字段。

其他重要信息

• 大部分端点返回 JSON 格式数据。
• /image 端点返回 PNG 或 JPEG 等二进制图片内容。
• 封禁检查支持的语言包括：en、ar、es、id、pt、ru、vi。
• 建议在服务端发起请求以保护 API 密钥。

典型应用场景

• 构建 Free Fire 玩家数据追踪器。
• 开发 Discord 机器人及游戏社区工具。
• 制作锦标赛看板及比赛支持产品。
• 开发用于玩家查询的移动应用和网页应用。
• 构建创作者工具和 Free Fire 分析仪表板。
• 为 UI 集成提供游戏资产和图标检索。