FreeFire-Api is a lightweight Python project that interacts with internal Free Fire APIs using compiled Protocol Buffers. It enables structured API communication, making it easier to parse, encode, and serve game-related data such as player profiles, regions, and server details.
- Interacts directly with Free Fire's internal game APIs.
- Uses Protocol Buffers for serialization and deserialization of network messages.
- Provides endpoints for player statistics, personal show data, and more.
- Implements encryption for secure API communication.
- Built with Flask for easy RESTful API deployment.
-
Clone the repository
git clone https://github.com/0xMe/FreeFire-Api.git cd FreeFire-Api -
Install dependencies
pip install -r requirements.txt
-
Configuration
- Add your account credentials to
./Configuration/AccountConfiguration.jsonfor each supported server. - Make sure your protobuf files are compiled and available in
Proto/compiled/.
- Add your account credentials to
-
Run the API server
python app.py
The API will run on
http://0.0.0.0:5000.
GET /get_player_stats
Query Parameters:
server(default: "IND") — The server region.uid— The player UID.gamemode(default: "br") — Game mode (br,cs).matchmode(default: "CAREER") — Match mode. (CAREER,NORMAL,RANKED)
GET /get_player_personal_show
Query Parameters:
server(default: "IND") — The server region.uid— The player UID.need_gallery_info(optional) — Whether to include gallery info.call_sign_src(default: 7) — Call sign source.
Example: https://freefire-api-six.vercel.app/get_player_personal_show?server=ind&uid=1633864660
GET /get_search_account_by_keyword
Query Parameters:
server(default: "IND") — The server region.keyword— The Keyword.
Example: https://freefire-api-six.vercel.app/get_search_account_by_keyword?server=ind&keyword=Hello
Responses are in JSON format. Example error messages are provided for invalid parameters, authentication failures, and data not found.
app.py— Flask application with REST endpoints.Api/Account.py— Garena authentication and login functions.Api/InGame.py— Game data retrieval functions.Utilities/until.py— Utility functions for encryption and protocol buffer handling.Configuration/— Contains configuration files, including AES keys and API version.
- Python
- Flask
- pycryptodome
- protobuf
Refer to requirements.txt for additional dependencies.
Feel free to fork and submit pull requests. Open issues for bug reports and feature requests.