VideoDB icon

VideoDB

Interact with the VideoDB API

Overview

This node integrates with the VideoDB API to retrieve audio files associated with a specified collection. It is designed to fetch metadata and details about audio assets stored in a VideoDB collection, which can be useful for media management, content automation, or cataloging workflows.

A common use case is when you have collections of multimedia content (videos, audios, images) organized in VideoDB, and you want to programmatically access all audio files within a particular collection for further processing, such as transcription, analysis, or distribution.

For example, you might use this node to:

  • Retrieve all audio tracks from a podcast series collection.
  • Extract audio metadata for a music library collection.
  • Automate the download or processing of audio files linked to a video project.

Properties

Name Meaning
Collection Name or ID Select or specify the ID of the collection from which to get audio files. This can be chosen from a dropdown list loaded dynamically from your VideoDB account collections.

Output

The node outputs an array of JSON objects, each representing the response from the VideoDB API for the requested audio files in the specified collection. The structure corresponds directly to the API's response under the data.audios field, typically including properties like audio IDs, names, and other metadata.

Example output JSON snippet:

{
  "data": {
    "audios": [
      {
        "id": "audio123",
        "name": "Sample Audio Track",
        // additional audio metadata fields...
      },
      {
        "id": "audio456",
        "name": "Another Audio Track"
      }
    ]
  }
}

No binary data output is indicated by the code; the node returns only JSON metadata about the audios.

Dependencies

  • Requires an API key credential for authenticating with the VideoDB API.
  • The base URL defaults to https://api.videodb.io but can be customized via credentials.
  • The node uses HTTP requests authenticated with the provided API key to interact with the VideoDB service.

Troubleshooting

  • Missing or invalid API key: Ensure that the API key credential is correctly configured and has sufficient permissions to access collections and audio data.
  • Empty collection or no audios found: Verify that the selected collection ID is correct and contains audio files.
  • Network or API errors: Check network connectivity and confirm the VideoDB API service status.
  • Invalid collection ID input: Use the dropdown to select a valid collection or ensure the expression used to specify the ID resolves correctly.

Common error messages will likely relate to authentication failures (e.g., unauthorized), resource not found (invalid collection ID), or malformed requests. Resolving these involves verifying credentials, collection existence, and parameter correctness.

Links and References

Discussion