Skip to main content
POST
/
v1
/
leaderboard.previewAccountRank
Preview account rank
curl --request POST \
  --url https://api.steamsets.com/v1/leaderboard.previewAccountRank \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": {
    "accountId": 1,
    "steamId64": "<string>"
  },
  "leaderboard": "xp",
  "value": 1,
  "vanity": {
    "type": "steam",
    "value": "<string>"
  }
}'
{
  "$schema": "https://api.steamsets.com/schemas/V1LeaderboardPreviewAccountRankResponseBody.json",
  "ownAccount": {
    "appCost": 123456,
    "apps": 123456,
    "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
    "awardsGiven": 123456,
    "awardsReceived": 123456,
    "badges": 123456,
    "bans": 1,
    "city": {
      "name": "Bad Krozingen"
    },
    "country": {
      "code": "DE",
      "name": "Germany"
    },
    "createdAt": "2023-01-01T00:00:00Z",
    "differenceToUs": 10,
    "donated": 123456,
    "economyBan": "steam",
    "foilBadgeCost": 123456,
    "foilBadges": 123456,
    "friends": 123456,
    "gameBans": 1,
    "level": 123456,
    "name": "steamsets",
    "normalBadgeCost": 123456,
    "normalBadges": 123456,
    "playtime": 123456,
    "pointsGiven": 123456,
    "pointsReceived": 123456,
    "privacy": "public",
    "rank": 1,
    "region": {
      "name": "Europe"
    },
    "roles": [
      {
        "extras": {},
        "rating": 123,
        "role": "user"
      }
    ],
    "score": 100,
    "state": {
      "name": "Baden-Wurttemberg"
    },
    "steamId": "76561198842603734",
    "steamSetsScore": 1,
    "steamSetsVanity": "steamsets",
    "steamVanity": "steamsets",
    "vacBans": 1,
    "xp": 123456
  },
  "rankedAbove": {
    "appCost": 123456,
    "apps": 123456,
    "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
    "awardsGiven": 123456,
    "awardsReceived": 123456,
    "badges": 123456,
    "bans": 1,
    "city": {
      "name": "Bad Krozingen"
    },
    "country": {
      "code": "DE",
      "name": "Germany"
    },
    "createdAt": "2023-01-01T00:00:00Z",
    "differenceToUs": 10,
    "donated": 123456,
    "economyBan": "steam",
    "foilBadgeCost": 123456,
    "foilBadges": 123456,
    "friends": 123456,
    "gameBans": 1,
    "level": 123456,
    "name": "steamsets",
    "normalBadgeCost": 123456,
    "normalBadges": 123456,
    "playtime": 123456,
    "pointsGiven": 123456,
    "pointsReceived": 123456,
    "privacy": "public",
    "rank": 1,
    "region": {
      "name": "Europe"
    },
    "roles": [
      {
        "extras": {},
        "rating": 123,
        "role": "user"
      }
    ],
    "score": 100,
    "state": {
      "name": "Baden-Wurttemberg"
    },
    "steamId": "76561198842603734",
    "steamSetsScore": 1,
    "steamSetsVanity": "steamsets",
    "steamVanity": "steamsets",
    "vacBans": 1,
    "xp": 123456
  },
  "rankedBelow": {
    "appCost": 123456,
    "apps": 123456,
    "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
    "awardsGiven": 123456,
    "awardsReceived": 123456,
    "badges": 123456,
    "bans": 1,
    "city": {
      "name": "Bad Krozingen"
    },
    "country": {
      "code": "DE",
      "name": "Germany"
    },
    "createdAt": "2023-01-01T00:00:00Z",
    "differenceToUs": 10,
    "donated": 123456,
    "economyBan": "steam",
    "foilBadgeCost": 123456,
    "foilBadges": 123456,
    "friends": 123456,
    "gameBans": 1,
    "level": 123456,
    "name": "steamsets",
    "normalBadgeCost": 123456,
    "normalBadges": 123456,
    "playtime": 123456,
    "pointsGiven": 123456,
    "pointsReceived": 123456,
    "privacy": "public",
    "rank": 1,
    "region": {
      "name": "Europe"
    },
    "roles": [
      {
        "extras": {},
        "rating": 123,
        "role": "user"
      }
    ],
    "score": 100,
    "state": {
      "name": "Baden-Wurttemberg"
    },
    "steamId": "76561198842603734",
    "steamSetsScore": 1,
    "steamSetsVanity": "steamsets",
    "steamVanity": "steamsets",
    "vacBans": 1,
    "xp": 123456
  },
  "rankedOutOf": 0
}
This endpoint supports API key authentication for external integrations

​
API Access

This endpoint can be accessed using:
  • API Keys: For external applications and integrations
  • User Sessions: For web application access
See our API documentation for authentication details.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
leaderboard
enum<string>
required

The leaderboard to get

Available options:
apps,
awards_given,
awards_received,
bans,
game_bans,
vac_bans,
donations,
foil_badges,
normal_badges,
badges,
playtime,
points_given,
points_received,
steam_sets,
xp
Examples:

"xp"

​
id
object
​
value
integer | null

What their leaderboard score would be, will use their current rank if not set

Required range: x >= 0
​
vanity
object

Response

OK

​
$schema
string<uri>

A URL to the JSON Schema for this object.

Examples:

"https://api.steamsets.com/schemas/V1LeaderboardPreviewAccountRankResponseBody.json"

​
ownAccount
object | null

Either the logged in user or the requested steamId, otherwise just contains the rank and score

​
rankedAbove
object | null

The account ranked above the account (rank-1)

​
rankedBelow
object | null

The account ranked below the account (rank+1)

​
rankedOutOf
integer
default:0

The number of accounts that are ranked in the leaderboard

Required range: x >= 0