Steam profile summary
steam_summaryUse when the user asks who a Steam player is or wants everything known about one account in a single call: Steam summary, Steam ban status (VAC/game/community), SteamID conversions, FACEIT stats and the first 100 friends. include LIMITS the response to the blocks you list: omit it for everything, ["steam"] for the Steam block only (cheapest), ["bans"] for a ban check only, ["faceit","bans"] to drop the friend list; friends_limit caps the friend list (default 100). Responses carry provenance.fresh and sources/partial - branch on them, not on nulls. Do not use for several players (steam_batch) or for a single fact (steam_bans, steam_faceit, steam_convert are cheaper).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | any SteamID format: steamid64 (17 digits), STEAM_1:0:x, STEAM_0:0:x, [U:1:x], hex, steam:hex, a 32-bit account id, a steamcommunity.com link or a vanity name | |
| include | No | restricts the response to the listed blocks; omit for bans+faceit+friends. Example: ["bans"] returns the Steam summary plus ban status only | |
| friends_limit | No | max friends in the response, default 100 | |
| friends_detail | No | friend entry shape, default full; short/medium are much smaller |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | the same account in every SteamID format | |
| steam | No | raw Steam GetPlayerSummaries object, null when the Steam block is unavailable | |
| faceit | No | FACEIT player object or null | |
| friends | No | friend entries, shape set by friends_detail | |
| partial | No | true when at least one source was unavailable | |
| sources | No | per block: ok | empty | unavailable | excluded | |
| canonical | No | steamid64 and canonical URL of this player | |
| steamid64 | No | ||
| provenance | No | per source: retrieved_at, age_seconds, fresh, cache_ttl | |
| steam_bans | No | Steam ban fields exactly as Steam reports them | |
| faceit_bans | No | known FACEIT bans |