TikTok Exceptions

TikTokError (base)
├── TikTokDeletedError
├── TikTokPrivateError
├── TikTokNetworkError
├── TikTokRateLimitError
├── TikTokRegionError
├── TikTokExtractionError
├── TikTokVideoTooLongError
└── TikTokInvalidLinkError

from tiktok_api.exceptions import TikTokError

try:
    video_info = await client.video(url)
except TikTokError as e:
    print(f"TikTok error occurred: {e}")

from tiktok_api.exceptions import TikTokDeletedError

try:
    video_info = await client.video(url)
except TikTokDeletedError:
    print("This video has been deleted")

from tiktok_api.exceptions import TikTokPrivateError

try:
    video_info = await client.video(url)
except TikTokPrivateError:
    print("This video is private")

from tiktok_api.exceptions import TikTokNetworkError

try:
    video_info = await client.video(url)
except TikTokNetworkError as e:
    print(f"Network error: {e}")
    # Maybe retry with exponential backoff

from tiktok_api.exceptions import TikTokRateLimitError
import asyncio

try:
    video_info = await client.video(url)
except TikTokRateLimitError:
    print("Rate limited, waiting 60 seconds...")
    await asyncio.sleep(60)
    # Retry with different proxy

from tiktok_api.exceptions import TikTokRegionError

try:
    video_info = await client.video(url)
except TikTokRegionError:
    print("This video is geo-blocked in your region")
    # Retry with proxy from different country

from tiktok_api.exceptions import TikTokExtractionError

try:
    video_info = await client.video(url)
except TikTokExtractionError as e:
    print(f"Extraction failed: {e}")
    # This might indicate TikTok changed their API

from tiktok_api.exceptions import TikTokVideoTooLongError

try:
    video_info = await client.video(url)
except TikTokVideoTooLongError:
    print("Video is too long to process")

from tiktok_api.exceptions import TikTokInvalidLinkError

try:
    video_info = await client.video(url)
except TikTokInvalidLinkError:
    print("Invalid or expired TikTok link")

from tiktok_api import TikTokClient
from tiktok_api.exceptions import TikTokError

client = TikTokClient()

try:
    video_info = await client.video(url)
    # Process video_info
except TikTokError as e:
    print(f"Error downloading TikTok video: {e}")

from tiktok_api import TikTokClient
from tiktok_api.exceptions import (
    TikTokDeletedError,
    TikTokPrivateError,
    TikTokRegionError,
    TikTokRateLimitError,
    TikTokNetworkError,
    TikTokError,
)

client = TikTokClient()

try:
    video_info = await client.video(url)
except TikTokDeletedError:
    print("Video was deleted by the creator")
except TikTokPrivateError:
    print("Video is private - authentication required")
except TikTokRegionError:
    print("Video is geo-blocked - try a different proxy region")
except TikTokRateLimitError:
    print("Rate limited - waiting before retry")
    await asyncio.sleep(60)
except TikTokNetworkError:
    print("Network error - check your connection")
except TikTokError as e:
    print(f"Other TikTok error: {e}")

from tiktok_api import TikTokClient, ProxyManager
from tiktok_api.exceptions import (
    TikTokRateLimitError,
    TikTokNetworkError,
    TikTokExtractionError,
)
import asyncio

proxy_manager = ProxyManager.initialize("proxies.txt")
client = TikTokClient(proxy_manager=proxy_manager)

max_attempts = 3
for attempt in range(max_attempts):
    try:
        video_info = await client.video(url)
        print("Success!")
        break
    except (TikTokRateLimitError, TikTokNetworkError, TikTokExtractionError) as e:
        if attempt < max_attempts - 1:
            print(f"Attempt {attempt + 1} failed: {e}. Retrying...")
            await asyncio.sleep(2 ** attempt)  # Exponential backoff
        else:
            print(f"All attempts failed: {e}")
            raise

from tiktok_api.exceptions import (
    TikTokDeletedError,
    TikTokPrivateError,
    TikTokRegionError,
    TikTokRateLimitError,
    TikTokNetworkError,
    TikTokInvalidLinkError,
    TikTokExtractionError,
    TikTokVideoTooLongError,
)

def get_user_friendly_error(error: Exception) -> str:
    """Convert TikTok exceptions to user-friendly messages."""
    if isinstance(error, TikTokDeletedError):
        return "😔 This video has been deleted and is no longer available."
    elif isinstance(error, TikTokPrivateError):
        return "🔒 This video is private and cannot be downloaded."
    elif isinstance(error, TikTokRegionError):
        return "🌍 This video is not available in your region."
    elif isinstance(error, TikTokRateLimitError):
        return "⏳ Too many requests. Please try again in a few minutes."
    elif isinstance(error, TikTokNetworkError):
        return "📡 Network error. Please check your connection and try again."
    elif isinstance(error, TikTokInvalidLinkError):
        return "❌ Invalid TikTok link. Please check the URL and try again."
    elif isinstance(error, TikTokVideoTooLongError):
        return "⏱️ This video is too long to process."
    elif isinstance(error, TikTokExtractionError):
        return "⚠️ Failed to extract video data. TikTok might have changed their system."
    else:
        return f"❌ An error occurred: {error}"

# Usage
try:
    video_info = await client.video(url)
except Exception as e:
    user_message = get_user_friendly_error(e)
    print(user_message)

import logging
from tiktok_api.exceptions import TikTokError

logger = logging.getLogger(__name__)

try:
    video_info = await client.video(url)
except TikTokError as e:
    logger.error(
        f"Failed to download TikTok video",
        exc_info=True,
        extra={
            "url": url,
            "error_type": type(e).__name__,
            "error_message": str(e),
        }
    )
    # Show user-friendly message to user
    print(get_user_friendly_error(e))