{"record":{"id":"4c37ee933afd883a","repo":"ytdl-org/youtube-dl","slug":"no-video-on-the-webpage","errorCode":null,"errorMessage":"no video on the webpage","messagePattern":"no video on the webpage","errorType":"exception","errorClass":"ExtractorError","httpStatus":null,"severity":"error","filePath":"youtube_dl/extractor/usatoday.py","lineNumber":50,"sourceCode":"        'url': 'https://www.usatoday.com/story/tech/science/2018/08/21/yellowstone-supervolcano-eruption-stop-worrying-its-blow/973633002/',\n        'info_dict': {\n            'id': '5824495846001',\n            'ext': 'mp4',\n            'title': 'Yellowstone more likely to crack rather than explode',\n            'timestamp': 1534790612,\n            'description': 'md5:3715e7927639a4f16b474e9391687c62',\n            'uploader_id': '28911775001',\n            'upload_date': '20180820',\n        }\n    }]\n    BRIGHTCOVE_URL_TEMPLATE = 'http://players.brightcove.net/%s/default_default/index.html?videoId=%s'\n\n    def _real_extract(self, url):\n        display_id = self._match_id(url)\n        webpage = self._download_webpage(update_url_query(url, {'ajax': 'true'}), display_id)\n        ui_video_data = get_element_by_attribute('class', 'ui-video-data', webpage)\n        if not ui_video_data:\n            raise ExtractorError('no video on the webpage', expected=True)\n        video_data = self._parse_json(ui_video_data, display_id)\n        item = try_get(video_data, lambda x: x['asset_metadata']['items'], dict) or {}\n\n        return {\n            '_type': 'url_transparent',\n            'url': self.BRIGHTCOVE_URL_TEMPLATE % (item.get('brightcoveaccount', '29906170001'), item.get('brightcoveid') or video_data['brightcove_id']),\n            'id': compat_str(video_data['id']),\n            'title': video_data['title'],\n            'thumbnail': video_data.get('thumbnail'),\n            'description': video_data.get('description'),\n            'duration': parse_duration(video_data.get('length')),\n            'ie_key': 'BrightcoveNew',\n        }\n","sourceCodeStart":32,"sourceCodeEnd":64,"githubUrl":"https://github.com/ytdl-org/youtube-dl/blob/956b8c585591b401a543e409accb163eeaaa1193/youtube_dl/extractor/usatoday.py#L32-L64","documentation":"Raised by the USA Today extractor when the AJAX-fetched article page (?ajax=true) contains no element with class 'ui-video-data'. That element is the sole source of the Brightcove asset metadata, so its absence means the URL has no embedded video reachable via this path. Marked expected=True, i.e. a content condition, not a downloader bug.","triggerScenarios":"Calling the extractor on a USA Today article URL (photo galleries, live blogs, plain text articles) that embeds its video through a different player or not at all; get_element_by_attribute('class', 'ui-video-data', webpage) returns None.","commonSituations":"Users pass a section/index URL instead of a video article; template changes rename the ui-video-data class; videos moved to a different CDN widget so the metadata div is dropped.","solutions":["Confirm the URL is an actual video article — open it in a browser and check a video player is present.","If a player exists, inspect the page source for the new container class and update get_element_by_attribute arguments in the extractor.","If the video is embedded differently (generic iframe/Brightcove), use the generic extractor or the BrightcoveNew extractor directly with the account/video ids.","Treat this as expected: skip the URL in batch jobs instead of aborting the run."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"from youtube_dl.utils import get_element_by_attribute\nwebpage = ydl.urlopen(url + '?ajax=true').read().decode()\nif get_element_by_attribute('class', 'ui-video-data', webpage) is None:\n    skip(url, 'no embedded video on page')  # avoid raising into the extractor","typeGuard":null,"tryCatchPattern":"try:\n    ydl.extract_info(url)\nexcept ExtractorError as e:\n    if e.expected and 'no video on the webpage' in str(e):\n        continue  # content condition, skip URL\n    raise","preventionTips":["Validate the URL points at a video article before queueing it.","Filter expected=True errors separately from unexpected ones in batch runners.","Check the page in a browser when a whole domain starts failing — likely a template change."],"tags":["content-missing","site-layout-change","html","expected-error"],"backgroundTag":null,"analyzedSha":"956b8c585591b401a543e409accb163eeaaa1193","analyzedAt":"2026-08-14T18:59:47.863Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}