---
title: "Use when asked who a player plays or is friends with. Public Steam friend graph of a player (platform snapshot, can be partial)"
method: GET
path: "/friends/{id}"
---

# Use when asked who a player plays or is friends with. Public Steam friend graph of a player (platform snapshot, can be partial)

`GET /friends/{id}`

## Request

- Base URL: `https://steamgpt.net`
- URL: `https://steamgpt.net/friends/{id}`
- Auth: one of:
  - none
  - OAuth 2 (client credentials, token URL `https://steamgpt.net/oauth/token`, scopes: `rate-boost`)

## Path parameters

- `id` string, required

## Query parameters

- `detail` 'short' | 'medium' | 'full'
- `limit` integer

## Response `200`

Friend list (shape depends on ?detail)

- Friends
  - `result` 'success'
  - `data` FriendsData
    - `count` integer: total known friends (may exceed shown list)
    - `friends` union[]
      - union
        - string: detail=short: plain steamid64
        - object: detail=medium
          - `steamid64` string
          - `personaname` string, nullable
        - object: detail=full (default)
          - `steamid64` string
          - `steam` SteamPlayer, nullable: Raw Steam GetPlayerSummaries player object, unmodified field names
            - `steamid` string
            - `personaname` string
            - `profileurl` string
            - `avatar` string
            - `avatarmedium` string
            - `avatarfull` string
            - `personastate` integer: 0 offline, 1 online, 2 busy, 3 away, 4 snooze, 5 looking to trade, 6 looking to play
            - `communityvisibilitystate` integer: 3 = public
            - `timecreated` integer: unixtime
            - `lastlogoff` integer: unixtime
            - `gameextrainfo` string
            - `loccountrycode` string

## Other responses

- `404`: Not found
- `429`: Rate limited, honor Retry-After

---

[API](https://skmtc.dev/steamgpt/apis/steamgpt-api.md) · [All operations](https://skmtc.dev/steamgpt/apis/steamgpt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/steamgpt/apis/steamgpt-api/revisions/e104f6425018?raw)