Get user information GET /api/users/info/v1

Returns user information for a list of 64-bit Steam IDs

This API has no cooldown.

All properties documented below may be missing. Therefore, check if the property exists before using it.

Documentation

Input
  • key - Your backpack.tf API key.
  • steamids - A list of Steam IDs, delimited by commas (,). Limited to 100 users per request.
Output
  • message - If the status code is not 2xx, this contains the reason for failure.
  • users - Mapping of users and their user info.
    • steamid
      • name - User's name on Steam.
      • avatar - User's avatar on Steam.
      • last_online - Unix timestamp, at which the user last used the site.
      • admin - If set, user is a backpack.tf admin.
      • donated - How much the user has donated to the site, in USD.
      • premium - If set, user has backpack.tf Premium.
      • premium_months_gifted - How many months of Premium this user has gifted away.
      • integrations - Various integrations. Subproperties in this property may be changed at any time and are not part of any stability promise.
        • group_member - If set, user is a member of the Meet the Stats group.
        • marketplace_seller - If set, user is a registered Marketplace.tf seller.
        • automatic - If set, user is currently online with backpack.tf Automatic.
        • steamrep_admin - If set, user is a SteamRep admin.
      • bans - User's bans, including Valve bans.
        • steamrep_scammer - If set, user has a SteamRep scammer tag.
        • steamrep_caution - If set, user has a SteamRep caution tag.
        • valve - Contains the properties "economy", "community", "vac", and "game". If these are set, the user has the accompanying Valve-issued ban.
        • all - If set, user is banned from all features. Contains an "end" property, which is -1 if the ban is permanent. Contains a "reason" property if one was provided.
        • suggestions - If set, user is banned from price suggestions. Contains an "end" property, which is -1 if the ban is permanent. Contains a "reason" property if one was provided.
        • comments - If set, user is banned from suggestion comments. Contains an "end" property, which is -1 if the ban is permanent. Contains a "reason" property if one was provided.
        • trust - If set, user is banned from trust. Contains an "end" property, which is -1 if the ban is permanent. Contains a "reason" property if one was provided.
        • issues - If set, user is banned from issue tracker. Contains an "end" property, which is -1 if the ban is permanent. Contains a "reason" property if one was provided.
        • classifieds - If set, user is banned from classifieds. Contains an "end" property, which is -1 if the ban is permanent. Contains a "reason" property if one was provided.
        • customizations - If set, user is banned from profile customizations. Contains an "end" property, which is -1 if the ban is permanent. Contains a "reason" property if one was provided.
        • reports - If set, user is banned from reports. Contains an "end" property, which is -1 if the ban is permanent. Contains a "reason" property if one was provided.
      • voting - User's voting and suggestion stats.
        • reputation - User's on-site voting reputation.
        • votes - Details on the user's voting activity.
          • positive - How many positive votes this user has casted.
          • negative - How many negative votes this user has casted.
          • accepted - How many votes were accurate.
        • suggestions - Details on the user's suggestion activity.
          • created - How many suggestions this user has created.
          • accepted - How many of those were accepted.
          • accepted_unusual - How many accepted Unusual suggestions this user has. Unusual suggestions are considerably harder to make.
      • inventory - Concise inventory statistics.
        • appid - Inventory statistics for this appid. Team Fortress 2 is appid 440.
          • ranking - If set, user's backpack.tf ranking for this game.
          • value - Community inventory value (TF2) or market inventory value (D2/CSGO).
          • updated - Unix timestamp, at which the inventory was last updated.
          • metal - If set, how much pure metal is in this inventory.
          • keys - If set, how many pure keys are in this in inventory.
          • slots - Inventory slots.
            • used - How many slots are used in this inventory.
            • total - How many slots are available in this inventory.
      • trust - User backpack.tf trust scores.
        • positive - How many positive trusts this user has.
        • negative - How many negative trusts this user has.

Example Output

Input GET http://backpack.tf/api/users/info/v1?steamids=76561198012598620%2C76561198070299574&key=xxxxxxxxxxxxxxxxxxxxxx
steamids=76561198012598620%2C76561198070299574&key=xxxxxxxxxxxxxxxxxxxxxx
Output
{
    "users": {
        "76561198012598620": {
            "name": "fisk",
            "avatar": "https:\/\/steamcdn-a.akamaihd.net\/steamcommunity\/public\/images\/avatars\/a7\/a74aea70ade3e3987b97dc496588d5aa77de318d_medium.jpg",
            "last_online": 1492016749,
            "admin": 1,
            "donated": 20,
            "premium": 1,
            "premium_months_gifted": 1,
            "integrations": {
                "group_member": 1,
                "steamrep_admin": 1
            },
            "voting": {
                "reputation": 50,
                "votes": {
                    "positive": 17,
                    "negative": 16,
                    "accepted": 6
                },
                "suggestions": {
                    "created": 7,
                    "accepted": 75,
                    "accepted_unusual": 100
                }
            },
            "inventory": {
                "440": {
                    "ranking": 116392,
                    "value": 897.07,
                    "updated": 1492047740,
                    "metal": 14.556,
                    "keys": 0,
                    "slots": {
                        "used": 494,
                        "total": 600
                    }
                },
                "570": {
                    "ranking": 249744,
                    "value": 80,
                    "updated": 0,
                    "metal": 0,
                    "keys": 0,
                    "slots": {
                        "used": 11,
                        "total": 10000
                    }
                },
                "730": {
                    "ranking": 67617,
                    "value": 21256,
                    "updated": 0,
                    "metal": 0,
                    "keys": 0,
                    "slots": {
                        "used": 133,
                        "total": 133
                    }
                }
            },
            "trust": {
                "positive": 2
            }
        },
        "76561198070299574": {
            "name": "cares",
            "avatar": "https:\/\/steamcdn-a.akamaihd.net\/steamcommunity\/public\/images\/avatars\/a4\/a488629ac1149476dece246c953d8685de710d0b_medium.jpg",
            "last_online": 1492112257,
            "admin": 1,
            "donated": 20,
            "premium": 1,
            "integrations": {
                "marketplace_seller": 1
            },
            "voting": {
                "reputation": 11319,
                "votes": {
                    "positive": 11721,
                    "negative": 3390,
                    "accepted": 9350
                },
                "suggestions": {
                    "created": 43,
                    "accepted": 38,
                    "accepted_unusual": 1
                }
            },
            "inventory": {
                "440": {
                    "ranking": 4204,
                    "value": 14711.36,
                    "updated": 1492089598,
                    "metal": 2.778,
                    "keys": 44,
                    "slots": {
                        "used": 911,
                        "total": 2000
                    }
                },
                "570": {
                    "ranking": 234976,
                    "value": 4,
                    "updated": 0,
                    "metal": 0,
                    "keys": 0,
                    "slots": {
                        "used": 3,
                        "total": 10000
                    }
                },
                "730": {
                    "ranking": 17291,
                    "value": 67305,
                    "updated": 0,
                    "metal": 0,
                    "keys": 0,
                    "slots": {
                        "used": 699,
                        "total": 699
                    }
                }
            },
            "trust": {
                "positive": 2
            }
        }
    }
}