---
title: "Community videos"
method: GET
path: "/{region}/videos"
tags: ["Tanks"]
---

# Community videos

`GET /{region}/videos`

## Request

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

Every published battle the community has suggested, newest approved first, whatever the tank. Each entry is a battle rather than a whole video, carrying the second it starts at, so one recording appears once per battle marked in it. The per-tank endpoint returns the same rows filtered to one tank; this one is what shows a video whole, with every tank it covers. Region-independent, the same list is served on every region.

## Path parameters

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

## Query parameters

- `videoId` string: Narrow to one video's battles, ordered by timestamp.

## Response `200`

Successful response

- CommunityVideosResponse
  - `videos` VideoBattleWithTank[], required
    - `id` integer, required
    - `videoId` string, required
    - `startSeconds` integer, required: Where the battle starts in the video, in seconds.
    - `title` string, required
    - `channelName` string, required
    - `mapName` string, nullable, required
    - `mapSlug` string, nullable, required
    - `arenaId` string, nullable, required: The arena the battle was played on. Carried so a client can name the map in the reader's language, since `mapName` is the English the row was stored with.
    - `mode` 'standard' | 'encounter' | 'assault' | 'attack-defense', required: Random-battle game mode a map supports.
    - `direction` 'north' | 'south' | 'east' | 'west', required: Side of the map a team starts from.
    - `directionLabel` string, nullable, required
    - `result` 'victory' | 'defeat' | 'draw', required: How the battle ended, as declared by the submitter.
    - `format` 'random' | 'clan_wars' | 'advances' | 'skirmish' | 'maneuvers' | 'onslaught' | 'tournament', required: Format the battle was played in.
    - `teamSize` integer, nullable, required: Players per team, from the format where it fixes one and from the submitter otherwise.
    - `tier` integer, nullable, required: Tier the battle was fought at, on the same rule as team size.
    - `clan` VideoClanCredit, nullable, required: Clan the battle was played for, resolved from a stored id so a rename cannot strand the credit.
      - `region` 'eu' | 'na' | 'asia', required: Game server region.
      - `id` integer, required
      - `tag` string, required
      - `name` string, required
      - `color` string, nullable, required: The clan's own colour, which its tag is rendered in.
      - `emblem` string, nullable, required: The clan's emblem, drawn beside its tag.
    - `combinedDamage` integer, nullable, required: Damage dealt plus assisted, as declared. Only ever set on a random battle.
    - `tankId` integer, nullable, required
    - `tankName` string, nullable, required
    - `tankSlug` string, nullable, required
    - `tankShortName` string, nullable, required
    - `tankTag` string, nullable, required
    - `vehicleTier` integer, nullable, required: The vehicle's tier, as opposed to the battle's.
    - `nation` string, nullable, required
    - `type` string, nullable, required
    - `role` string, nullable, required
    - `isPremium` boolean, required
    - `isReward` boolean, 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)