Steam
Summary
Get detailed Steam profile data via official API including badges, XP, and account information.
Endpoint
This endpoint uses the official Steam API to get detailed profile data instead of scraping profile pages. It returns comprehensive user information including badges and XP data.
GET /steam/profile/{ SteamID64 }/summary?api_key={ YourSecretAPIKey }
Required parameters
SteamID64
string
The SteamID64 identifier of the user whose profile you want to fetch.
YourSecretAPIKey
string
A unique identifier that allows developers to access the Steam Web API.
Response fields
| Field | Type | Description |
|---|---|---|
steamid | string | The user's SteamID64 |
communityvisibilitystate | number | Profile visibility (1=Private, 2=FriendsOnly, 3=Public) |
profilestate | number | Whether the user has a community profile configured (1=yes) |
personaname | string | The user's display name |
commentpermission | number | Whether comments are allowed on the profile |
profileurl | string | Full URL to the user's Steam profile |
avatar | string | URL to the small avatar image (32x32) |
avatarmedium | string | URL to the medium avatar image (64x64) |
avatarfull | string | URL to the full avatar image (184x184) |
avatarhash | string | Hash used to construct avatar URLs |
personastate | number | Online status (0=Offline, 1=Online, 2=Busy, 3=Away, 4=Snooze, 5=Looking to trade, 6=Looking to play) |
primaryclanid | string | SteamID64 of the user's primary group |
timecreated | number | Unix timestamp of when the account was created |
personastateflags | number | Additional persona state flags |
loccountrycode | string | ISO country code of the user's location |
badges | array | Array of badge objects |
Badge object
| Field | Type | Description |
|---|---|---|
badgeid | number | The badge ID |
appid | number | Application ID (for game-specific badges, optional) |
level | number | Current level of the badge |
completion_time | number | Unix timestamp when the badge was earned/leveled |
xp | number | XP earned from this badge |
scarcity | number | Number of users who have this badge |
communityitemid | string | Community item ID (for game badges, optional) |
border_color | number | Border color value (for game badges, optional) |
Response example
Example output for this endpoint. For brevity's sake, some badges were omitted.
response.json
{
"steamid": "76561198038526790",
"communityvisibilitystate": 3,
"profilestate": 1,
"personaname": "PEPZ",
"commentpermission": 1,
"profileurl": "https://steamcommunity.com/id/pepzwee/",
"avatar": "https://avatars.steamstatic.com/8fc8d5da91fee98bd9d419f89fd508d66945c8f7.jpg",
"avatarmedium": "https://avatars.steamstatic.com/8fc8d5da91fee98bd9d419f89fd508d66945c8f7_medium.jpg",
"avatarfull": "https://avatars.steamstatic.com/8fc8d5da91fee98bd9d419f89fd508d66945c8f7_full.jpg",
"avatarhash": "8fc8d5da91fee98bd9d419f89fd508d66945c8f7",
"personastate": 3,
"primaryclanid": "103582791457598412",
"timecreated": 1298382620,
"personastateflags": 0,
"loccountrycode": "EE",
"badges": [
{
"badgeid": 13,
"level": 625,
"completion_time": 1766289028,
"xp": 875,
"scarcity": 916315
},
{
"badgeid": 1,
"appid": 730,
"level": 5,
"completion_time": 1415375204,
"xp": 500,
"communityitemid": "1111254987",
"border_color": 0,
"scarcity": 9204132
},
{
"badgeid": 1,
"appid": 252490,
"level": 1,
"completion_time": 1479801342,
"xp": 100,
"communityitemid": "3551155585",
"border_color": 0,
"scarcity": 1517041
}
]
}