Tube Archivist Video API
The Video API from Tube Archivist — 6 operation(s) for video.
The Video API from Tube Archivist — 6 operation(s) for video.
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/tubearchivist:tubearchivist-video-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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: Tubearchivist Video API
version: v0.6.0
description: 'Operations tagged Video across 2 of this provider''s published API definitions: schema.yaml, tubearchivist-openapi.yml. Each path carries the servers of the definition it was published in.'
tags:
- name: Video
paths:
/api/video/:
get:
operationId: api_video_retrieve
description: get video list
parameters:
- in: query
name: channel
schema:
type: string
minLength: 1
- in: query
name: height
schema:
type: integer
- in: query
name: order
schema:
enum:
- asc
- desc
type: string
minLength: 1
description: '* `asc` - asc
* `desc` - desc'
- in: query
name: page
schema:
type: integer
- in: query
name: playlist
schema:
type: string
minLength: 1
- in: query
name: sort
schema:
enum:
- published
- downloaded
- views
- likes
- duration
- mediasize
- width
- height
type: string
minLength: 1
description: '* `published` - published
* `downloaded` - downloaded
* `views` - views
* `likes` - likes
* `duration` - duration
* `mediasize` - mediasize
* `width` - width
* `height` - height'
- in: query
name: type
schema:
enum:
- videos
- streams
- shorts
type: string
minLength: 1
description: '* `videos` - videos
* `streams` - streams
* `shorts` - shorts'
- in: query
name: watch
schema:
enum:
- watched
- unwatched
- continue
- null
type:
- string
- 'null'
minLength: 1
description: '* `watched` - watched
* `unwatched` - unwatched
* `continue` - continue'
tags:
- Video
security:
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/VideoList'
description: ''
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: bad request
summary: Api video retrieve
x-summary-source: derived
/api/video/{video_id}/:
get:
operationId: api_video_retrieve_2
description: get video
parameters:
- in: path
name: video_id
schema:
type: string
required: true
tags:
- Video
security:
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Video'
description: ''
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: video not found
summary: Api video retrieve 2
x-summary-source: derived
delete:
operationId: api_video_destroy
description: delete video
parameters:
- in: path
name: video_id
schema:
type: string
required: true
tags:
- Video
security:
- tokenAuth: []
responses:
'204':
description: video deleted
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: video not found
summary: Api video destroy
x-summary-source: derived
/api/video/{video_id}/comment/:
get:
operationId: api_video_comment_retrieve
description: get video comments
parameters:
- in: path
name: video_id
schema:
type: string
required: true
tags:
- Video
security:
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CommentItem'
description: ''
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: video not found
summary: Api video comment retrieve
x-summary-source: derived
/api/video/{video_id}/nav/:
get:
operationId: api_video_nav_retrieve
description: get video playlist nav
parameters:
- in: path
name: video_id
schema:
type: string
required: true
tags:
- Video
security:
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PlaylistNavItem'
description: ''
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: video not found
summary: Api video nav retrieve
x-summary-source: derived
/api/video/{video_id}/progress/:
post:
operationId: api_video_progress_create
description: set video progress position in redis
parameters:
- in: path
name: video_id
schema:
type: string
required: true
tags:
- Video
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/VideoProgressUpdate'
application/x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/VideoProgressUpdate'
multipart/form-data:
schema:
$ref: '#/components/schemas/VideoProgressUpdate'
security:
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Player'
description: ''
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: video not found
summary: Api video progress create
x-summary-source: derived
delete:
operationId: api_video_progress_destroy
description: delete progress position
parameters:
- in: path
name: video_id
schema:
type: string
required: true
tags:
- Video
security:
- tokenAuth: []
responses:
'204':
description: video progress deleted
summary: Api video progress destroy
x-summary-source: derived
/api/video/{video_id}/similar/:
get:
operationId: api_video_similar_list
description: get similar videos
parameters:
- in: path
name: video_id
schema:
type: string
required: true
tags:
- Video
security:
- tokenAuth: []
responses:
'200':
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Video'
description: ''
summary: Api video similar list
x-summary-source: derived
components:
schemas:
VideoList:
type: object
description: serialize video list
properties:
data:
type: array
items:
$ref: '#/components/schemas/Video'
paginate:
$ref: '#/components/schemas/Pagination'
required:
- data
- paginate
ExtEnum:
enum:
- json3
- vtt
type: string
description: '* `json3` - json3
* `vtt` - vtt'
PlaylistNavMeta:
type: object
description: serialize playlist nav meta
properties:
current_idx:
type: integer
playlist_id:
type: string
playlist_name:
type: string
playlist_channel:
type: string
required:
- current_idx
- playlist_channel
- playlist_id
- playlist_name
StreamItem:
type: object
description: serialize stream item
properties:
bitrate:
type: integer
codec:
type: string
height:
type: integer
index:
type: integer
type:
$ref: '#/components/schemas/TypeEnum'
width:
type: integer
required:
- bitrate
- codec
- index
- type
SponsorBlockSegment:
type: object
description: serialize sponsorblock segment
properties:
actionType:
type: string
videoDuration:
type: number
format: double
segment:
type: array
items:
type: number
format: double
votes:
type: integer
category:
type: string
UUID:
type: string
locked:
type: integer
required:
- UUID
- actionType
- category
- locked
- segment
- videoDuration
- votes
VidTypeFilterEnum:
enum:
- videos
- streams
- shorts
type: string
description: '* `videos` - videos
* `streams` - streams
* `shorts` - shorts'
SponsorBlock:
type: object
description: serialize sponsorblock
properties:
is_enabled:
type: boolean
last_refresh:
type: integer
has_unlocked:
type: boolean
segments:
type: array
items:
$ref: '#/components/schemas/SponsorBlockSegment'
required:
- is_enabled
- last_refresh
- segments
Stats:
type: object
description: serialize stats
properties:
like_count:
type: integer
average_rating:
type: number
format: double
view_count:
type: integer
dislike_count:
type: integer
required:
- average_rating
- dislike_count
- like_count
- view_count
SubtitleItem:
type: object
description: serialize subtitle item
properties:
ext:
$ref: '#/components/schemas/ExtEnum'
lang:
type: string
media_url:
type: string
name:
type: string
source:
$ref: '#/components/schemas/SourceEnum'
url:
type:
- string
- 'null'
format: uri
required:
- ext
- lang
- media_url
- name
- source
- url
ErrorResponse:
type: object
description: error message
properties:
error:
type: string
required:
- error
TypeEnum:
enum:
- video
- audio
type: string
description: '* `video` - video
* `audio` - audio'
CommentItem:
type: object
description: serialize comment item
properties:
comment_author:
type: string
comment_author_id:
type: string
comment_author_is_uploader:
type: boolean
comment_author_thumbnail:
type: string
format: uri
comment_id:
type: string
comment_is_favorited:
type: boolean
comment_likecount:
type: integer
comment_parent:
type: string
comment_text:
type: string
comment_time_text:
type: string
comment_timestamp:
type: integer
comment_replies:
type: array
items: {}
readOnly: true
required:
- comment_author
- comment_author_id
- comment_author_is_uploader
- comment_author_thumbnail
- comment_id
- comment_is_favorited
- comment_likecount
- comment_parent
- comment_replies
- comment_text
- comment_time_text
- comment_timestamp
Pagination:
type: object
description: serialize paginate response
properties:
page_size:
type: integer
page_from:
type: integer
prev_pages:
type:
- array
- 'null'
items:
type: integer
current_page:
type: integer
max_hits:
type: boolean
params:
type: string
last_page:
type: integer
next_pages:
type:
- array
- 'null'
items:
type: integer
total_hits:
type: integer
required:
- current_page
- last_page
- max_hits
- next_pages
- page_from
- page_size
- params
- prev_pages
- total_hits
Video:
type: object
description: serialize video item
properties:
active:
type: boolean
category:
type: array
items:
type: string
channel:
$ref: '#/components/schemas/Channel'
comment_count:
type:
- integer
- 'null'
date_downloaded:
type: integer
description:
type:
- string
- 'null'
media_size:
type: integer
media_url:
type: string
player:
$ref: '#/components/schemas/Player'
playlist:
type: array
items:
type: string
published:
type: string
sponsorblock:
allOf:
- $ref: '#/components/schemas/SponsorBlock'
stats:
$ref: '#/components/schemas/Stats'
streams:
type: array
items:
$ref: '#/components/schemas/StreamItem'
subtitles:
type: array
items:
$ref: '#/components/schemas/SubtitleItem'
tags:
type: array
items:
type: string
title:
type: string
vid_last_refresh:
type: string
vid_thumb_url:
type: string
vid_type:
$ref: '#/components/schemas/VidTypeFilterEnum'
youtube_id:
type: string
_index:
type: string
title: ' index'
_score:
type: number
format: double
title: ' score'
required:
- active
- category
- date_downloaded
- media_size
- media_url
- player
- published
- stats
- streams
- tags
- title
- vid_last_refresh
- vid_thumb_url
- vid_type
- youtube_id
PlaylistNavItem:
type: object
description: serialize nav on playlist
properties:
playlist_meta:
$ref: '#/components/schemas/PlaylistNavMeta'
playlist_previous:
allOf:
- $ref: '#/components/schemas/PlaylistNavVideo'
playlist_next:
allOf:
- $ref: '#/components/schemas/PlaylistNavVideo'
required:
- playlist_meta
- playlist_next
- playlist_previous
PlaylistNavVideo:
type: object
description: serialize video item on playlist nav
properties:
youtube_id:
type: string
title:
type: string
uploader:
type: string
idx:
type: integer
downloaded:
type: boolean
vid_thumb:
type: string
required:
- downloaded
- idx
- title
- uploader
- vid_thumb
- youtube_id
Player:
type: object
description: serialize player
properties:
watched:
type: boolean
watched_date:
type: integer
duration:
type: integer
duration_str:
type: string
progress:
type: number
format: double
position:
type: number
format: double
required:
- duration
- duration_str
- watched
ChannelOverwrite:
type: object
description: serialize channel overwrites
properties:
download_format:
type:
- string
- 'null'
autodelete_days:
type:
- integer
- 'null'
index_playlists:
type:
- boolean
- 'null'
integrate_sponsorblock:
type:
- boolean
- 'null'
subscriptions_channel_size:
type:
- integer
- 'null'
subscriptions_live_channel_size:
type:
- integer
- 'null'
subscriptions_shorts_channel_size:
type:
- integer
- 'null'
VideoProgressUpdate:
type: object
description: serialize progress update data
properties:
position:
type: number
format: double
default: 0.0
Channel:
type: object
description: serialize channel
properties:
channel_id:
type: string
channel_active:
type: boolean
channel_banner_url:
type:
- string
- 'null'
channel_thumb_url:
type:
- string
- 'null'
channel_tvart_url:
type:
- string
- 'null'
channel_description:
type:
- string
- 'null'
channel_last_refresh:
type: string
channel_name:
type: string
channel_overwrites:
$ref: '#/components/schemas/ChannelOverwrite'
channel_subs:
type: integer
channel_subscribed:
type: boolean
channel_tags:
type: array
items:
type: string
channel_tabs:
type: array
items:
$ref: '#/components/schemas/VidTypeFilterEnum'
_index:
type: string
title: ' index'
_score:
type: integer
title: ' score'
required:
- channel_active
- channel_id
- channel_last_refresh
- channel_name
- channel_subs
- channel_subscribed
- channel_tabs
SourceEnum:
enum:
- user
- auto
type: string
description: '* `user` - user
* `auto` - auto'
securitySchemes:
basicAuth:
type: http
scheme: basic
cookieAuth:
type: apiKey
in: cookie
name: sessionid
tokenAuth:
type: apiKey
in: header
name: Authorization
description: Token-based authentication with required prefix "Token"
x-refined-from:
- schema.yaml
- tubearchivist-openapi.yml