v1

latestOpenAPI 3.0.02026-07-175989869.3 KB

List all video 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.

get/tags

Query parameters

valuestring

Use this parameter to search for specific video tags. The API filters results even on partial values, and ignores accents, uppercase, and lowercase.

sortBy'value' | 'videoCount'

Use this parameter to choose which field the API will use to sort the response data. The default is value.

These are the available fields to sort by:

value: Sorts the results based on tag values in alphabetic order.
videoCount: Sorts the results based on the number of times a video tag is used.

sortOrder'asc' | 'desc'

Use this parameter to sort results. asc is ascending and sorts from A to Z. desc is descending and sorts from Z to A.

currentPageinteger

Choose the number of search results to return per page. Minimum value: 1

pageSizeinteger

Results per page. Allowed values 1-100, default is 25.

Response

Success

Example response

{
  "pagination": {
    "itemsTotal": 123,
    "pagesTotal": 7,
    "pageSize": 20,
    "currentPage": 3,
    "currentPageItems": 20,
    "links": {
      "first": {
        "rel": "first",
        "uri": "/videos/search?currentPage=1&pageSize=20"
      },
      "previous": {
        "rel": "previous",
        "uri": "/videos/search?currentPage=2&pageSize=20"
      },
      "next": {
        "rel": "next",
        "uri": "/videos/search?currentPage=4&pageSize=20"
      },
      "last": {
        "rel": "last",
        "uri": "/videos/search?currentPage=6&pageSize=20"
      }
    }
  },
  "data": [
    {
      "videoCount": 0,
      "value": "value"
    },
    {
      "videoCount": 0,
      "value": "value"
    }
  ]
}