Developer API

Steam Friendlist API

Fetch any public Steam profile's friend list — SteamIDs plus friendship-since timestamps — through one call.

Endpoints

All endpoints return JSON, accept the same auth header, and degrade with a normalised error envelope.

GET /steam/api/friendlist

Steam Friendlist API — quickstart

Same auth header as every other endpoint we ship. Get an API key from the dashboard and you're querying inside two minutes.

→ Single auth header, JSON response.
→ Rate limits scale with your plan tier.
→ Full schema in the API reference.

API Request

# curl with API key

curl "https://www.steamwebapi.com/steam/api/friendlist?key=$KEY"

# PHP

$res = file_get_contents('https://www.steamwebapi.com/steam/api/friendlist?key=' . $KEY);

$data = json_decode($res, true);

# Node.js

const r = await fetch(`https://www.steamwebapi.com/steam/api/friendlist?key=${KEY}`);

const data = await r.json();

About this API

Plug the Friendlist API into social-graph tools, community analytics, or anti-fraud heuristics that need to know who connects to whom. Returns a flat list of SteamIDs with the friendship-since timestamp.

Public profiles only — private profiles return an empty list, which lets you detect private-profile fraud signals cheaply.

FAQ

Can I fetch private friend lists?

No — Steam only exposes friend lists for public profiles. Private profiles return an empty list.

Are friendship-since timestamps included?

Yes — for every friend row, you get the SteamID and the friendship-since Unix timestamp.

How does it differ from the Profile API?

Profile API returns the user themselves. Friendlist API returns their social graph.

Start building with the Steam Friendlist API

One key, every Steam endpoint.

Get API access Full API reference