Video Templates
The Video Templates API allows you to find specific video templates and retrieve lists of video templates from your account.
Find Video Template
Retrieves details for a specific video template by ID or name.
Arguments
| Parameter | Type | Description |
|---|---|---|
| criteria | VideoTemplateLookupInput | Required Criteria for finding a video template |
VideoTemplateLookupInput
| Field | Type | Description |
|---|---|---|
| id | ID | Optional ID of the video template to find |
| name | String | Optional Name of the video template to find |
Example Query
query {
viewer {
videoTemplate(criteria: {
name: "Product Introduction Template"
}) {
id
name
description
templateType
aspectRatio
duration
categories {
id
name
}
tags {
id
name
}
previewImage
previewVideo
}
}
}
Response
{
"data": {
"viewer": {
"videoTemplate": {
"id": "VmlkZW9UZW1wbGF0ZToxMg==",
"name": "Product Introduction Template",
"description": "A professional template for introducing new products",
"templateType": "marketing",
"aspectRatio": "16:9",
"duration": 60,
"categories": [
{
"id": "Q2F0ZWdvcnk6NQ==",
"name": "Product Marketing"
}
],
"tags": [
{
"id": "VGFnOjE0",
"name": "Product Launch"
},
{
"id": "VGFnOjIy",
"name": "Professional"
}
],
"previewImage": "https://cdn.sixtyseconds.video/templates/preview-12.jpg",
"previewVideo": "https://cdn.sixtyseconds.video/templates/preview-12.mp4"
}
}
}
}
List Video Templates
Retrieves a paginated and filterable list of video templates. Requires admin access.
Arguments
| Parameter | Type | Description |
|---|---|---|
| filter | VideoTemplateListFilterInput | Required Filter and pagination options |
VideoTemplateListFilterInput
| Field | Type | Description |
|---|---|---|
| search | String | Optional Search term to filter video templates by name |
| templateType | String | Optional Filter video templates by template type |
| page | Int | Optional Page number for pagination (default: 1) |
| limit | Int | Optional Maximum number of video templates to return per page (default: 10) |
Example Query
query {
viewer {
videoTemplates(filter: {
search: "product",
templateType: "marketing",
page: 1,
limit: 10
}) {
items {
id
name
description
templateType
aspectRatio
duration
categories {
name
}
}
total
page
limit
pages
}
}
}
Response
{
"data": {
"viewer": {
"videoTemplates": {
"items": [
{
"id": "VmlkZW9UZW1wbGF0ZToxMg==",
"name": "Product Introduction Template",
"description": "A professional template for introducing new products",
"templateType": "marketing",
"aspectRatio": "16:9",
"duration": 60,
"categories": [
{
"name": "Product Marketing"
}
]
},
{
"id": "VmlkZW9UZW1wbGF0ZToxNQ==",
"name": "Product Feature Showcase",
"description": "Highlight key features of your product",
"templateType": "marketing",
"aspectRatio": "16:9",
"duration": 45,
"categories": [
{
"name": "Product Marketing"
}
]
}
],
"total": 2,
"page": 1,
"limit": 10,
"pages": 1
}
}
}
}
Video Template Fields
The VideoTemplate object contains the following fields:
| Field | Type | Description |
|---|---|---|
| id | ID | Unique identifier for the video template |
| name | String | Name of the video template |
| description | String | Description of the video template |
| templateType | String | Type of the template (stock, brand, etc.) |
| aspectRatio | String | Aspect ratio of videos created with this template |
| duration | Float | Duration of the template in seconds |
| categories | [Category] | Categories the template belongs to |
| tags | [Tag] | Tags associated with the template |
| fields | [VideoTemplateField] | Customizable fields in the template |
| brand | Brand | The brand that owns this template (for brand templates) |
| previewImage | String | URL to a preview image of the template |
| previewVideo | String | URL to a preview video of the template |
Template Types
Video templates can have different types:
| Type | Description |
|---|---|
| stock | Pre-built templates available to all users |
| brand | Custom templates created for a specific brand |
| scene | Templates used as scenes within other templates |
| endcard | Templates used as end cards for videos |
Working with Video Templates
Access Control
Access to video template data is controlled by user permissions:
- Stock templates are accessible to all users
- Brand templates are accessible to users of that brand, organization admins, and global admins
- Global administrators can access any template in the system
Template Preview
The platform provides both static image and video previews for templates to help users select the right template for their needs.
Template Customization
Templates contain customizable fields that can be modified when creating a video:
- Text fields for titles, subtitles, and body text
- Media fields for images and video clips
- Color fields for customizing the visual appearance
- Font fields for text styling
Template Categories
Templates are organized into categories for easier discovery. Use the templateType parameter in the videoTemplates query to filter templates by their category.