​
Welcome to VidNavigator API

The VidNavigator Developer API provides programmatic access to advanced video intelligence capabilities including transcription, analysis, and semantic search across YouTube videos and uploaded content.

OpenAPI Specification

View the complete OpenAPI 3.0 specification

Get Started

Quick start guide for making your first API call

​
Authentication

All API endpoints require authentication using an API key passed in the X-API-Key header: 
X-API-Key: YOUR_API_KEY
Get your API key from the VidNavigator Developer Dashboard.

​
Base URL

The API is available at: 
https://api.vidnavigator.com/v1

​
Error Handling

The API uses standard HTTP status codes and returns structured error responses: 
{
  "status": "error",
  "error": "error_type",
  "message": "Human readable error message"
}

​
Common Error Codes

Status CodeError TypeDescription
400bad_requestInvalid request parameters
401unauthorizedMissing or invalid API key
402payment_requiredPayment required or exceeded quota
403access_deniedInsufficient permissions
404not_foundResource not found
429rate_limit_exceededRate limit exceeded
500internal_server_errorServer error

​
API Categories

Transcripts

Extract transcripts from YouTube and other online videos

File Management

Upload, process, and manage audio/video files

AI Analysis

Analyze video content with AI for insights and summaries

Semantic Search

Search across videos using natural language queries