Skip to main content
GET
/
audio
List audios
curl --request GET \
  --url https://api.videodb.io/audio/ \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": {
    "audios": [
      {
        "id": "a-12345",
        "name": "audio.mp3",
        "collection_id": "default",
        "length": 60,
        "size": 524288,
        "created_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
}
Retrieve all audio files in a collection for browsing and management. 
import videodb

conn = videodb.connect(api_key="your_api_key")
coll = conn.get_collection()

# List all audio files
audios = coll.get_audios()
for audio in audios:
    print(f"{audio.id}: {audio.name} ({audio.length}s)")
  • Audio IDs have an a- prefix (e.g., a-abc123def)
  • Each audio file includes duration in seconds via the length property
  • Use this to build audio galleries or management interfaces

Collection Management

Learn about organizing media in collections

Get Audio Details

Retrieve details for a specific audio file

Authorizations

​
x-access-token
string
header
required

API key for authentication (sk-xxx format)

Query Parameters

​
collection_id
string
Example:

"default"

Response

200 - application/json

List of audios

​
success
boolean
Example:

true

​
data
object