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>orsteamcommunity.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": []
}
/v1/account.getAuthorizationBearer token · headerrequiredapplication/jsonaccountsstring[]requiredEach 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.
OK
accountsAccountGetAccount[]requiredThe accounts found, in request order.
Show propertiesHide properties
AccountGetAccountaccountPublicAccountrequiredShow propertiesHide properties
accountIdinteger<int32>requiredThe Steam account id, the low 32 bits of the SteamID64.
avatarstringrequiredThe Steam avatar hash.
badgesPublicAccountBadgesrequiredShow propertiesHide properties
foilinteger<int32>requirednormalinteger<int32>requiredtotalinteger<int32>requiredlevelinteger<int32>requiredThe Steam level.
namestringrequiredranksPublicAccountRanksrequiredGlobal leaderboard ranks. A leaderboard the account is not on is null.
Show propertiesHide properties
appsPublicAccountRankrequiredOwned apps.
Show propertiesHide properties
rankinteger<int32>required1 is first.
scoreinteger<int32>requiredThe value the leaderboard sorts by.
totalinteger<int32>requiredAccounts on the leaderboard.
awardsGivenPublicAccountRankrequiredawardsReceivedPublicAccountRankrequiredbadgesPublicAccountRankrequiredbansPublicAccountRankrequiredfoilBadgesPublicAccountRankrequiredgameBansPublicAccountRankrequirednormalBadgesPublicAccountRankrequiredplaytimePublicAccountRankrequiredMinutes played.
pointsGivenPublicAccountRankrequiredpointsReceivedPublicAccountRankrequiredsteamSetsPublicAccountRankrequiredThe SteamSets score.
vacBansPublicAccountRankrequiredxpPublicAccountRankrequiredsteamId64stringrequiredThe SteamID64, as a string because it does not fit a JSON number.
vanityPublicAccountVanityrequiredShow propertiesHide properties
steamstringrequiredThe name in steamcommunity.com/id/<steam>, empty when there is none.
steamSetsstringrequiredThe name in steamsets.com/<steamSets>, empty when there is none.
xpinteger<int32>requiredThe Steam XP.
inputstringrequiredThe request entry this account answers, as sent.
missingstring[]requiredThe entries that name no account SteamSets shows, as sent.
Bad Request
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA 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.
Unauthorized
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA 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.
Unprocessable Entity
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA 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.
Too Many Requests
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA 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.
Internal Server Error
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA 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.
Service Unavailable
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA 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.