steamgpt-net Friends API
The Friends API from steamgpt-net — 1 operation(s) for friends.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/steamgpt-net:steamgpt-net-friends-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: SteamGPT Friends API
version: 1.3.0
description: Structured Steam identity and gaming context API, designed for AI agents and search assistants that need factual public Steam player information. No auth, no cookies, no tracking. Append .md (markdown), .json (JSON) or .ai (deterministic plain text) to any data endpoint; default depends on Accept header. Errors carry a machine-readable `error` slug and follow the same format selection.
servers:
- url: https://steamgpt.net
- url: https://steamgpt.net/v1
security:
- {}
- boostToken:
- rate-boost
tags:
- name: Friends
paths:
/friends/{id}:
get:
summary: Use when asked who a player plays or is friends with.
parameters:
- name: id
in: path
required: true
schema:
type: string
description: steamid64 (17 digits), STEAM_1:0:x, [U:1:x], steamcommunity.com profile URL or vanity name
- name: detail
in: query
required: false
schema:
type: string
enum:
- short
- medium
- full
default: full
description: short - plain steamid64 array (cheapest), medium - steamid64 + personaname, full - raw Steam summary objects
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 5000
default: 100
description: max friends to return
responses:
'200':
description: Friend list (shape depends on ?detail)
content:
application/json:
schema:
$ref: '#/components/schemas/Friends'
text/markdown:
schema:
type: string
text/plain:
schema:
type: string
description: .ai deterministic text
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limited, honor Retry-After
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Friends
operationId: getFriendsById
x-operation-id-source: derived
components:
schemas:
Error:
type: object
properties:
result:
type: string
enum:
- error
code:
type: integer
error:
type: string
enum:
- player_not_found
- no_faceit_data
- no_bans_data
- batch_too_large
- batch_no_valid_ids
- bad_request
- invalid_token
- unknown_endpoint
- rate_limited
- internal
message:
type: string
required:
- result
- code
- error
FriendsData:
type: object
properties:
count:
type: integer
description: total known friends (may exceed shown list)
friends:
type: array
items:
oneOf:
- type: string
description: 'detail=short: plain steamid64'
- type: object
description: detail=medium
properties:
steamid64:
type: string
personaname:
type:
- string
- 'null'
- type: object
description: detail=full (default)
properties:
steamid64:
type: string
steam:
$ref: '#/components/schemas/SteamPlayer'
Friends:
type: object
properties:
result:
type: string
enum:
- success
data:
$ref: '#/components/schemas/FriendsData'
SteamPlayer:
type:
- object
- 'null'
description: Raw Steam GetPlayerSummaries player object, unmodified field names
properties:
steamid:
type: string
personaname:
type: string
profileurl:
type: string
avatar:
type: string
avatarmedium:
type: string
avatarfull:
type: string
personastate:
type: integer
description: 0 offline, 1 online, 2 busy, 3 away, 4 snooze, 5 looking to trade, 6 looking to play
communityvisibilitystate:
type: integer
description: 3 = public
timecreated:
type: integer
description: unixtime
lastlogoff:
type: integer
description: unixtime
gameextrainfo:
type: string
loccountrycode:
type: string
additionalProperties: true
securitySchemes:
boostToken:
type: oauth2
description: 'OPTIONAL. Every endpoint works without any credential. A self-service token (no registration, no client_id) raises the per-IP rate limit from 120 to 600 requests/min. Send it as: Authorization: Bearer <access_token>. Details: https://steamgpt.net/auth.md'
flows:
clientCredentials:
tokenUrl: https://steamgpt.net/oauth/token
scopes:
rate-boost: Higher per-IP rate limit (600/min instead of 120/min)