steam-groups.com API

Base URL

https://api.steam-groups.com

GET/api

Example

curl "https://api.steam-groups.com/api"

Response

{
  "name": "steam-groups.com API",
  "docs": "https://steam-groups.com/docs",
  "endpoints": {
    "groups": "/api/groups",
    "groupsBulk": "/api/groups/bulk",
    "groupById": "/api/groups/:id",
    "stats": "/api/stats",
    "analytics": "/api/analytics"
  }
}

GET/api/groups

Query parameters

string

Search query text.

searchType

contains | word | exact | starts | ends

How to match the query. Defaults to contains.

searchFields

string

Comma-separated fields to search: name, tag, url. Defaults to all three.

tag

string

Filter by exact tag match.

privacy

string

Comma-separated privacy values: public, private, friends-only.

excludeLastSeen

boolean

Set to true, 1, or yes to hide last-seen groups.

members

string

Member count filter. Use a single number for minimum, or min,max for a range.

date

string

Date filter. Presets: recent, this-year, last-year, old. Or use YYYY-MM-DD,YYYY-MM-DD for a custom range.

sort

string

Sort order: id-asc, id-desc, members-asc, members-desc, date-asc, date-desc, random.

page

number

Page number. Defaults to 1.

limit

number

Results per page. Defaults to 24, max 10000.

Parameter	Type	Description
q	string	Search query text.
searchType	contains \| word \| exact \| starts \| ends	How to match the query. Defaults to contains.
searchFields	string	Comma-separated fields to search: name, tag, url. Defaults to all three.
tag	string	Filter by exact tag match.
privacy	string	Comma-separated privacy values: public, private, friends-only.
excludeLastSeen	boolean	Set to true, 1, or yes to hide last-seen groups.
members	string	Member count filter. Use a single number for minimum, or min,max for a range.
date	string	Date filter. Presets: recent, this-year, last-year, old. Or use YYYY-MM-DD,YYYY-MM-DD for a custom range.
sort	string	Sort order: id-asc, id-desc, members-asc, members-desc, date-asc, date-desc, random.
page	number	Page number. Defaults to 1.
limit	number	Results per page. Defaults to 24, max 10000.

Example

curl "https://api.steam-groups.com/api/groups?q=csgo&searchType=contains&sort=members-desc&page=1&limit=24"

Response

{
  "data": [
    {
      "id": "123456",
      "name": "CS:GO",
      "url": "https://steamcommunity.com/groups/csgo",
      "members": 1200000,
      "privacy": "public",
      "created": "2012-08-21",
      "avatar": "https://steamcdn-a.akamaihd.net/...",
      "tag": "CSGO",
      "owner": "76561198000000000",
      "tagUsedBy": 1,
      "isLastSeen": false
    }
  ],
  "pagination": {
    "total": 1000,
    "page": 1,
    "limit": 24,
    "totalPages": 42,
    "totalApproximate": true
  }
}

POST/api/groups/bulk

Request body

ids

number[]

Array of positive integer group IDs.

limit

number

Maximum IDs allowed per request. Defaults to 1000, max 10000.

Parameter	Type	Description
ids	number[]	Array of positive integer group IDs.
limit	number	Maximum IDs allowed per request. Defaults to 1000, max 10000.

Example

curl -X POST "https://api.steam-groups.com/api/groups/bulk" \
  -H "Content-Type: application/json" \
  -d '{"ids":[123456,789012],"limit":10000}'

Response

{
  "data": [
    {
      "id": "123456",
      "name": "CS:GO",
      "url": "https://steamcommunity.com/groups/csgo",
      "members": 1200000,
      "privacy": "public",
      "created": "2012-08-21",
      "avatar": "https://steamcdn-a.akamaihd.net/...",
      "tag": "CSGO",
      "owner": "76561198000000000",
      "tagUsedBy": 1,
      "isLastSeen": false
    }
  ],
  "notFound": [789012]
}

GET/api/groups/:id

Path parameters

number

Numeric Steam group ID.

Parameter	Type	Description
id	number	Numeric Steam group ID.

Example

curl "https://api.steam-groups.com/api/groups/123456"

Response

{
  "id": "123456",
  "name": "CS:GO",
  "url": "https://steamcommunity.com/groups/csgo",
  "members": 1200000,
  "privacy": "public",
  "created": "2012-08-21",
  "avatar": "https://steamcdn-a.akamaihd.net/...",
  "tag": "CSGO",
  "owner": "76561198000000000",
  "tagUsedBy": 1,
  "isLastSeen": false
}

GET/api/stats

Example

curl "https://api.steam-groups.com/api/stats"

Response

{
  "last24Hours": 120,
  "last7Days": 840,
  "last30Days": 3600
}

GET/api/analytics

Example

curl "https://api.steam-groups.com/api/analytics"

Response

{
  "createdOverTime": [
    { "period": "2012-08", "groups": 75782 }
  ],
  "memberDistribution": [
    { "members": "1-9", "groups": 19715688, "memberMin": 1, "memberMax": 9 }
  ],
  "privacy": {
    "public": 31616584,
    "private": 0,
    "friendsOnly": 0,
    "total": 31616584
  }
}

Errors

{
  "error": {
    "code": "GROUP_NOT_FOUND",
    "message": "Group not found"
  }
}

400

Bad Request

Invalid parameters, such as a non-numeric group ID.

404

Not Found

The requested group does not exist.

500

Server Error

An unexpected error occurred.

Parameter	Type	Description
400	Bad Request	Invalid parameters, such as a non-numeric group ID.
404	Not Found	The requested group does not exist.
500	Server Error	An unexpected error occurred.