Skip to main content

Welcome to VidNavigator API

The VidNavigator Developer API provides programmatic access to advanced video intelligence capabilities — transcription, analysis, structured data extraction, and semantic search — across all major video platforms including YouTube, TikTok, Instagram, X/Twitter, Facebook, Vimeo, Loom, Dailymotion, and your own uploaded files.

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_requiredCredit limit exceeded or no active subscription
403access_deniedInsufficient permissions
404not_foundResource not found
429rate_limit_exceededRate limit exceeded
500internal_server_errorServer error

API Categories

Transcripts

Extract transcripts from YouTube, TikTok, Instagram, X/Twitter, Facebook, Vimeo, Loom, and more

File Management

Upload, manage, and organize audio/video files with namespaces

AI Analysis

Analyze video content with AI for insights and summaries

Data Extraction

Extract structured data from transcripts using custom schemas

Semantic Search

Search across videos using natural language queries