Video Site
REST API Reference • v1.0.0

StreamVault API Documentation

Explore, test, and integrate video streaming endpoints, user interactions, comments, categorizations, and administrative automation with our interactive live playground.

Checking server...
Base Gateway URL:
https://video-site-backend-mrhh.onrender.com/api

HTTP Method

Authentication

Categories

44 APIs
GET
/health
Health Check
Public

Verify backend server availability, PostgreSQL database connection, and system timestamp.

This endpoint takes no URL parameters or body payload.

GET
/videos
Get Videos List
Public

Retrieve paginated list of published videos with optional filtering by category, featured flag, and sorting.

Query Parameters

ParameterTypeDefaultDescription
pagenumber1Page number for pagination
limitnumber12Number of videos per page
categorystring—Filter by category ID or slug
featuredboolean—Filter by featured flag (true/false)
sortstringlatestSort order criteriaOptions: latest, views, oldest
GET
/videos/latest
Get Latest Videos
Public
GET
/videos/search
Search Videos
Public
GET
/videos/:slug
Get Video by Slug
Public
GET
/videos/admin/all
Get All Videos (Admin)
Admin Token
POST
/videos
Create Video
Admin Token
PUT
/videos/:id
Update Video
Admin Token
DELETE
/videos/:id
Delete Video
Admin Token
GET
/categories
Get All Categories
Public
GET
/categories/:slug
Get Category Videos
Public
POST
/categories
Create Category
Admin Token
PUT
/categories/:id
Update Category
Admin Token
DELETE
/categories/:id
Delete Category
Admin Token
GET
/tags
Get All Tags
Public
GET
/tags/:slug
Get Tag Videos
Public
POST
/interactions/like/:videoId
Toggle Like Video
User Token
POST
/interactions/dislike/:videoId
Toggle Dislike Video
User Token
GET
/interactions/comments/:videoId
Get Video Comments
Public
POST
/interactions/comments/:videoId
Add Comment
User Token
GET
/interactions/favorite
Get User Favorites
User Token
POST
/interactions/favorite/:videoId
Toggle Favorite
User Token
GET
/interactions/history
Get Watch History
User Token
POST
/interactions/history/:videoId
Record Watch History
User Token
POST
/users/auth/register
Register User
Public
POST
/users/auth/login
User Login
Public
GET
/users/auth/me
Get Current User Profile
User Token
POST
/users/auth/forgot-password
Forgot Password
Public
PUT
/users/auth/reset-password/:token
Reset Password
Public
POST
/auth/login
Admin Login
Public
GET
/auth/me
Get Current Admin
Admin Token
PUT
/auth/profile
Update Admin Profile
Admin Token
GET
/users
List Users (Admin)
Admin Token
DELETE
/users/:id
Delete User (Admin)
Admin Token
GET
/ads
Get Public Ads
Public
GET
/ads/all
Get All Ads (Admin)
Admin Token
POST
/ads
Create Ad
Admin Token
PUT
/ads/:id
Update Ad
Admin Token
DELETE
/ads/:id
Delete Ad
Admin Token
GET
/dashboard/stats
Get Platform Stats
Admin Token
GET
/settings
Get Site Settings
Public
PUT
/settings
Update Site Settings
Admin Token
Home
Trending
Favorites
Profile