Skip to main content

​
Overview

Your VidNavigator plan comes with a monthly quota for different types of API requests. This page breaks down how each endpoint contributes to your usage. You can monitor your current usage at any time by calling the /usage endpoint.

​
Usage Breakdown

Video Transcripts

Each call to the following endpoint counts as one transcript request:
  • POST /transcript (for TikTok, X/Twitter, Facebook, etc.)

YouTube Transcripts

YouTube transcripts are tracked separately due to higher infrastructure costs (residential proxy):
  • POST /transcript/youtube
Using metadata_only: true bypasses the residential proxy and counts as a regular transcript request instead.

Speech-to-Text Processing

Usage for the following endpoints is measured by the duration (in hours) of the video or audio processed. This reflects the computational cost of generating new transcripts.
  • POST /transcribe
  • POST /upload/file
    Files uploaded via /upload/file also count towards your storage quota.

Video Analyses

Each call to the following endpoints counts as one analysis request:
  • POST /analyze/video
  • POST /analyze/file

Video Searches

Each call to the following endpoints counts as one search request:
  • POST /search/video
  • POST /search/file

​
YouTube vs Other Platforms

Why are YouTube transcripts tracked separately?YouTube has implemented strict bot detection that requires residential proxy infrastructure to bypass. This incurs additional costs, which is why YouTube transcript requests are tracked in a separate quota from other platforms.

​
Storage

Your plan also includes a storage limit for your uploaded files. The total size of all files you have uploaded counts towards this limit. You can check your current storage usage with the /usage endpoint.
Other endpoints, such as GET /files, GET /file/{file_id}, and the system endpoints (/health, /usage), do not contribute to your monthly request quotas.