Template library

GET https://api.json2video.com/v2/templates/library

Lists the public template library — the curated gallery of ready-to-use templates published by JSON2Video. Each entry includes an example video, a thumbnail and the template's dimensions. Copy any of them into your own account with POST /v2/templates using action=duplicate and the template id returned here.

Request

Headers

Header	Required	Value
`x-api-key`	yes	API key issued from the dashboard. Requires role `render`, `editor`, `manager`, or `admin`.

Query parameters

Parameter	Type	Description
`tags`	string	Optional. Comma-separated list of tags. In addition to every `published` template, the response includes any template tagged with one of these values.

Body

None.

Response

200 OK

{
    "success": true,
    "count": 24,
    "templates": [
        {
            "id": "abc123def456ghi789jk",
            "name": "Product showcase",
            "tags": ["showcase", "published"],
            "width": 1920,
            "height": 1080,
            "aspect_ratio": 1.78,
            "prompt": true,
            "created_at": "2026-04-01T12:00:00.000Z",
            "updated_at": "2026-04-15T09:30:00.000Z",
            "video_url": "https://json2video-cdn2.s3.amazonaws.com/templates/abc123def456ghi789jk/example.mp4",
            "thumbnail_url": "https://json2video-cdn2.s3.amazonaws.com/templates/abc123def456ghi789jk/thumbnail.jpg"
        }
    ],
    "timestamp": "2026-07-08T10:49:52.924Z"
}

The list is sorted by updated_at descending. Each template's fields:

Field	Type	Description
`id`	string	Template ID. Use it to render the template, or to duplicate it into your account.
`name`	string	Human-readable template name.
`tags`	string[]	Tags assigned to the template.
`width`	integer	Frame width in pixels.
`height`	integer	Frame height in pixels.
`aspect_ratio`	number	`width / height`, rounded to 2 decimals.
`prompt`	boolean	Whether the template ships with an AI prompt.
`created_at`	string	ISO 8601 creation timestamp.
`updated_at`	string	ISO 8601 last-update timestamp.
`video_url`	string	URL of an example render (MP4).
`thumbnail_url`	string	URL of a preview thumbnail (JPG).

The library never returns the template's movie payload. To fetch the full body, duplicate the template into your account and then read it with GET /v2/templates.

Errors

Status	Message	Cause
`400`	`Tags query parameter must be a string with tags separated by commas`	The `tags` parameter could not be parsed.
`403`	`Insufficient permissions`	API key role is below `render`.
`404`	`Error retrieving templates`	Server error. Retry with exponential backoff.

Examples

List the whole library

curl --location \
  --request GET 'https://api.json2video.com/v2/templates/library' \
  --header 'x-api-key: YOUR_API_KEY'

Filter by tags

curl --location \
  --request GET 'https://api.json2video.com/v2/templates/library?tags=intro,social' \
  --header 'x-api-key: YOUR_API_KEY'

Template library#

Request#

Headers#

Query parameters#

Body#

Response#

200 OK#

Errors#

Examples#

List the whole library#

Filter by tags#