getPlayerDetails

Last Updated 11th May, 2025

The getPlayerDetails query retrieves information about a Free Fire player using their player ID. It requires API key authentication and returns structured player data.


🔗 Endpoint

URL: https://api.vscgames.com/graphql Method: POST Content-Type: application/json


🔍 Query Structure

query getPlayerDetails($playerID: String!) {
  getPlayerDetails(playerID: $playerID) {
    success
    player_name
    region
  }
}

📥 Parameters

Name
Type
Required
Description

playerID

String

✅ Yes

The player’s unique ID

📥 Headers

Header
Required
Description

apikey

✅ Yes

API key of the user


✅ Successful Response

{
  "data": {
    "getPlayerDetails": {
      "success": true,
      "player_name": "JJ_MUCH",
      "region": "EU"
    }
  }
}

🚫 Error Responses

Message
Reason

API key required in headers

Missing apikey from request headers

Invalid API key

The API key is not registered

❌ Error fetching player details

External service failed to respond

If an error occurs:

{
  "data": {
    "getPlayerDetails": {
      "success": false,
      "player_name": null,
      "region": null
    }
  }
}

🧪 Code Examples

Python

import requests

url = "https://api.vscgames.com/graphql"
headers = {
    "Content-Type": "application/json",
    "apikey": "YOUR_API_KEY"
}

query = """
query getPlayerDetails($playerID: String!) {
  getPlayerDetails(playerID: $playerID) {
    success
    player_name
    region
  }
}
"""

variables = { "playerID": "2265245647" }

response = requests.post(url, json={"query": query, "variables": variables}, headers=headers)
print(response.json())

JavaScript

const fetch = require("node-fetch");

const query = `
query getPlayerDetails($playerID: String!) {
  getPlayerDetails(playerID: $playerID) {
    success
    player_name
    region
  }
}`;

const variables = { playerID: "2265245647" };

fetch("https://api.vscgames.com/graphql", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "apikey": "YOUR_API_KEY"
  },
  body: JSON.stringify({ query, variables })
})
  .then(res => res.json())
  .then(data => console.log(data));

Last updated