API.Video Tags API
The Tags API from API.Video — 1 operation(s) for tags.
The Tags API from API.Video — 1 operation(s) for tags.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/api-video:api-video-tags-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: api.video Tags API
description: api.video is an API that encodes on the go to facilitate immediate playback, enhancing viewer streaming experiences across multiple devices and platforms. You can stream live or on-demand online videos within minutes.
version: '1'
servers:
- url: https://ws.api.video
description: Production server
- url: https://sandbox.api.video
description: Test server `all videos are watermarked, and deleted after 24 hours.
tags:
- name: Tags
paths:
/tags:
get:
tags:
- Tags
summary: List all video tags
description: 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.
operationId: LIST-tags
x-client-action: list
x-group-parameters: true
x-client-paginated: true
parameters:
- name: value
in: query
description: 'Use this parameter to search for specific video tags. The API filters results even on partial values, and ignores accents, uppercase, and lowercase.
'
required: false
style: form
explode: true
schema:
type: string
- name: sortBy
in: query
description: '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.
'
required: false
style: form
explode: true
schema:
type: string
enum:
- value
- videoCount
example: value
- name: sortOrder
in: query
description: Use this parameter to sort results. `asc` is ascending and sorts from A to Z. `desc` is descending and sorts from Z to A.
required: false
style: form
explode: true
schema:
type: string
enum:
- asc
- desc
example: asc
- $ref: '#/components/parameters/current-page'
- $ref: '#/components/parameters/page-size'
responses:
'200':
headers:
X-RateLimit-Limit:
schema:
type: integer
description: The request limit per minute.
X-RateLimit-Remaining:
schema:
type: integer
description: The number of available requests left for the current time window.
X-RateLimit-Retry-After:
schema:
type: integer
description: The number of seconds left until the current rate limit window resets.
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/list-tags-response'
examples:
response:
value:
data:
- value: maths
videoCount: '33'
- value: tutorials
videoCount: '10'
pagination:
currentPage: 1
pageSize: 25
pagesTotal: 1
itemsTotal: 2
currentPageItems: 2
links:
- rel: self
uri: /tags?currentPage=1&pageSize=25
- rel: first
uri: /tags?currentPage=1&pageSize=25
- rel: last
uri: /tags?currentPage=1&pageSize=25
'429':
headers:
X-RateLimit-Limit:
schema:
type: integer
description: The request limit per minute.
X-RateLimit-Remaining:
schema:
type: integer
description: The number of available requests left for the current time window.
X-RateLimit-Retry-After:
schema:
type: integer
description: The number of seconds left until the current rate limit window resets.
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/too-many-requests'
examples:
Too many requests:
value:
type: https://docs.api.video/reference/too-many-requests
title: Too many requests.
status: 429
components:
parameters:
current-page:
name: currentPage
in: query
description: 'Choose the number of search results to return per page. Minimum value: 1'
required: false
style: form
explode: true
schema:
type: integer
default: 1
example: 2
page-size:
name: pageSize
in: query
description: Results per page. Allowed values 1-100, default is 25.
required: false
style: form
explode: true
schema:
type: integer
default: 25
example: 30
schemas:
list-tags-response:
title: Tags
type: object
properties:
data:
type: array
items:
type: object
properties:
value:
description: Returns the value of a video tag used in your project.
type: string
videoCount:
description: Returns the number of times a video tag is used.
type: integer
pagination:
$ref: '#/components/schemas/pagination'
too-many-requests:
title: TooManyRequests
type: object
properties:
type:
description: A link to the error documentation.
type: string
title:
description: A description of the error that occurred.
type: string
status:
description: The HTTP status code.
type: integer
pagination-link:
title: PaginationLink
type: object
properties:
rel:
type: string
uri:
type: string
format: uri
pagination:
title: Pagination
required:
- links
type: object
properties:
itemsTotal:
type: integer
description: Total number of items that exist.
readOnly: true
pagesTotal:
type: integer
description: Number of items listed in the current page.
readOnly: true
pageSize:
type: integer
description: Maximum number of item per page.
readOnly: true
currentPage:
type: integer
description: The current page index.
readOnly: true
currentPageItems:
type: integer
description: The number of items on the current page.
readOnly: true
links:
type: array
items:
$ref: '#/components/schemas/pagination-link'
example:
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
securitySchemes:
bearerAuth:
type: http
scheme: bearer
apiKey:
type: http
scheme: basic
x-stoplight:
id: ybzk39fiws46g
x-client-base-paths:
production: https://ws.api.video
sandbox: https://sandbox.api.video
x-doctave:
explorer-enabled: true
proxy-enabled: true
samples-enabled: true
samples-languages:
- curl
- go
- node
- php
- python
x-provenance:
method: harvested
publisher: API.Video
source: https://docs.api.video/openapi.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)