Steam用户查询

GETPOST Steam

通过Steam标识查询用户公开资料,支持多种格式:64位SteamID、自定义URL名、STEAM_ID3格式,返回昵称、头像、在线状态、封禁状态等信息

GET https://api.tinyaii.cn/v1/steam/user

请求参数

参数名类型必填说明示例
steamidstring可选64位SteamID(如 76561197960287930),与id/id3三选一—
idstring可选自定义URL名称(如 gabelogannewell),与steamid/id3三选一—
id3string可选Steam ID3格式(如 STEAM_0:0:11091),与steamid/id三选一—

返回字段

字段类型说明
data.steamidstring64位SteamID
data.nicknamestring昵称
data.real_namestring真实姓名(仅公开资料可见)
data.profile_urlstring个人资料主页URL
data.avatarstring头像URL(184x184全尺寸)
data.avatar_mediumstring头像URL(64x64中等尺寸)
data.avatar_smallstring头像URL(32x32小尺寸)
data.online_statestring在线状态(离线/在线/忙碌/离开/休眠/准备交易/准备游戏中)
data.profile_visibilitystring资料可见性(公开/私密/好友可见)
data.country_codestring国家代码(如US/CN,仅公开资料可见)
data.account_createdstring账号创建日期(如2010-08-10,仅公开资料可见)
data.last_logoffstring最后离线时间(仅公开资料可见)
data.playing_gamestring正在玩的游戏名(在线时才有)
data.vac_bannedboolean是否有VAC封禁记录
data.community_bannedboolean是否有社区封禁
data.vac_ban_countintegerVAC封禁次数(有封禁时才返回)
data.game_ban_countinteger游戏封禁次数(有封禁时才返回)

返回示例

{
  "code": 200,
  "data": {
    "steamid": "76561197960287930",
    "nickname": "Rabscuttle",
    "profile_url": "https://steamcommunity.com/id/GabeLoganNewell/",
    "avatar": "https://avatars.steamstatic.com/c5d56249ee5d28a07db4ac9f7f60af961fab5426_full.jpg",
    "avatar_medium": "https://avatars.steamstatic.com/c5d56249ee5d28a07db4ac9f7f60af961fab5426_medium.jpg",
    "avatar_small": "https://avatars.steamstatic.com/c5d56249ee5d28a07db4ac9f7f60af961fab5426.jpg",
    "online_state": "离线",
    "online_state_code": 0,
    "profile_visibility": "公开",
    "profile_visibility_code": 2,
    "vac_banned": false,
    "community_banned": false
  },
  "message": "success"
}

调用示例

curl "https://api.tinyaii.cn/v1/steam/user?steamid=<steamid>&id=<id>" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch("https://api.tinyaii.cn/v1/steam/user?steamid=<steamid>&id=<id>", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());
import requests

resp = requests.get(
    "https://api.tinyaii.cn/v1/steam/user",
    params={"steamid": "<steamid>", "id": "<id>"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)
print(resp.json())

把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。