{"record":{"id":"3224b674c2d27cdd","repo":"ytdl-org/youtube-dl","slug":"episode-s-is-not-yet-available","errorCode":null,"errorMessage":"Episode %s is not yet available","messagePattern":"Episode (.+?) is not yet available","errorType":"exception","errorClass":"ExtractorError","httpStatus":null,"severity":"error","filePath":"youtube_dl/extractor/bbc.py","lineNumber":509,"sourceCode":"            'http://www.bbc.co.uk/iplayer/playlist/%s' % playlist_id, playlist_id)\n\n    def _download_legacy_playlist_url(self, url, playlist_id=None):\n        return self._download_xml(\n            url, playlist_id, 'Downloading legacy playlist XML')\n\n    def _extract_from_legacy_playlist(self, playlist, playlist_id):\n        no_items = playlist.find('./{%s}noItems' % self._EMP_PLAYLIST_NS)\n        if no_items is not None:\n            reason = no_items.get('reason')\n            if reason == 'preAvailability':\n                msg = 'Episode %s is not yet available' % playlist_id\n            elif reason == 'postAvailability':\n                msg = 'Episode %s is no longer available' % playlist_id\n            elif reason == 'noMedia':\n                msg = 'Episode %s is not currently available' % playlist_id\n            else:\n                msg = 'Episode %s is not available: %s' % (playlist_id, reason)\n            raise ExtractorError(msg, expected=True)\n\n        for item in self._extract_items(playlist):\n            kind = item.get('kind')\n            if kind not in ('programme', 'radioProgramme'):\n                continue\n            title = playlist.find('./{%s}title' % self._EMP_PLAYLIST_NS).text\n            description_el = playlist.find('./{%s}summary' % self._EMP_PLAYLIST_NS)\n            description = description_el.text if description_el is not None else None\n\n            def get_programme_id(item):\n                def get_from_attributes(item):\n                    for p in ('identifier', 'group'):\n                        value = item.get(p)\n                        if value and re.match(r'^[pb][\\da-z]{7}$', value):\n                            return value\n                get_from_attributes(item)\n                mediator = item.find('./{%s}mediator' % self._EMP_PLAYLIST_NS)\n                if mediator is not None:","sourceCodeStart":491,"sourceCodeEnd":527,"githubUrl":"https://github.com/ytdl-org/youtube-dl/blob/956b8c585591b401a543e409accb163eeaaa1193/youtube_dl/extractor/bbc.py#L491-L527","documentation":"One of four sibling availability errors from BBCCoUkIE._extract_from_legacy_playlist. When the legacy EMP playlist XML contains a noItems element whose reason attribute equals 'preAvailability', the episode exists but its media window has not opened yet, so the extractor raises 'Episode %s is not yet available' (expected=True) with the playlist id.","triggerScenarios":"Extracting a BBC programme id whose legacy playlist XML returns <noItems reason=\"preAvailability\"/> — i.e. the broadcast/publication time is in the future. Typically hit when scraping a programme page for an announced-but-unaired episode.","commonSituations":"Automated nightly jobs that walk a series feed and reach episodes scheduled for later in the week; clock/timezone confusion making an episode look aired when the BBC backend (UTC) still considers it pre-availability; pages listing upcoming episodes with playable-looking URLs.","solutions":["Wait until the episode's scheduled broadcast/publication time has passed (BBC backend time, UK timezone), then retry.","Check the episode page in a browser — a 'coming soon' badge confirms preAvailability.","In automation, schedule the retry around the UK air time rather than retrying immediately.","Confirm you are using the right programme id; a wrong id more often yields selectionunavailable instead."],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"try:\n    ydl.extract_info(episode_url)\nexcept ExtractorError as e:\n    if 'is not yet available' in str(e):\n        schedule_retry(episode_url, at=uk_airtime_plus_margin)  # retry after UK broadcast\n    else:\n        raise","preventionTips":["Schedule extractions after the UK broadcast time plus a safety margin.","In series-crawling jobs, skip episodes marked as upcoming on the programme page.","Use exponential backoff across hours, not seconds — availability opens on BBC backend time."],"tags":["bbc","availability","legacy-playlist","not-yet-published","extractor"],"backgroundTag":null,"analyzedSha":"956b8c585591b401a543e409accb163eeaaa1193","analyzedAt":"2026-08-14T18:59:47.863Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}