Sign in

v4

latestOpenAPI 3.1.02026-07-3196251302.5 KB
leaderboard

Preview account rank

post/v1/leaderboard.previewAccountRank

Request body

$schemastring uri

A URL to the JSON Schema for this object.

leaderboard'apps' | 'awards_given' | 'awards_received' | 'bans' | 'game_bans' | 'vac_bans' | 'donations' | 'foil_badges' | 'normal_badges' | 'badges' | 'playtime' | 'points_given' | 'points_received' | 'steam_sets' | 'xp' required

The leaderboard to get

valueinteger nullable

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

Example request

{
  "$schema": "https://api.steamsets.com/schemas/V1LeaderboardPreviewAccountRankRequestBody.json",
  "leaderboard": "xp"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

rankedOutOfinteger

The number of accounts that are ranked in the leaderboard

Example response

{
  "$schema": "https://api.steamsets.com/schemas/V1LeaderboardPreviewAccountRankResponseBody.json",
  "ownAccount": {
    "appCost": 123456,
    "apps": 123456,
    "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
    "awardsGiven": 123456,
    "awardsReceived": 123456,
    "badges": 123456,
    "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,
    "level": 123456,
    "name": "steamsets",
    "normalBadgeCost": 123456,
    "normalBadges": 123456,
    "playtime": 123456,
    "pointsGiven": 123456,
    "pointsReceived": 123456,
    "privacy": "public",
    "rank": 1,
    "region": {
      "name": "Europe"
    },
    "score": 100,
    "state": {
      "name": "Baden-Wurttemberg"
    },
    "steamId": "76561198842603734",
    "steamSetsVanity": "steamsets",
    "steamVanity": "steamsets",
    "xp": 123456
  },
  "rankedAbove": {
    "appCost": 123456,
    "apps": 123456,
    "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
    "awardsGiven": 123456,
    "awardsReceived": 123456,
    "badges": 123456,
    "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,
    "level": 123456,
    "name": "steamsets",
    "normalBadgeCost": 123456,
    "normalBadges": 123456,
    "playtime": 123456,
    "pointsGiven": 123456,
    "pointsReceived": 123456,
    "privacy": "public",
    "rank": 1,
    "region": {
      "name": "Europe"
    },
    "score": 100,
    "state": {
      "name": "Baden-Wurttemberg"
    },
    "steamId": "76561198842603734",
    "steamSetsVanity": "steamsets",
    "steamVanity": "steamsets",
    "xp": 123456
  },
  "rankedBelow": {
    "appCost": 123456,
    "apps": 123456,
    "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
    "awardsGiven": 123456,
    "awardsReceived": 123456,
    "badges": 123456,
    "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,
    "level": 123456,
    "name": "steamsets",
    "normalBadgeCost": 123456,
    "normalBadges": 123456,
    "playtime": 123456,
    "pointsGiven": 123456,
    "pointsReceived": 123456,
    "privacy": "public",
    "rank": 1,
    "region": {
      "name": "Europe"
    },
    "score": 100,
    "state": {
      "name": "Baden-Wurttemberg"
    },
    "steamId": "76561198842603734",
    "steamSetsVanity": "steamsets",
    "steamVanity": "steamsets",
    "xp": 123456
  }
}