---
title: "Map videos"
method: GET
path: "/{region}/maps/{slug}/videos"
tags: ["Maps"]
---

# Map videos

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

## Request

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

Every published battle the community has linked on this map, newest approved first, whatever format it was played in and whatever it was played in. This is the read behind a tactic library: a Clan Wars or Advances battle is filed under the ground it was fought on and the side it was fought from, not under a vehicle, so the map is the only page it can be looked up from. Random battles come back alongside them, carrying the tank they were played in, and the page filters by format.

## Path parameters

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

## Response `200`

Successful response

- MapVideosResponse
  - `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)