Skip to content
SteamSets
Esc
↑↓navigate↵open⌘Jpreview

Get Steam accounts

Returns up to 100 Steam accounts that SteamSets already tracks, with level, badge counts and global leaderboard ranks.

Request

Each entry in accounts can be:

  • an account id, such as 882338006
  • a SteamID64, such as 76561198842603734
  • a SteamSets or Steam vanity, such as steamsets; a SteamSets vanity matches first
  • a steamcommunity.com/profiles/<steamId64> or steamcommunity.com/id/<vanity> URL

Missing accounts

This route never asks Steam. An account SteamSets has not seen, an account SteamSets hides, and an entry it cannot read are all in missing, as sent.

Freshness

Profile data is as fresh as the account’s last refresh. Ranks are live.

Cost

Each entry uses one unit of the key’s 10,000 daily units, found or not.

Example

{
  "accounts": [
    {
      "input": "steamsets",
      "account": {
        "accountId": 882338006,
        "steamId64": "76561198842603734",
        "name": "steamsets",
        "level": 120,
        "ranks": { "xp": { "rank": 1532, "score": 812345, "total": 2900000 } }
      }
    }
  ],
  "missing": []
}
POST/v1/account.get
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
accountsstring[]required

Each entry is an account id, a SteamID64, a SteamSets or Steam vanity, or a steamcommunity.com/profiles/<steamId64> or steamcommunity.com/id/<vanity> URL. A bare vanity matches a SteamSets vanity first. Each entry uses one unit of the key's daily allowance, found or not.

min items 1 · max items 100
Responses
200

OK

accountsAccountGetAccount[]required

The accounts found, in request order.

Show properties
Array of AccountGetAccount
accountPublicAccountrequired
Show properties
accountIdinteger<int32>required

The Steam account id, the low 32 bits of the SteamID64.

min 0
avatarstringrequired

The Steam avatar hash.

badgesPublicAccountBadgesrequired
Show properties
foilinteger<int32>required
min 0
normalinteger<int32>required
min 0
totalinteger<int32>required
min 0
levelinteger<int32>required

The Steam level.

min 0
namestringrequired
ranksPublicAccountRanksrequired

Global leaderboard ranks. A leaderboard the account is not on is null.

Show properties
appsPublicAccountRankrequired

Owned apps.

Show properties
rankinteger<int32>required

1 is first.

min 0
scoreinteger<int32>required

The value the leaderboard sorts by.

min 0
totalinteger<int32>required

Accounts on the leaderboard.

min 0
awardsGivenPublicAccountRankrequired
awardsReceivedPublicAccountRankrequired
badgesPublicAccountRankrequired
bansPublicAccountRankrequired
foilBadgesPublicAccountRankrequired
gameBansPublicAccountRankrequired
normalBadgesPublicAccountRankrequired
playtimePublicAccountRankrequired

Minutes played.

pointsGivenPublicAccountRankrequired
pointsReceivedPublicAccountRankrequired
steamSetsPublicAccountRankrequired

The SteamSets score.

vacBansPublicAccountRankrequired
xpPublicAccountRankrequired
steamId64stringrequired

The SteamID64, as a string because it does not fit a JSON number.

vanityPublicAccountVanityrequired
Show properties
steamstringrequired

The name in steamcommunity.com/id/<steam>, empty when there is none.

steamSetsstringrequired

The name in steamsets.com/<steamSets>, empty when there is none.

xpinteger<int32>required

The Steam XP.

min 0
inputstringrequired

The request entry this account answers, as sent.

missingstring[]required

The entries that name no account SteamSets shows, as sent.

400

Bad Request

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
401

Unauthorized

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
422

Unprocessable Entity

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
429

Too Many Requests

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
500

Internal Server Error

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
503

Service Unavailable

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X POST 'https://api.steamsets.com/v1/account.get' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "accounts": [
    "76561198842603734",
    "882338006",
    "steamsets",
    "https://steamcommunity.com/id/gabelogannewell"
  ]
}'
Response
{
  "accounts": [
    {
      "account": {
        "accountId": 882338006,
        "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
        "badges": {
          "foil": 0,
          "normal": 0,
          "total": 0
        },
        "level": 0,
        "name": "steamsets",
        "ranks": {
          "apps": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "awardsGiven": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "awardsReceived": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "badges": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "bans": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "foilBadges": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "gameBans": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "normalBadges": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "playtime": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "pointsGiven": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "pointsReceived": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "steamSets": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "vacBans": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "xp": {
            "rank": 0,
            "score": 0,
            "total": 0
          }
        },
        "steamId64": "76561198842603734",
        "vanity": {
          "steam": "string",
          "steamSets": "string"
        },
        "xp": 0
      },
      "input": "string"
    }
  ],
  "missing": [
    "string"
  ]
}