# Free Fire Info API Documentation By Games Kinbo

Complete guide to integrating with the Free Fire Info API.

---

## 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.

---

## Base URL

```
https://api.gameskinbo.com
```

> **Note:** Replace with your production URL when deploying.

---

## Authentication

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

### Example Request

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

---

## Endpoints

### Get Player Information

**Method:** `GET`  
**Path:** `/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):**
```bash
curl -X GET "https://api.gameskinbo.com/ff-info/get?uid=2312730961" \
  -H "x-api-key: xxxxxxxxx"
```

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

#### Example Response

```json
{
  "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
  },
  "EquippedItemsInfo": {
    "EquippedAvatarId": 902050025,
    "EquippedBPBadges": 89,
    "EquippedBPID": 1001000091,
    "EquippedBannerId": 901000118
  },
  "SocialInfo": {
    "accountId": "2312730961",
    "gender": "Gender_FEMALE",
    "language": "Language_EN"
  },
  "GuildInfo": {
    "GuildID": "3069083500",
    "GuildName": "GuildName",
    "GuildLevel": 6
  }
}
```

---

## Check API Usage

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

### Get Usage Information

**Method:** `GET`  
**Path:** `/api/usage`

#### Authentication

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

#### Example Request

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

#### Example Response

```json
{
  "used": 10,
  "limit": 25,
  "remaining": 15,
  "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 requests per minute**

### Paid Plans
- **30 requests per minute**

---

## Error Responses

### 401 Unauthorized
```json
{"error": "API key required. Please provide x-api-key header."}
```

### 429 Too Many Requests
```json
{"error": "Rate limit exceeded. Please slow down your requests."}
```

### 429 Limit Exceeded
```json
{"error": "API limit exceeded. Please upgrade your plan.", "used": 25, "limit": 25}
```

### 402 Invalid UID
```json
{"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)

---

## Getting Started

1. Sign in with your Google account
2. Get your API key from the dashboard
3. Make your first API request using the examples above
4. Start building amazing Free Fire applications!

---

**Documentation provided by Games Kinbo**  
For support, visit your dashboard or contact us through the platform.