Get Game Assets and Images

View as markdown
GET /image
Api key auth

Retrieves in-game images and icons from the Free Fire asset database.

This endpoint allows you to fetch various game assets including:

  • Character avatars and skins
  • Weapon skins and icons
  • Items and equipment icons
  • Badges and banners
  • Pet images
  • And more

Headers

  • x-api-key string

    Your API key from the developer portal (Header method - Recommended).

    Alternative: You can also pass the API key as a query parameter ?key=your_api_key

Query parameters

  • itemID string Required

    The item ID to retrieve the image for

    Format should match the following pattern: ^\d+$.

Responses

  • 200

    Image successfully retrieved

    Hide headers attributes Show headers attributes
    • X-RateLimit-Limit

      The maximum number of requests allowed in the current time window

    • X-RateLimit-Remaining

      The number of requests remaining in the current time window
  • 400 application/json

    Bad request - Invalid parameters

    Hide response attributes Show response attributes object
    • error string
    • message string
    • status integer
  • 401 application/json

    Unauthorized - Invalid or missing API key

    Hide response attributes Show response attributes object
    • error string
    • message string
    • status integer
  • 404

    Image not found

  • 429 application/json

    Too many requests - Rate limit exceeded

    Hide response attributes Show response attributes object
    • error string
    • message string
    • status integer
GET /image 
curl \
 --request GET 'https://developers.freefirecommunity.com/api/v1/image?itemID=908028011' \
 --header "x-api-key: ffc_1234567890_abcdefghijk"
Response examples (400) 
{
  "error": "string",
  "message": "string",
  "status": 42
}
Response examples (401) 
{
  "error": "string",
  "message": "string",
  "status": 42
}
Response examples (429) 
{
  "error": "string",
  "message": "string",
  "status": 42
}