ytdl-org/youtube-dl · error · ExtractorError
info['errorMsg']
Error message
info['errorMsg']
What it means
Raised by the YinYueTai extractor when the get-h-mv-info API response's coreVideoInfo has a truthy 'error' field. The API's own errorMsg string is raised verbatim; typical values indicate region restriction (China-only content) or removed videos.
Source
Thrown at youtube_dl/extractor/yinyuetai.py:36
'title': '少女时代_PARTY_Music Video Teaser',
'creator': '少女时代',
'duration': 25,
'thumbnail': r're:^https?://.*\.jpg$',
},
}, {
'url': 'http://v.yinyuetai.com/video/h5/2322376',
'only_matching': True,
}]
def _real_extract(self, url):
video_id = self._match_id(url)
info = self._download_json(
'http://ext.yinyuetai.com/main/get-h-mv-info?json=true&videoId=%s' % video_id, video_id,
'Downloading mv info')['videoInfo']['coreVideoInfo']
if info['error']:
raise ExtractorError(info['errorMsg'], expected=True)
formats = [{
'url': format_info['videoUrl'],
'format_id': format_info['qualityLevel'],
'format': format_info.get('qualityLevelName'),
'filesize': format_info.get('fileSize'),
# though URLs ends with .flv, the downloaded files are in fact mp4
'ext': 'mp4',
'tbr': format_info.get('bitrate'),
} for format_info in info['videoUrlModels']]
self._sort_formats(formats)
return {
'id': video_id,
'title': info['videoName'],
'thumbnail': info.get('bigHeadImage'),
'creator': info.get('artistNames'),
'duration': info.get('duration'),View on GitHub (pinned to 956b8c5855)
Solutions
- Read the forwarded errorMsg — it is YinYueTai's own explanation (often Chinese; translate it).
- For region restrictions, use a mainland-China IP or find the MV on another platform.
- Verify the videoId on v.yinyuetai.com to rule out a stale ID.
Defensive patterns
Strategy: try-catch
Try / catch
try:
info = ydl.extract_info(url)
except ExtractorError as e:
msg = str(e)
if '版权' in msg or 'region' in msg.lower():
mark_geo_blocked(url, countries=['CN'])
else:
log_skip(url, msg) Prevention
- Expect China-only licensing on YinYueTai MVs; use a CN IP where lawful.
- Translate the Chinese errorMsg in logs to classify failure reasons.
- Confirm videoIds against v.yinyuetai.com before bulk extraction.
When it happens
Trigger: Requesting http://ext.yinyuetai.com/main/get-h-mv-info?json=true&videoId=<id> where videoInfo.coreVideoInfo['error'] is truthy; the check runs before format extraction.
Common situations: MVs restricted to mainland China when queried from abroad; videos delisted from the Chinese music video platform; service degradation of the ext.yinyuetai.com endpoint.
Related errors
AI-assisted analysis of ytdl-org/youtube-dl@956b8c5855 (2026-08-14).
Data as JSON: /api/errors/e71d8aa7b475c247.
Report an issue: GitHub.