# VidNavigator API

> VidNavigator is an AI-powered video intelligence platform. Transcribe, analyze, extract data, and search across videos from YouTube, TikTok, Instagram, X/Twitter, Facebook, Vimeo, Loom, Dailymotion, and your own uploaded files — all through a single API.

## Docs

- [Analyze Uploaded File](https://docs.vidnavigator.com/api-reference/endpoint/analyze-file.md): Analyze an uploaded file and return comprehensive analysis results with intelligent caching.
- [Analyze Video](https://docs.vidnavigator.com/api-reference/endpoint/analyze-video.md): Analyze an online video and return comprehensive analysis results with intelligent caching.
- [Cancel File Processing](https://docs.vidnavigator.com/api-reference/endpoint/cancel-file.md): Cancel an ongoing file upload/processing
- [Create Namespace](https://docs.vidnavigator.com/api-reference/endpoint/create-namespace.md): Create a new namespace for organizing files. Maximum 5 namespaces per user. The name 'default' is reserved and cannot be used.
- [Delete File](https://docs.vidnavigator.com/api-reference/endpoint/delete-file.md): Delete a file and its associated data from the database and cloud storage
- [Delete Namespace](https://docs.vidnavigator.com/api-reference/endpoint/delete-namespace.md): Delete a namespace and remove its association from all files. The 'default' namespace cannot be deleted.
- [Extract Data from File](https://docs.vidnavigator.com/api-reference/endpoint/extract-file.md): Extract structured data from an uploaded file's transcript using a custom schema.
- [Extract Data from Video](https://docs.vidnavigator.com/api-reference/endpoint/extract-video.md): Extract structured data from an online video's transcript using a custom schema.
- [Get File Info](https://docs.vidnavigator.com/api-reference/endpoint/file-info.md): Retrieve detailed information about a specific file including its transcript if available
- [Get Temporary File URL](https://docs.vidnavigator.com/api-reference/endpoint/file-url.md): Returns a short-lived (~1 hour) signed Google Cloud Storage URL pointing directly at the file bytes. Same model as AWS S3 / CloudFront pre-signed URLs: the URL itself is the capability, time-limited and resource-scoped, so it can be used from browsers, no-code tools, or any HTTP client without forwa…
- [API Health Check](https://docs.vidnavigator.com/api-reference/endpoint/health.md): Check API health and get endpoint information
- [List Files](https://docs.vidnavigator.com/api-reference/endpoint/list-files.md): Retrieve a paginated list of all files uploaded by the authenticated user. Supports filtering by status and namespace.
- [List Namespaces](https://docs.vidnavigator.com/api-reference/endpoint/list-namespaces.md): Get all namespaces for the authenticated user. A 'default' namespace is auto-created if none exist. Files without a namespace are lazily migrated to the default.
- [Rename Namespace](https://docs.vidnavigator.com/api-reference/endpoint/rename-namespace.md): Rename an existing namespace. The 'default' namespace cannot be renamed.
- [Retry File Processing](https://docs.vidnavigator.com/api-reference/endpoint/retry-file.md): Retry processing for a file that previously failed or was cancelled
- [Search Files](https://docs.vidnavigator.com/api-reference/endpoint/search-file.md): Search through user's uploaded files using vector similarity with AI reranking.
- [Search Videos](https://docs.vidnavigator.com/api-reference/endpoint/search-video.md): Search for videos using AI analysis and ranking with optional filters.
- [Submit TikTok Profile Scrape](https://docs.vidnavigator.com/api-reference/endpoint/tiktok-profile.md): Start an asynchronous TikTok profile scrape and return a `task_id` immediately.
- [Get TikTok Profile Scrape Result](https://docs.vidnavigator.com/api-reference/endpoint/tiktok-profile-result.md): Poll an async TikTok profile scrape task and retrieve a cursor-paginated page of videos.
- [Transcribe Online Video](https://docs.vidnavigator.com/api-reference/endpoint/transcribe.md): Transcribe online videos (e.g., Instagram, TikTok) using speech-to-text models when a transcript is not available.
- [Get Video Transcript](https://docs.vidnavigator.com/api-reference/endpoint/transcript.md): Extract transcript from non-YouTube online videos (Vimeo, Twitter/X, TikTok, Facebook, Instagram, Dailymotion, Loom, etc.) with optional language selection.
- [Get YouTube Transcript](https://docs.vidnavigator.com/api-reference/endpoint/transcript-youtube.md): Extract transcript from YouTube videos.
- [Tweet Claim Analysis](https://docs.vidnavigator.com/api-reference/endpoint/tweet-claim-analysis.md): Fetches the tweet content (including any quoted tweet and attached media/videos), then uses AI to extract a rich structured analysis: the core claim, a concise search query, classification axes, topics, entities, and raw tweet data.
- [Update File Namespaces](https://docs.vidnavigator.com/api-reference/endpoint/update-file-namespaces.md): Set the namespaces a file belongs to. Replaces any existing namespace assignments. The 'default' namespace is always preserved.
- [Upload File](https://docs.vidnavigator.com/api-reference/endpoint/upload-file.md): Upload a new audio or video file for analysis and start processing.
- [Get Usage](https://docs.vidnavigator.com/api-reference/endpoint/usage.md): Retrieve credit balances, per-service activity counts, storage, and channels indexed for the authenticated user. All API operations consume credits from a shared pool — there are no per-service limits.
- [API Reference](https://docs.vidnavigator.com/api-reference/introduction.md): Complete reference for the VidNavigator Developer API
- [Rate Limiting](https://docs.vidnavigator.com/api-reference/rate-limiting.md): Per-endpoint request limits and throttling behaviour
- [Usage Costs](https://docs.vidnavigator.com/api-reference/usage-costs.md): Understand how API operations consume credits from your shared credit pool.
- [Chrome Extension](https://docs.vidnavigator.com/chrome-extension.md): Find exact moments in YouTube videos with the VidNavigator Chrome Extension
- [Contact Us](https://docs.vidnavigator.com/contact.md): Reach out to the VidNavigator team for support, feature requests, or general questions.
- [Analyzing Videos](https://docs.vidnavigator.com/guides/analyzing-videos.md): Learn how to analyze videos to extract summaries, topics, and other insights.
- [Extracting Structured Data](https://docs.vidnavigator.com/guides/data-extraction.md): Turn any online video or uploaded file into clean, validated JSON using a schema you define.
- [Getting Transcripts](https://docs.vidnavigator.com/guides/getting-transcripts.md): Learn how to retrieve transcripts from online videos using the VidNavigator API and SDKs.
- [Searching Through Videos](https://docs.vidnavigator.com/guides/searching-videos.md): Learn how to use natural language to search for specific moments within a single video or across a library of videos.
- [Tweet Claim Analysis](https://docs.vidnavigator.com/guides/tweet-claim-analysis.md): Understand what an X post actually means by combining the original tweet, quoted tweet, and attached media.
- [Uploading and Processing Files](https://docs.vidnavigator.com/guides/uploading-videos.md): Learn how to upload your own video and audio files for transcription and analysis.
- [VidNavigator AI](https://docs.vidnavigator.com/index.md): VidNavigator is an AI-powered video intelligence platform. Transcribe, analyze, extract data, and search across videos from YouTube, TikTok, Instagram, X/Twitter, Facebook, Vimeo, Loom, Dailymotion, and your own uploaded files — all through a single API.
- [MCP Server](https://docs.vidnavigator.com/mcp-server.md): Use natural language to interact with VidNavigator through Cursor and Claude Desktop
- [Quickstart](https://docs.vidnavigator.com/quickstart.md): Get up and running with the VidNavigator API in less than 5 minutes.
- [JavaScript SDK](https://docs.vidnavigator.com/sdks/javascript.md): Install and use the official VidNavigator JavaScript SDK to interact with the API.
- [Python SDK](https://docs.vidnavigator.com/sdks/python.md): Install and use the official VidNavigator Python SDK to interact with the API.

## OpenAPI Specs

- [openapi](https://docs.vidnavigator.com/api-reference/openapi.json)

## Optional

- [App](https://vidnavigator.com)
- [Blog](https://vidnavigator.com/blog)