Skip to main content

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

QUERYvideoTemplate

Retrieves details for a specific video template by ID or name.

Arguments

ParameterTypeDescription
criteriaVideoTemplateLookupInputRequired Criteria for finding a video template

VideoTemplateLookupInput

FieldTypeDescription
idIDOptional ID of the video template to find
nameStringOptional 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

QUERYvideoTemplates

Retrieves a paginated and filterable list of video templates. Requires admin access.

Arguments

ParameterTypeDescription
filterVideoTemplateListFilterInputRequired Filter and pagination options

VideoTemplateListFilterInput

FieldTypeDescription
searchStringOptional Search term to filter video templates by name
templateTypeStringOptional Filter video templates by template type
pageIntOptional Page number for pagination (default: 1)
limitIntOptional 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:

FieldTypeDescription
idIDUnique identifier for the video template
nameStringName of the video template
descriptionStringDescription of the video template
templateTypeStringType of the template (stock, brand, etc.)
aspectRatioStringAspect ratio of videos created with this template
durationFloatDuration 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
brandBrandThe brand that owns this template (for brand templates)
previewImageStringURL to a preview image of the template
previewVideoStringURL to a preview video of the template

Template Types

Video templates can have different types:

TypeDescription
stockPre-built templates available to all users
brandCustom templates created for a specific brand
sceneTemplates used as scenes within other templates
endcardTemplates 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.