Skip to content
SteamSets
Esc
↑↓navigate↵open⌘Jpreview

Get Steam groups by id

Returns Steam groups by id.

Request

groupIds takes up to 100 Steam group ids. A group id is the low 32 bits of the group’s SteamID64 (its gid).

Response

Groups that SteamSets knows come back in request order with their name, vanity, tag, headline, avatar, member count, privacy, founding time and isRemoved. Ids that SteamSets does not know are in missing. The group owner is not included; look accounts up with account.get.

Freshness

Groups follow steamsets.com within about a minute. A group’s own data is as fresh as SteamSets’ last read of its page.

Cost

Each id uses one unit of the key’s 5,000 daily units, found or not.

Example

{
  "groups": [
    {
      "groupId": 4,
      "name": "SteamSets",
      "vanity": "steamsets",
      "tag": "SSETS",
      "memberCount": 1520,
      "privacy": "public",
      "foundedAt": "2019-03-01T00:00:00Z",
      "isRemoved": false
    }
  ],
  "missing": []
}
POST/v1/group.get
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
groupIdsinteger<int32>[]required

Steam group ids: the low 32 bits of the group's gid (SteamID64). Each id uses one unit of the key's daily allowance, found or not.

min items 1 · max items 100
Responses
200

OK

groupsGroupGetGroup[]required

The requested groups SteamSets knows, in request order.

Show properties
Array of GroupGetGroup
avatarstringrequired
foundedAtstring<date-time>
groupIdinteger<int32>required
min 0
headlinestringrequired
isRemovedbooleanrequired

Valve took the group's page down. Steam still answers for the group.

memberCountinteger<int64>required
namestringrequired
privacystringrequired

Who can join, as Steam reports it.

Allowed:publicrequestOnlyinviteOnlyhidden
tagstringrequired
vanitystringrequired

The name in steamcommunity.com/groups/<vanity>.

missinginteger<int32>[]required

The requested ids SteamSets does not know.

400

Bad Request

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
401

Unauthorized

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
422

Unprocessable Entity

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
429

Too Many Requests

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
500

Internal Server Error

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X POST 'https://api.steamsets.com/v1/group.get' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "groupIds": [
    4
  ]
}'
Response
{
  "groups": [
    {
      "avatar": "string",
      "foundedAt": "2019-08-24T14:15:22Z",
      "groupId": 0,
      "headline": "string",
      "isRemoved": true,
      "memberCount": 0,
      "name": "string",
      "privacy": "public",
      "tag": "string",
      "vanity": "string"
    }
  ],
  "missing": [
    0
  ]
}