Rate Limiting
Per-endpoint request limits and throttling behaviour
VidNavigator applies per-endpoint rate limits to ensure fair usage and platform stability.
Current Limits
| Endpoint | Requests / minute |
|---|---|
GET /health | 300 |
GET /usage | 300 |
POST /transcript | 200 |
GET /files | 200 |
GET /file/{file_id} | 200 |
POST /analyze/video | 30 |
POST /analyze/file | 30 |
POST /transcribe | 20 |
POST /youtube/search | 10 |
POST /search/file | 10 |
POST /upload/file | 3 |
Temporary Ban
Exceeding a limit results in a 429 Too Many Requests response and a temporary ban of 1 minute on the offending API key.
Async Jobs
The async submit endpoints (POST /transcribe/async, POST /watch/async, POST /extract/video/async, POST /tweet/statement/async) also limit how many jobs can run at the same time for one account. Above that limit, the submit returns 429 with error: "too_many_active_jobs" — wait for running jobs to finish, then retry. Polling the result endpoints is free.
Enterprise Plans
Enterprise customers can request higher or custom rate limits. Contact us at contact@vidnavigator.com for details.