Skip to main content

​
Overview

Your VidNavigator plan includes a monthly credit pool shared across all API operations. Different services consume credits at different rates. You can monitor your current balance at any time by calling the /usage endpoint.
There are no per-service limits — all operations draw from the same credit pool. The activity counters shown in /usage are informational only.

​
Credit Costs per Service

ServiceCredit CostUnit
Video Transcripts (/transcript)1 credit per 10,000 requestsper request
YouTube Transcripts (/transcript/youtube)1 credit per 200 requestsper request
Video Searches (/search/video, /search/file)1 credit per 10 searchesper search
Video Analyses (/analyze/video, /analyze/file)1 credit per 100 analysesper analysis
Video Uploads (/upload/file, /transcribe)1 credit per hour of audio/videoper hour
Scene Analyses1 credit per scene analysisper analysis

​
Deduction Order

Credits are deducted in this order:
  1. Monthly credits are consumed first
  2. Purchased credits cover any overflow
Monthly credits reset each billing period. Purchased credits persist across periods.

​
Plan Credit Allowances

PlanMonthly CreditsStorageIndexed Channels
Trial55 GB2
Navigator ($9.99/mo)1550 GB3
Voyager ($49.99/mo)80500 GB15
Odyssey (Custom)UnlimitedUnlimitedUnlimited
Voyager and above can purchase additional credit packs: 50 credits (20),300credits(20), 300 credits (100), or 1,200 credits ($300).

​
Service Details

Video Transcripts

Each call to /transcript (for TikTok, X/Twitter, Facebook, etc.) costs ~0.0001 credits.

YouTube Transcripts

Each call to /transcript/youtube costs ~0.005 credits. Higher cost due to residential proxy infrastructure required for YouTube.
Using metadata_only: true bypasses the residential proxy and counts as a regular video transcript instead.

Speech-to-Text Processing

/transcribe and /upload/file cost 1 credit per hour of audio/video processed.
Files uploaded via /upload/file also count towards your storage quota.

Video Analyses

Each call to /analyze/video or /analyze/file costs ~0.01 credits.

Video Searches

Each call to /search/video or /search/file costs ~0.1 credits.

Data Extraction

Each call to /extract/video or /extract/file uses AI to extract structured data from transcripts. Credit costs depend on the extraction complexity.

​
Hard Limits (Not Credit-Gated)

Some resources have fixed plan limits that are not deducted from your credit pool:
ResourceHow It’s Enforced
StorageTotal file storage in bytes checked against your plan’s storage cap
Indexed ChannelsNon-public YouTube channels counted live from your channel list against your plan’s cap

​
YouTube vs Other Platforms

Why do YouTube transcripts cost more?YouTube requires residential proxy infrastructure for reliable access, which incurs higher costs. This is reflected in the credit rate (1 credit per 200 requests vs. 1 per 10,000 for other platforms).

​
Free Endpoints

The following endpoints do not consume credits:
  • GET /files — List your uploaded files
  • GET /file/{file_id} — Get file info and transcript
  • GET /file/{file_id}/url — Get temporary file URL
  • GET /namespaces — List namespaces
  • POST /namespaces — Create a namespace
  • PUT /namespaces/{namespace_id} — Rename a namespace
  • DELETE /namespaces/{namespace_id} — Delete a namespace
  • PUT /file/{file_id}/namespaces — Update file namespace assignments
  • GET /health — Health check
  • GET /usage — Usage statistics