Steam
Friends
Get a Steam user's friends list, including each friend's SteamID, when they were friended, and the relationship type.
Endpoint
This endpoint returns the friends list for a Steam user. The user's friends list must be set to public for this endpoint to return data.
GET /v2/steam/users/{steamid}/friends
Required parameters
steamid
string
The Steam ID of the user whose friends list you want to fetch. Accepts various Steam ID formats.
Authentication
Include your API key as the x-api-key request header.
x-api-key: YourSecretAPIKey
Response fields
The response is an array of friend objects.
Friend object
| Field | Type | Description |
|---|---|---|
steamID | string | SteamID64 of the friend. |
friendedTimestamp | number | Unix timestamp of when the friendship was established. |
relationship | string | The relationship type. Typically friend. |
Response example
Example output for this endpoint. For brevity's sake, most entries were omitted.
response.json
{
"success": true,
"result": [
{
"steamID": "76561197960272730",
"friendedTimestamp": 1512400593,
"relationship": "friend"
},
{
"steamID": "76561197962959318",
"friendedTimestamp": 1458647821,
"relationship": "friend"
},
{
"steamID": "76561197963926185",
"friendedTimestamp": 1300558357,
"relationship": "friend"
}
]
}