API Documentation
Access the API to get subtitles from your own applications
Get Started
Guide to start using the API and information about credits
How to get API Key
1. Sign in to your account
2. Access the Settings page
3. Find and copy your API key in the API Settings section
Information about credits
Each successful API call consumes 1 credit from your account:
- Each successful API call = 1 credit (Only calls to supported sites)
- New subscribers get 500 credits during the 3-day trial. After that, 5000 credits / month.
- You can buy more credits when you've used up all your credits
Supported Sites
Altbalaji
Bilibili
Brightcove
DailymotionDimsum
Ondemandchina
ErosnowGoogle Drive
Facebook
KocowaHotstar
IqInstagram
Metopera
MGTV
Ondemandkorea
Pinterest
RuTubeTED
TikTokTV Naver
TV Nrk
TV LineTubiTV
Viki
VIU
VIU TV
VK
Vimeo
WeTV
Weverse
X (Twitter)
Zee5Youtube
Authentication
All API requests must be authenticated using your API key via the Authorization header
URL endpoint:
https://api.downsub.com
Header request example:
Authorization: Bearer Content-Type: application/json
Examples:
curl -X POST 'https://api.downsub.com/download' \
-H 'Authorization: Bearer ' \
-H 'Content-Type: application/json' \
-d '{"url": "https://www.youtube.com/watch?v=example"}'Status Codes
List of HTTP status codes that can be returned from the API
Success Codes
200
Request successful
Client Error Codes
400
Invalid request
401
Unauthorized or invalid API key
403
Access denied or usage limit exceeded
404
Resource not found
429
Too many requests in a short period of time
Server Error Codes
500
Server error
503
Service unavailable
API Endpoints
List of available API endpoints