VidNavigator icon

VidNavigator

VidNavigator integration

Overview

The VidNavigator node integrates with the VidNavigator API to perform various video-related operations. It supports multiple functionalities such as searching videos, analyzing video content, retrieving transcripts, answering follow-up questions about videos, transcribing non-YouTube videos, running custom HTTP requests, and executing specific tools available in the VidNavigator MCP (Modular Command Platform).

This node is beneficial for users who want to automate video data processing workflows, including extracting insights from videos, searching large video databases, or interacting with custom tools provided by VidNavigator.

Practical examples:

  • Searching for videos related to a specific topic within a date range.
  • Analyzing a YouTube video to get a summary or answer a question about its content.
  • Fetching the transcript of a video for captioning or text analysis.
  • Running a custom HTTP request to any endpoint under the VidNavigator base URL.
  • Transcribing audio from non-YouTube video URLs.
  • Executing specialized tools dynamically loaded from the VidNavigator MCP.

Properties

Name Meaning
Method HTTP method for the custom request; options are GET or POST.
Path Relative path under the VidNavigator base URL for the custom request, e.g., /search_videos.
Query Parameters Key-value pairs to be sent as query parameters in the custom request.
Body JSON body content for POST requests in the custom request operation.

These properties apply specifically when the Custom Request operation is selected.

Output

The node outputs an array of items where each item contains a json field holding the response data from the VidNavigator API call. The structure of this JSON depends on the operation performed:

  • For Custom Request, it returns the raw JSON response from the specified endpoint.
  • For other operations like search, analyze, transcript retrieval, etc., it returns the corresponding structured JSON result from the API.
  • If an unsupported operation is requested, the output JSON will contain an error message.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the VidNavigator API.
  • The base URL for the VidNavigator API must be configured in the credentials.
  • Uses n8n's built-in HTTP request helper with authentication support.

Troubleshooting

  • Invalid Credentials or Base URL: Ensure that the API key and base URL are correctly set in the credentials. Incorrect values will cause authentication failures or connection errors.
  • Malformed JSON Body: When using the Custom Request operation with a POST method, ensure the JSON body is valid. Invalid JSON will cause parsing errors.
  • Unsupported Operation: If an operation outside the supported list is selected, the node returns an error JSON indicating "Unsupported operation".
  • Empty or Missing Required Parameters: Some operations require mandatory fields (e.g., video URLs). Omitting these will likely cause API errors.
  • Network Issues: Connectivity problems to the VidNavigator API endpoint will result in request failures.

To resolve errors, verify all input parameters, credentials, and network connectivity.

Links and References

Discussion