---
title: "List all video tags"
method: GET
path: "/tags"
tags: ["Tags"]
---

# List all video tags

`GET /tags`

This endpoint enables you to search for video tags in a project and see how many videos are tagged with them. If you do not define any query parameters, the endpoint lists all video tags and the numbers of times they are used in a project.

## Query parameters

- `value` string
- `sortBy` 'value' | 'videoCount'
- `sortOrder` 'asc' | 'desc'
- `currentPage` integer
- `pageSize` integer

## Response `200`

Success

- ListTagsResponse
  - `data` ListTagsResponseData[]
    - `value` string — Returns the value of a video tag used in your project.
    - `videoCount` integer — Returns the number of times a video tag is used.
  - `pagination` Pagination
    - `itemsTotal` integer — Total number of items that exist.
    - `pagesTotal` integer — Number of items listed in the current page.
    - `pageSize` integer — Maximum number of item per page.
    - `currentPage` integer — The current page index.
    - `currentPageItems` integer — The number of items on the current page.
    - `links` PaginationLink[], required
      - `rel` string
      - `uri` string, uri

## Other responses

- `429` — Too Many Requests

## Changes

> 50 revisions in range; 1 not diffed.

- **2024-10-02** `ebf092536903` — 1 info
  - endpoint added
- **2022-02-07** `2a4d90a64f88` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/apivideo/apis/api-video/changes/tags/get.md)

---

[API](https://skmtc.dev/apivideo/apis/api-video.md) · [All operations](https://skmtc.dev/apivideo/apis/api-video/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apivideo/api-video/revisions/45ec26f342b6/schema)