{"record":{"id":"3e546682824e0fa9","repo":"ytdl-org/youtube-dl","slug":"invalid-download-number-s-for-query-s","errorCode":null,"errorMessage":"invalid download number %s for query \"%s\"","messagePattern":"invalid download number (.+?) for query \"(.+?)\"","errorType":"exception","errorClass":"ExtractorError","httpStatus":null,"severity":"error","filePath":"youtube_dl/extractor/common.py","lineNumber":3394,"sourceCode":"    @classmethod\n    def suitable(cls, url):\n        return re.match(cls._make_valid_url(), url) is not None\n\n    def _real_extract(self, query):\n        mobj = re.match(self._make_valid_url(), query)\n        if mobj is None:\n            raise ExtractorError('Invalid search query \"%s\"' % query)\n\n        prefix = mobj.group('prefix')\n        query = mobj.group('query')\n        if prefix == '':\n            return self._get_n_results(query, 1)\n        elif prefix == 'all':\n            return self._get_n_results(query, self._MAX_RESULTS)\n        else:\n            n = int(prefix)\n            if n <= 0:\n                raise ExtractorError('invalid download number %s for query \"%s\"' % (n, query))\n            elif n > self._MAX_RESULTS:\n                self._downloader.report_warning('%s returns max %i results (you requested %i)' % (self._SEARCH_KEY, self._MAX_RESULTS, n))\n                n = self._MAX_RESULTS\n            return self._get_n_results(query, n)\n\n    def _get_n_results(self, query, n):\n        \"\"\"Get a specified number of results for a query\"\"\"\n        raise NotImplementedError('This method must be implemented by subclasses')\n\n    @property\n    def SEARCH_KEY(self):\n        return self._SEARCH_KEY\n","sourceCodeStart":3376,"sourceCodeEnd":3407,"githubUrl":"https://github.com/ytdl-org/youtube-dl/blob/956b8c585591b401a543e409accb163eeaaa1193/youtube_dl/extractor/common.py#L3376-L3407","documentation":"Error \"invalid download number %s for query \"%s\"\" thrown in ytdl-org/youtube-dl.","triggerScenarios":"Thrown at youtube_dl/extractor/common.py:3394 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a valid download number for the query, e.g. ytsearch5:term with a positive integer."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"956b8c585591b401a543e409accb163eeaaa1193","analyzedAt":"2026-08-14T18:59:47.863Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}