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

# Search players

`GET /{region}/players/search`

## Request

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

Search players by nickname 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

- PlayerSearchResponse
  - `results` PlayerSearchHit[], required
    - `account_id` number, required
    - `nickname` string, required
    - `clan` object, nullable, required: The player's clan tag and color, when tracked.
      - `tag` string, required
      - `color` string, required
    - `is_verified` boolean
    - `tournament_wins` number: Tournaments this account was on the winning roster of, for the winner's crest.
    - `tournament_featured_wins` number
    - `tournament_best_title` string, nullable
    - `onslaught_best_tier` string, nullable
    - `onslaught_best_rank` number, nullable
    - `onslaught_seasons` number
    - `is_supporter` boolean
    - `twitch_login` 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)