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

# Top clans

`GET /{region}/clans/top`

## Request

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

Clan leaderboard for a region.

## Path parameters

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

## Query parameters

- `period` 'overall' | '30d': Clan leaderboard time window.
- `limit` integer: Maximum number of rows to return. Out-of-range values are clamped.
- `metric` 'wn7' | 'wn8' | 'wnx': Rating metric the leaderboard is ranked by.
- `lang` string: Two-letter language code. When set, the leaderboard is filtered to players/clans whose clan declares this language (period is ignored: language boards are lifetime WNX).
- `language` string: Deprecated alias of `lang`, accepted while callers move. `lang` wins when both are given. Renamed because `language` elsewhere in this API asks for the language the ANSWER is written in, and this one selects which rows are in it.
- `strict` 'true' | 'false': With `lang`: only count clans that declare exactly this one language.
- `languages` 'true' | 'false': Return the lifetime by-language board (each row carries its inferred languages) without filtering to one language. The recent periods always carry them.

## Response `200`

Successful response

- TopClansResponse
  - `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
  - `computed_at` string, nullable, required

---

[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)