Steam用户好友列表

GETPOST Steam

查询Steam用户的好友列表，包含好友昵称、头像、在线状态和好友关系建立时间。需要对方好友列表设为公开。

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

请求参数

参数名类型必填说明示例
steamidstring可选64位SteamID（与id二选一）—
idstring可选自定义URL名称（与steamid二选一）—

返回字段

字段类型说明
data.steamidstring64位SteamID
data.countinteger好友总数
data.friends[].steamidstring好友SteamID
data.friends[].nicknamestring好友昵称
data.friends[].avatarstring好友头像URL
data.friends[].online_statestring在线状态
data.friends[].friends_sincestring好友关系建立日期
data.noticestring提示信息（好友列表未公开时显示）

返回示例

{
  "code": 200,
  "data": {
    "steamid": "76561197960287930",
    "count": 0,
    "friends": [],
    "notice": "该用户好友列表未公开"
  },
  "message": "success"
}

调用示例

curl "https://api.tinyaii.cn/v1/steam/user/friends?steamid=<steamid>&id=<id>" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch("https://api.tinyaii.cn/v1/steam/user/friends?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/friends",
    params={"steamid": "<steamid>", "id": "<id>"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=10,
)
print(resp.json())

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