API Reference
Error Codes
API error codes and how to handle them
All error responses follow the format: { "success": false, "error": "ERROR_CODE: Description" }
Quick Reference
| Code | Status | Description |
|---|---|---|
INVALID_URL | 400 | URL not valid or unsupported platform |
PLATFORM_DISABLED | 503 | Platform temporarily disabled |
MAINTENANCE_MODE | 503 | XTFetch under maintenance |
RATE_LIMIT_EXCEEDED | 429 | Too many requests |
PRIVATE_CONTENT | 403 | Content is private |
COOKIE_REQUIRED | 401 | Platform requires cookie |
COOKIE_EXPIRED | 401 | Cookie has expired |
CONTENT_NOT_FOUND | 404 | Content not found or deleted |
NO_MEDIA_FOUND | 404 | No downloadable media |
NETWORK_ERROR | 500 | Failed to connect |
API_ERROR | 500 | Platform API error |
TIMEOUT | 504 | Request timeout |
Error Details & Solutions
INVALID_URLHTTP 400URL not valid or unsupported platform
💡Check URL format
PLATFORM_DISABLEDHTTP 503Platform temporarily disabled
💡Check status page
MAINTENANCE_MODEHTTP 503XTFetch under maintenance
💡Wait and retry
RATE_LIMIT_EXCEEDEDHTTP 429Too many requests
💡Wait 60 seconds
PRIVATE_CONTENTHTTP 403Content is private
💡Add cookie in Settings
COOKIE_REQUIREDHTTP 401Platform requires cookie
💡Add platform cookie
COOKIE_EXPIREDHTTP 401Cookie has expired
💡Get fresh cookie
CONTENT_NOT_FOUNDHTTP 404Content not found or deleted
💡Verify URL exists
NO_MEDIA_FOUNDHTTP 404No downloadable media
💡Check if post has video
NETWORK_ERRORHTTP 500Failed to connect
💡Check internet
API_ERRORHTTP 500Platform API error
💡Try again later
TIMEOUTHTTP 504Request timeout
💡Retry request