Skip to main content
GET
/
v1
/
guilds
/
search
curl "https://hapi.7331.org/v1/guilds/search?q=example&limit=10" \
  -b cookies.txt

{
  "guilds": [
    {
      "discord_id": "987654321098765432",
      "name": "Example Server",
      "member_count": 150,
      "state": 0,
      "subscription_tier": 0
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}
Requires an active session cookie. Available to any logged-in user.
​
q
string
Search query (max 50 characters). Searches by guild name or Discord ID.
​
tier
integer
Filter by subscription tier. 0 = Basic, 1 = Trial, 2 = Premium, 3 = Lifetime.
​
state
integer
Filter by guild state. 0 = Active, 1 = Inactive, 2 = Banned.
​
limit
integer
default:"50"
Page size. Range: 1-100.
​
offset
integer
default:"0"
Offset for pagination. Range: 0-10000.

​
Response

​
guilds
object[]
required
Page of guild objects.
​
total
integer
required
Total matching guilds.
​
limit
integer
required
Page size used.
​
offset
integer
required
Offset used.
curl "https://hapi.7331.org/v1/guilds/search?q=example&limit=10" \
  -b cookies.txt

{
  "guilds": [
    {
      "discord_id": "987654321098765432",
      "name": "Example Server",
      "member_count": 150,
      "state": 0,
      "subscription_tier": 0
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}