---
title: "Search clans"
method: GET
path: "/{region}/clans/search"
tags: ["Clans"]
---

# Search clans

`GET /{region}/clans/search`

## Request

- Base URL: `https://unicum.gg/api`
- URL: `https://unicum.gg/api/{region}/clans/search`
- Auth: none required

Search clans by name or tag prefix (minimum 3 characters). Returns the combined result set in a single JSON response: our database hits first, then Wargaming API hits (deduped). Waits for the (rate-limited) Wargaming call, so it can be slower than the streamed variant. For progressive results, use `/search/ndjson`.

## Path parameters

- `region` 'eu' | 'na' | 'asia', required: Game server region.

## Query parameters

- `q` string, required: Search prefix.

## Response `200`

Successful response

- ClanSearchResponse
  - `results` ClanSummary[], required
    - `clan_id` number, required
    - `tag` string, required
    - `name` string, required
    - `winrate` number, nullable
    - `badges` ClanRankBadge[]
      - `board` 'advances' | 't10' | 't8' | 't6', required: The leaderboard this placing is on.
      - `rank` integer, required
    - `tournament_wins` number
    - `tournament_featured_wins` number
    - `tournament_best_title` string, nullable

---

[API](https://skmtc.dev/unicum/apis/unicum-gg-api.md) · [All operations](https://skmtc.dev/unicum/apis/unicum-gg-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unicum/apis/unicum-gg-api/revisions/7a7d79a26001?raw)