---
title: "👥 Retrieve a Steam User's Friendlist"
method: GET
path: "/steam/api/friendlist"
tags: ["Profile"]
---

# 👥 Retrieve a Steam User's Friendlist

`GET /steam/api/friendlist`

## Request

- Base URL: `https://www.steamwebapi.com`
- URL: `https://www.steamwebapi.com/steam/api/friendlist`
- Auth: API key in query parameter `key`

Baseurl: https://www.steamwebapi.com/steam/api/friendlist?id=76561198012345678&key=YOUR_API_KEY

    💬 **What this endpoint does:**
    - Fetches a Steam user's friends list.
    - By default, the data is parsed (`parsed=1`) for better readability.
    - For raw data directly from Steam, set `parsed=0`.

    🛠️ **Features:**
    - Retrieve detailed information about a user's friends, such as online status, game activity, and profile details.
    - Optimized for better response times by utilizing caching.

    🌐 **How to use:**
    - Provide the user's Steam ID (64-bit) or Vanity URL using the `id` parameter.
    - Use the `no_cache` parameter to bypass caching if real-time data is required.

## Query parameters

- `format` string
- `pretty` '0' | '1'

## Response `200`

Request was successful, and the friend list data is returned.

- unknown

## Other responses

- `400`: Invalid Steam ID or Steam Vanity URL provided.
- `404`: Steam ID or Steam Vanity URL is missing.
- `406`: No friends found
- `407`: Unknown Network error
- `408`: Profile is private

---

[API](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation.md) · [All operations](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/revisions/f9a4109cbda6?raw)