API Documentation

Complete guide to integrating with the Free Fire Info API

Download Documentation
Introduction Authentication Endpoints Usage Rate Limits Errors

Introduction

The Free Fire Info API provides comprehensive player information for Free Fire game. This API allows you to retrieve player profiles, stats, ranks, guild information, and much more with a single request.

Quick Start: Sign in to get your API key, then make your first request. No credit card required for the free plan.

Authentication

All API requests require an API key in the request header. You can get your API key from the dashboard after signing in.

GET /ff-info/get?uid=2312730961
x-api-key: xxxxxxxxx

Base URL

https://api.gameskinbo.com

Endpoints

Get Player Information

GET
/ff-info/get

Parameters

Parameter Type Required Description
uid string Yes Free Fire player UID
region string No Region code (e.g., BD, IND, BR, US, ID, SG, PK). If provided, tries this region first. If not provided, tries regions serially in default order. If Region is not BD, than use region string for faster response.

Example Request

# Without region parameter (tries regions serially)
curl -X GET "https://api.gameskinbo.com/ff-info/get?uid=2312730961" \
  -H "x-api-key: xxxxxxxxx"

# With region parameter (tries specified region first)
curl -X GET "https://api.gameskinbo.com/ff-info/get?uid=2312730961&region=BD" \
  -H "x-api-key: xxxxxxxxx"

Example Response

{
  "AccountInfo": {
    "AccountName": "PlayerName",
    "AccountLevel": 82,
    "AccountEXP": 8431542,
    "AccountRegion": "BD",
    "AccountLikes": 39696,
    "AccountLastLogin": "1766158301",
    "AccountCreateTime": "1598540197",
    "AccountSeasonId": 48
  },
  "AccountProfileInfo": {
    "BrMaxRank": 325,
    "BrRankPoint": 5943,
    "CsMaxRank": 319,
    "CsRankPoint": 79
  },
  ...
}

Check API Usage

Check your current API usage and remaining limits. This endpoint requires user authentication (session-based).

Get Usage Information

GET
/api/usage

Authentication

This endpoint requires an API key in the request header, same as other API endpoints.

Example Request

curl -X GET "https://api.gameskinbo.com/api/usage" \
  -H "x-api-key: xxxxxxxxx"

Example Response

{
  "used": 10,
  "limit": 100,
  "remaining": 90,
  "plan": "free"
}

Response Fields

Field Type Description
used number Number of API calls used in the current billing cycle
limit number Total API call limit for your current plan
remaining number Number of API calls remaining in the current billing cycle
plan string Your current subscription plan (free, basic, or pro)

Rate Limits

Free Plan

5/min

5 requests per minute

Paid Plans

30/min

30 requests per minute

Error Responses

401 Unauthorized 
{"error": "API key required. Please provide x-api-key header."}
429 Too Many Requests 
{"error": "Rate limit exceeded. Please slow down your requests."}
429 Limit Exceeded 
{"error": "API limit exceeded. Please upgrade your plan.", "used": 100, "limit": 100}
402 Invalid UID 
{"error": "Invalid UID or server error. Please try again."}

Supported Regions

The API supports an optional region parameter. If provided, it tries the specified region first, then falls back to the default order if it fails. If not provided, it tries regions serially in order: BD → IND → BR/US/SAC/NA → ID → SG → PK.

Supported regions (in order):
1. BD (Bangladesh)
2. IND (India)
3. BR, US, SAC, NA (Brazil, United States, South America, North America)
4. ID (Indonesia)
5. SG (Singapore)
6. PK (Pakistan)