videos

media

Video content with creator information, duration, engagement metrics (views, likes, dislikes, comments), category, tags, and publication date. Used for video sharing platforms, content management systems, and media libraries.

Request Builder

https://api.mockly.codes/videos?page=1&limit=10&count=10

Configure your request and click Send Request to see the response here.

Endpoints

GET/videos

Get a collection of videos

Alternative: /media/videos
GET/videos/:id

Get a single video by ID

Alternative: /media/videos/:id
GET/videos/meta

Get resource metadata and schema

Alternative: /media/videos/meta

How to Use Search

The search feature allows you to filter results by searching for text across all or specific fields. Choose between ?q= or ?search= parameter names.

1. Basic Search

Search across all text fields:

Basic Search
GET https://api.mockly.codes/videos?q=laptop

2. Search Specific Fields

Field-Specific Search
GET https://api.mockly.codes/videos?q=laptop&search_fields=name,description

Pro Tips

  • Search is case-insensitive and performs partial matching
  • Without search_fields, all text fields are searched
  • Combine with pagination to handle large result sets efficiently

Code Examples

JavaScript

Fetch Collection
// Get 10 videos
fetch('https://api.mockly.codes/videos?count=10')
  .then(res => res.json())
  .then(data => console.log(data));

Python

Fetch with Requests
import requests

response = requests.get(
    'https://api.mockly.codes/videos?count=10'
)
data = response.json()

cURL

Command Line
curl "https://api.mockly.codes/videos?count=10"

Bypass Cache

Get Fresh Data
fetch('https://api.mockly.codes/videos?nocache=true')

Schema Properties

idinteger

Unique identifier for the video

Gen:random_int
titlestring

Title of the video

Gen:sentence
descriptionstring

Video description or summary

Gen:paragraph
creatorstring

Full name of the video creator or channel

Gen:name
creator_idinteger

Foreign key reference to the user or channel who created the video

Gen:random_int
durationinteger

Video duration in seconds

Gen:video_duration
viewsinteger

Total number of times the video has been viewed

Gen:random_int
likesinteger

Number of likes or positive reactions

Gen:random_int
dislikesinteger

Number of dislikes or negative reactions

Gen:random_int
comments_countinteger

Total number of comments on the video

Gen:random_int
categorystring

Video category (e.g., Entertainment, Education, Gaming, Music, Sports)

Gen:video_category
tagsarray

Array of tags for categorization and search

Gen:tags
thumbnailstring

URL to the video thumbnail image

Gen:image_urluri
urlstring

URL to watch or download the video

Gen:urluri
published_atstring

Timestamp when the video was published

Gen:past_datedate-time

Query Parameters

countinteger

Number of items to return (default: 10, max: 100)

seedinteger

Seed for reproducible data generation

nocacheboolean

Bypass cache and generate fresh data on every request