Get Audio

Learn how to retrieve brand audio from your workspace

Overview#

This endpoint allows you to retrieve a list of brand audio tracks from your workspace. Brand audio can be reused across your video templates without uploading the same file every time.

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

Query Parameters#

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

Request#

await fetch("https://api.orshot.com/v1/brand-assets/audio/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 audio file
`created_at`	String	Timestamp when the audio was uploaded
`name`	String	Stored audio name
`original_filename`	String	Display name of the uploaded audio
`file_size`	Number	Size of the audio file in bytes
`direct_url`	String	URL to access the audio
`duration`	Number	Audio duration in seconds
`format`	String	Audio format (e.g., `mp3`, `wav`)
`mime_type`	String	MIME type of the audio
`waveform_url`	String	URL to a waveform image (may be `null`)
`metadata`	Object	Custom metadata associated with the audio
`tags`	String[]	Tags associated with the audio
`workspace_id`	Number	ID of the workspace the audio belongs to
`user_id`	String	ID of the user who uploaded the audio

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
30 free credits — no credit card required