# Video Scenes endpoints
Video scenes are curated groups of thematically related videos. Each scene contains a set of videos that share a common visual theme or subject, making it easy to find cohesive footage for a project.
# List video scenes
This endpoint will return a paginated list of all published video scenes, sorted by video count. Each scene includes up to 4 preview videos.
GET /video-scenes
# Parameters
| Param | Description |
|---|---|
page | Page number. Number. Default: 0 |
page_size | Number of scenes per page. Number. Default: 18 |
# Response
{
"page": 0,
"pages": 13,
"page_size": 18,
"total": 230,
"hits": [
{
"id": "2cnP0MAxurmP",
"name": "Shots of sights in Paris, France",
"created_at": "2024-07-24T12:53:22.406Z",
"updated_at": "2024-07-24T12:53:22.406Z",
"created_by": null,
"title": "Free Shots Of Sights In Paris, France Stock Videos",
"description": "Explore and download beautiful Shots of sights in Paris, France stock video scene and footage for your website or any project. Download high-quality royalty-free Shots of sights in Paris, France videos in HD and 4K for free.",
"slug": "shots-of-sights-in-paris-france",
"videos_count": 111,
"status": "published",
"published_at": null,
"meta": {
"title": "Download Free Shots Of Sights In Paris, France Stock Video Scene: HD & 4K Videos",
"description": "Download free Shots of sights in Paris, France stock videos and footage collected into one scene. ✓ High-quality premium HD and 4K clips ✓ Completely free for personal and commercial projects."
},
"hero_video_id": null,
"hero_video": null,
"preview_videos": [
{
"id": "QDcQ32uW9R",
"created_at": "2020-05-03T10:03:14.647Z",
"updated_at": "2022-09-21T12:41:00.087Z",
"title": "Sacre Coeur park",
"base_filename": "coverr-sacre-coeur-park-3424",
"poster": "https://cdn.coverr.co/videos/coverr-sacre-coeur-park-3424/thumbnail?width=1920",
"thumbnail": "https://cdn.coverr.co/videos/coverr-sacre-coeur-park-3424/thumbnail?width=640",
"description": "A high-angle shot of Sacre Coeur park.",
"is_vertical": false,
"search_keywords": [
"sacre coeur",
"paris",
"france",
"park",
"up view"
],
"downloads": 852,
"views": 1025,
"published_at": "2020-05-05T11:44:45.728Z",
"aspect_ratio": "256:135",
"duration": 38.92,
"max_height": 2160,
"max_width": 4096,
"urls": {
"mp4": "",
"mp4_preview": "",
"mp4_download": ""
}
}
]
}
]
}
# Get a video scene
Get a single video scene by slug or id. The response includes up to 8 preview videos sorted by popularity.
GET /video-scenes/:slugOrId
# Parameters
| Param | Description |
|---|---|
slugOrId | Video scene's slug or id |
filter | Exclude a specific video id from preview videos. String. |
# Response
{
"id": "2cnP0MAxurmP",
"name": "Shots of sights in Paris, France",
"created_at": "2024-07-24T12:53:22.406Z",
"updated_at": "2024-07-24T12:53:22.406Z",
"created_by": null,
"title": "Free Shots Of Sights In Paris, France Stock Videos",
"description": "Explore and download beautiful Shots of sights in Paris, France stock video scene and footage for your website or any project. Download high-quality royalty-free Shots of sights in Paris, France videos in HD and 4K for free.",
"slug": "shots-of-sights-in-paris-france",
"videos_count": 111,
"status": "published",
"published_at": null,
"meta": {
"title": "Download Free Shots Of Sights In Paris, France Stock Video Scene: HD & 4K Videos",
"description": "Download free Shots of sights in Paris, France stock videos and footage collected into one scene. ✓ High-quality premium HD and 4K clips ✓ Completely free for personal and commercial projects."
},
"hero_video_id": null,
"hero_video": null,
"preview_videos": [
{
"id": "QDcQ32uW9R",
"created_at": "2020-05-03T10:03:14.647Z",
"updated_at": "2022-09-21T12:41:00.087Z",
"title": "Sacre Coeur park",
"base_filename": "coverr-sacre-coeur-park-3424",
"poster": "https://cdn.coverr.co/videos/coverr-sacre-coeur-park-3424/thumbnail?width=1920",
"thumbnail": "https://cdn.coverr.co/videos/coverr-sacre-coeur-park-3424/thumbnail?width=640",
"description": "A high-angle shot of Sacre Coeur park.",
"is_vertical": false,
"search_keywords": [
"sacre coeur",
"paris",
"france",
"park",
"up view"
],
"downloads": 852,
"views": 1025,
"published_at": "2020-05-05T11:44:45.728Z",
"aspect_ratio": "256:135",
"duration": 38.92,
"max_height": 2160,
"max_width": 4096,
"urls": {
"mp4": "",
"mp4_preview": "",
"mp4_download": ""
}
}
]
}
# Get videos in a video scene
In order to list all videos in a specific video scene, query this endpoint:
GET /video-scenes/:slugOrId/videos
# Parameters
| Param | Description |
|---|---|
page | Page number. Number. Default: 0 |
page_size | Number of videos per page. Number. Default: 18 |
# Response
{
"page": 0,
"pages": 50,
"page_size": 20,
"total": 3602,
"hits": [
{
"id": "S1YbPl1NfI",
"created_at": "2020-11-12T08:55:42.710Z",
"updated_at": "2020-11-12T08:55:42.710Z",
"title": "Cutting Wood Building Material With a Circular Electric Saw",
"poster": "https://storage.coverr.co/p/QatsCWWAorI71sZ33DkHZREGWruZCHsg",
"thumbnail": "https://storage.coverr.co/t/QatsCWWAorI71sZ33DkHZREGWruZCHsg",
"description": "A close-up of the circular miter saw lowers and cuts off material",
"is_vertical": false,
"tags": [
"circular saw",
"miter saw",
"saw"
],
"downloads": 4,
"views": 1,
"published_at": "2020-11-15T09:27:18.578Z",
"aspect_ratio": "16:9",
"duration": 11.625,
"max_height": 1152,
"max_width": 2048,
"urls": {
"mp4": "https://storage.coverr.co/videos/QatsCWWAorI71sZ33DkHZREGWruZCHsg?token={token}",
"mp4_preview": "https://storage.coverr.co/videos/QatsCWWAorI71sZ33DkHZREGWruZCHsg/preview?token={token}",
"mp4_download": "https://storage.coverr.co/videos/QatsCWWAorI71sZ33DkHZREGWruZCHsg/download?token={token}&filename=Cutting Wood Building Material With a Circular Electric Saw"
}
}
]
}
← Audios MCP Server →