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

# Tank videos

`GET /{region}/tanks/{slug}/videos`

## Request

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

Community-suggested gameplay videos for one tank, newest approved first. Each entry is a battle rather than a whole video: it carries the second it starts at, so a three-hour stream VOD can be linked at the minute this tank is played. The map, mode and result are declared by the submitter and checked in moderation; the spawn direction is derived from the map's own geometry. Region-independent, the same list is served on every region. Suggesting one is a write, and lives on `/videos/suggest`.

## Path parameters

- `region` 'eu' | 'na' | 'asia', required: Game server region.
- `slug` string, required: Tank slug (e.g. is-7).

## Response `200`

Successful response

- TankVideosResponse
  - `videos` TankVideo[], 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.

---

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