What causes "Coming soon!" in ytdl-org/youtube-dl?

Wait until the scheduled broadcast time and retry

ytdl-org/youtube-dl · warning · ExtractorError

Coming soon!

Error message

Coming soon!

What it means

VLive scheduling error: the video's status field is 'RESERVED', meaning the broadcast is announced but has not started. The extractor raises 'Coming soon!' with expected=True because no stream or VOD exists yet.

Source

Thrown at youtube_dl/extractor/vlive.py:171

            if status == 'ON_AIR':
                stream_url = self._call_api(
                    'old/v3/live/%s/playInfo',
                    video_id)['result']['adaptiveStreamUrl']
                formats = self._extract_m3u8_formats(stream_url, video_id, 'mp4')
                self._sort_formats(formats)
                info = get_common_fields()
                info.update({
                    'title': self._live_title(video['title']),
                    'id': video_id,
                    'formats': formats,
                    'is_live': True,
                })
                return info
            elif status == 'ENDED':
                raise ExtractorError(
                    'Uploading for replay. Please wait...', expected=True)
            elif status == 'RESERVED':
                raise ExtractorError('Coming soon!', expected=True)
            elif video.get('exposeStatus') == 'CANCEL':
                raise ExtractorError(
                    'We are sorry, but the live broadcast has been canceled.',
                    expected=True)
            else:
                raise ExtractorError('Unknown status ' + status)


class VLivePostIE(VLiveIE):
    IE_NAME = 'vlive:post'
    _VALID_URL = r'https?://(?:(?:www|m)\.)?vlive\.tv/post/(?P<id>\d-\d+)'
    _TESTS = [{
        # uploadType = SOS
        'url': 'https://www.vlive.tv/post/1-20088044',
        'info_dict': {
            'id': '1-20088044',
            'title': 'Hola estrellitas la tierra les dice hola (si era así no?) Ha...',
            'description': 'md5:fab8a1e50e6e51608907f46c7fa4b407',

View on GitHub (pinned to 956b8c5855)

Solutions

Wait until the scheduled broadcast time and retry
Retry while status is LIVE if you want the live stream itself
Retry after ENDED->replay upload for the VOD

Defensive patterns

Strategy: retry

Try / catch

from youtube_dl.utils import ExtractorError
try:
    ydl.extract_info(url)
except ExtractorError as e:
    if 'Coming soon' in str(e):
        schedule_retry(url, at=broadcast_start_time)
    else:
        raise

Prevention

Look up the scheduled start time and delay extraction until then
Don't poll RESERVED URLs frequently — wasteful and unhelpful
Distinguish RESERVED (wait) from CANCELED (drop) in queue handlers

When it happens

Trigger: Extracting a VLive URL whose API status == 'RESERVED' (upcoming/announced broadcast).

Common situations: Pre-registering download jobs for announced livestreams; clicking a notification link before the broadcast begins.

Related errors

AI-assisted analysis of ytdl-org/youtube-dl@956b8c5855 (2026-08-14). Data as JSON: /api/errors/13bc1c7a58a5139e. Report an issue: GitHub.