---
title: "Search discoverable guilds"
method: GET
path: "/discovery/guilds"
tags: ["Discovery"]
---

# Search discoverable guilds

`GET /discovery/guilds`

Search for guilds listed in the discovery directory.

## Query parameters

- `query` string — Search query
- `category` integer — Filter by category
- `language` string — Filter by primary community language
- `tag` string — Filter by a specific custom tag
- `sort_by` 'member_count' | 'online_count' | 'relevance' — Sort order
- `limit` integer — Number of results to return
- `offset` integer — Pagination offset

## Response `200`

Success

- DiscoveryGuildListResponse
  - `guilds` object[], required — Discovery guild results
    - `id` string, required — Guild ID
    - `name` string, required — Guild name
    - `icon` string, nullable — Guild icon hash
    - `banner` string, nullable — Guild banner hash
    - `description` string, nullable — Discovery description
    - `category_type` number, required — Discovery category type
    - `primary_language` string, nullable — Primary community language
    - `custom_tags` string[], required — Custom discovery tags
    - `member_count` number, required — Approximate member count
    - `online_count` number, required — Approximate online member count
    - `features` string[], required — Guild feature flags
    - `verification_level` number, required — Verification level
  - `total` number, required — Total number of matching guilds
  - `category_counts` object[], required — Match counts per category for the current filters, ignoring the category filter
    - `category_type` number, required — Discovery category type
    - `count` number, required — Number of matching guilds in this category

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid data
- `401` — Unauthorized - Authentication is required or the token is invalid
- `403` — Forbidden - You do not have permission to perform this action
- `429` — Too Many Requests - You are being rate limited
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/fluxer/apis/fluxer-api.md) · [All operations](https://skmtc.dev/fluxer/apis/fluxer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluxer/fluxer-api/revisions/d9c706133cc5/schema)