Get Videos

Learn how to retrieve brand videos from your workspace

Overview#

This endpoint allows you to retrieve a list of brand videos from your workspace. Brand videos can be used across your templates and designs.

https://api.orshot.com/v1/brand-assets/videos/get

Query Parameters#

Parameter	Type	Required	Description
`tag`	String	No	Comma-separated list of tags to filter by. Returns only videos that have all specified tags.

Request#

await fetch("https://api.orshot.com/v1/brand-assets/videos/get", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

Rate Limits#

30 requests per minute per endpoint

Response Fields#

Field	Type	Description
`id`	Number	Unique identifier for the video
`created_at`	String	Timestamp when the video was uploaded
`name`	String	Video name
`original_filename`	String	Original filename of the uploaded video
`file_size`	Number	Size of the video file in bytes
`direct_url`	String	URL to access the video
`width`	Number	Video width in pixels
`height`	Number	Video height in pixels
`duration`	Number	Video duration in seconds
`format`	String	Video format (e.g., `mp4`, `webm`)
`mime_type`	String	MIME type of the video
`metadata`	Object	Custom metadata associated with the video
`tags`	String[]	Tags associated with the video
`workspace_id`	Number	ID of the workspace the video belongs to
`user_id`	String	ID of the user who uploaded the video

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key

Image, PDF and video generation via API
Visual editor with AI and smart layouts
Zapier, Make, MCP and 50+ integrations
White-label embed for your own app
60 free renders — no credit card required