Get Audio
Learn how to retrieve brand audio from your workspace
Published
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/getQuery Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
tag | String | No | Comma-separated list of tags to filter by. Returns only audio that has all specified tags. |
embedId | String | No | Embed instance ID. Pair with embedUserId to scope this call to one embed user |
embedUserId | String | No | The same userId your app passes to the embed URL. Requires embedId |
Request#
await fetch("https://api.orshot.com/v1/brand-assets/audio/get", {
method: "GET",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer <ORSHOT_API_KEY>",
},
});Per-User Libraries#
Pass embedId and embedUserId together to return only that embed user's audio instead of the whole workspace library. This is how one embed serves many brands or tenants, each with its own brand space.
Omit them and this endpoint behaves exactly as documented above. See Per-User Brand Assets for the full picture.
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