{"openapi":"3.1.0","info":{"version":"1.0.1","title":"Poix API"},"servers":[{"url":"https://api.poix.io","description":"Production server"}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/captions/{videoId}":{"get":{"summary":"Get video captions","operationId":"getVideoCaptions","description":"This endpoint retrieves captions for a specified YouTube video. The captions can be returned in JSON, text, or CSV format. If available, it provides timing information, language, and speech rate data.","tags":["General"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","minLength":11,"maxLength":11,"description":"The YouTube video ID. This is a unique 11-character string that YouTube uses to identify videos.","example":"dQw4w9WgXcQ"},"required":true,"name":"videoId","in":"path"},{"schema":{"type":"string","enum":["json","text","csv","xml","srt","vtt","ttml","srv1","srv2","srv3","json3"],"description":"The format of the response. If not specified, defaults to JSON. Use \"text\" for plain text output, \"csv\" for comma-separated values, \"json\" for structured data and \"xml\" for XML output.","example":"json"},"required":false,"name":"format","in":"query"},{"schema":{"type":"string","enum":["en","es","de","fr","ja","pt","tr","it","fa","nl","af","am","ar","as","az","be","bg","bn","bs","ca","cs","da","el","en-GB","en-IN","es-419","es-US","et","eu","fi","fil","fr-CA","gl","gu","hi","hr","hu","hy","id","is","iw","ka","kk","km","kn","ko","ky","lo","lt","lv","mk","ml","mn","mr","ms","my","no","ne","or","pa","pl","pt-PT","ro","ru","si","sk","sl","sq","sr-Latn","sr","sv","sw","ta","te","th","uk","ur","uz","vi","zh-CN","zh-HK","zh-TW","zh-Hans","zu","en-US","zh-Hant","zh","yue"],"description":"The two-letter ISO 639-1 language code for the desired captions (e.g., \"en\" for English, \"es\" for Spanish). If not provided, the default language of the video's captions will be used.","example":"en"},"required":false,"name":"lang","in":"query"},{"schema":{"type":"string","enum":["default","fallback-whisper","force-whisper","fallback-auto-translated"],"description":"The mode to use when fetching captions. The \"default\" will throw an error if captions are not available in the requested language. The \"fallback-auto-translated\" will use YouTube auto-translated captions if the requested language is not natively available. The \"fallback-whisper\" will use the whisper API if no captions are available. The \"force-whisper\" will always use the whisper API.","example":"default"},"required":false,"name":"mode","in":"query"}],"responses":{"200":{"description":"Successful response. The format of the response depends on the \"format\" query parameter.","content":{"application/json":{"schema":{"anyOf":[{"title":"JSON","type":"array","description":"List of caption items. Each item represents a single caption with timing and speech information.","example":[{"text":"[Music]","duration":14.65,"offset":0,"lang":"en","wordCount":1,"speechRate":5},{"text":"we&amp;#39;re no strangers to","duration":7.239,"offset":18.8,"lang":"en","wordCount":7,"speechRate":59},{"text":"love you know the rules and so do","duration":7.84,"offset":21.8,"lang":"en","wordCount":8,"speechRate":62},{"text":"I I full commitments while I&amp;#39;m thinking","duration":5.201,"offset":26.039,"lang":"en","wordCount":10,"speechRate":116},{"text":"of","duration":5.88,"offset":29.64,"lang":"en","wordCount":1,"speechRate":11},{"text":"you wouldn&amp;#39;t get this from any other guy","duration":8.2,"offset":31.24,"lang":"en","wordCount":11,"speechRate":81},{"text":"I just want to tell you how I&amp;#39;m","duration":7.84,"offset":35.52,"lang":"en","wordCount":11,"speechRate":85},{"text":"feeling got to make you understand Never","duration":6.759,"offset":39.44,"lang":"en","wordCount":7,"speechRate":63},{"text":"Going To Give You Up never going to let","duration":6.359,"offset":43.36,"lang":"en","wordCount":9,"speechRate":85},{"text":"you down never going to run around and","duration":7.441,"offset":46.199,"lang":"en","wordCount":8,"speechRate":65},{"text":"desert you never going to make you cry","duration":6.401,"offset":49.719,"lang":"en","wordCount":8,"speechRate":75},{"text":"never going to say goodbye never going","duration":7.12,"offset":53.64,"lang":"en","wordCount":7,"speechRate":59},{"text":"to tell a lie and hurt you","duration":7.84,"offset":56.12,"lang":"en","wordCount":7,"speechRate":54},{"text":"we&amp;#39;ve known each other for so","duration":6.56,"offset":60.76,"lang":"en","wordCount":9,"speechRate":83},{"text":"long your heart&amp;#39;s been aching but your","duration":6.64,"offset":63.96,"lang":"en","wordCount":10,"speechRate":91},{"text":"to sh to say it inside we both know","duration":5.2,"offset":67.32,"lang":"en","wordCount":9,"speechRate":104},{"text":"what&amp;#39;s been going","duration":6.04,"offset":70.6,"lang":"en","wordCount":6,"speechRate":60},{"text":"on we know the game and we&amp;#39;re going to","duration":8.88,"offset":72.52,"lang":"en","wordCount":12,"speechRate":82},{"text":"playing and if you ask me how I&amp;#39;m","duration":7.96,"offset":76.64,"lang":"en","wordCount":11,"speechRate":83},{"text":"feeling don&amp;#39;t tell me you&amp;#39;re too my you","duration":6.32,"offset":81.4,"lang":"en","wordCount":14,"speechRate":133},{"text":"see Never Going To Give You Up never","duration":6.199,"offset":84.6,"lang":"en","wordCount":8,"speechRate":78},{"text":"going to let you down never to run","duration":6.679,"offset":87.72,"lang":"en","wordCount":8,"speechRate":72},{"text":"around and desert you never going to","duration":7.28,"offset":90.799,"lang":"en","wordCount":7,"speechRate":58},{"text":"make you cry never going to say goodbye","duration":7.841,"offset":94.399,"lang":"en","wordCount":8,"speechRate":62},{"text":"never going to tell a lie and hurt you","duration":6.601,"offset":98.079,"lang":"en","wordCount":9,"speechRate":82},{"text":"never going to give you up never going","duration":5.44,"offset":102.24,"lang":"en","wordCount":8,"speechRate":89},{"text":"to let you down never going to run","duration":6.64,"offset":104.68,"lang":"en","wordCount":8,"speechRate":73},{"text":"around and desert you never going to","duration":7.52,"offset":107.68,"lang":"en","wordCount":7,"speechRate":56},{"text":"make you cry never going to sing goodbye","duration":7.52,"offset":111.32,"lang":"en","wordCount":8,"speechRate":64},{"text":"going to tell a lie and hurt","duration":6.64,"offset":115.2,"lang":"en","wordCount":7,"speechRate":64},{"text":"you","duration":3,"offset":118.84,"lang":"en","wordCount":1,"speechRate":20},{"text":"give","duration":2.32,"offset":121.96,"lang":"en","wordCount":1,"speechRate":26},{"text":"you give","duration":6.639,"offset":125.24,"lang":"en","wordCount":2,"speechRate":19},{"text":"you going to give going to give","duration":8.2,"offset":127.64,"lang":"en","wordCount":7,"speechRate":52},{"text":"you going to give going to give","duration":8.161,"offset":131.879,"lang":"en","wordCount":7,"speechRate":52},{"text":"you we&amp;#39;ve known each other for so","duration":7.52,"offset":135.84,"lang":"en","wordCount":10,"speechRate":80},{"text":"long your heart&amp;#39;s been aching but you&amp;#39;re","duration":6.88,"offset":140.04,"lang":"en","wordCount":13,"speechRate":114},{"text":"too sh to say inside we both know what&amp;#39;s","duration":5.12,"offset":143.36,"lang":"en","wordCount":12,"speechRate":141},{"text":"been going","duration":5.8,"offset":146.92,"lang":"en","wordCount":2,"speechRate":21},{"text":"on we the game and we&amp;#39;re going to play","duration":9.28,"offset":148.48,"lang":"en","wordCount":12,"speechRate":78},{"text":"it I just want to tell you how I&amp;#39;m","duration":8.92,"offset":152.72,"lang":"en","wordCount":12,"speechRate":81},{"text":"feeling got to make you understand Never","duration":6.72,"offset":157.76,"lang":"en","wordCount":7,"speechRate":63},{"text":"Going To Give You Up never going to let","duration":6.44,"offset":161.64,"lang":"en","wordCount":9,"speechRate":84},{"text":"you down never going to run around and","duration":7.479,"offset":164.48,"lang":"en","wordCount":8,"speechRate":65},{"text":"desert you never going to make you cry","duration":6.36,"offset":168.08,"lang":"en","wordCount":8,"speechRate":76},{"text":"never going to say goodbye never going","duration":6.681,"offset":171.959,"lang":"en","wordCount":7,"speechRate":63},{"text":"to tell you my and Hurt You Never Going","duration":5.96,"offset":174.44,"lang":"en","wordCount":9,"speechRate":91},{"text":"To Give You Up","duration":4.239,"offset":178.64,"lang":"en","wordCount":4,"speechRate":57},{"text":"never going to let you down never going","duration":6.68,"offset":180.4,"lang":"en","wordCount":8,"speechRate":72},{"text":"to run around and desert you never going","duration":8.161,"offset":182.879,"lang":"en","wordCount":8,"speechRate":59},{"text":"to make you C never going to say goodbye","duration":5.32,"offset":187.08,"lang":"en","wordCount":9,"speechRate":102},{"text":"never going to","duration":5.6,"offset":191.04,"lang":"en","wordCount":3,"speechRate":33},{"text":"tell and Hur You Never Going To Give You","duration":7.28,"offset":192.4,"lang":"en","wordCount":9,"speechRate":75},{"text":"Up never going to let you down never","duration":7.319,"offset":196.64,"lang":"en","wordCount":8,"speechRate":66},{"text":"going to run around and desert you never","duration":7.35,"offset":199.68,"lang":"en","wordCount":8,"speechRate":66},{"text":"going to make you going to","duration":4.721,"offset":203.959,"lang":"en","wordCount":6,"speechRate":77},{"text":"[Music]","duration":3.97,"offset":207.03,"lang":"en","wordCount":1,"speechRate":16},{"text":"goodbye","duration":5.32,"offset":208.68,"lang":"en","wordCount":1,"speechRate":12},{"text":"and","duration":3,"offset":211,"lang":"en","wordCount":1,"speechRate":20}],"items":{"type":"object","description":"Caption item","properties":{"offset":{"type":"number","example":0,"description":"The start time of the caption in seconds from the beginning of the video"},"duration":{"type":"number","example":14.65,"description":"The duration of the caption in seconds"},"lang":{"type":"string","example":"en","description":"The two-letter ISO 639-1 language code for the caption"},"text":{"type":"string","example":"you down never going to run around and","description":"The text content of the caption"},"wordCount":{"type":"integer","example":8,"description":"The number of words in this particular caption"},"speechRate":{"type":"number","example":65,"description":"The speech rate in words per minute for this particular caption"}},"required":["offset","duration","lang","text","wordCount","speechRate"]}},{"title":"Text","type":"string","description":"Plain text response containing all captions concatenated together","example":"[Music] we&amp;#39;re no strangers to love you know the rules and so do I I full commitments while I&amp;#39;m thinking of you wouldn&amp;#39;t get this from any other guy I just want to tell you how I&amp;#39;m feeling got to make you understand Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you cry never going to say goodbye never going to tell a lie and hurt you we&amp;#39;ve known each other for so long your heart&amp;#39;s been aching but your to sh to say it inside we both know what&amp;#39;s been going on we know the game and we&amp;#39;re going to playing and if you ask me how I&amp;#39;m feeling don&amp;#39;t tell me you&amp;#39;re too my you see Never Going To Give You Up never going to let you down never to run around and desert you never going to make you cry never going to say goodbye never going to tell a lie and hurt you never going to give you up never going to let you down never going to run around and desert you never going to make you cry never going to sing goodbye going to tell a lie and hurt you give you give you going to give going to give you going to give going to give you we&amp;#39;ve known each other for so long your heart&amp;#39;s been aching but you&amp;#39;re too sh to say inside we both know what&amp;#39;s been going on we the game and we&amp;#39;re going to play it I just want to tell you how I&amp;#39;m feeling got to make you understand Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you cry never going to say goodbye never going to tell you my and Hurt You Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you C never going to say goodbye never going to tell and Hur You Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you going to [Music] goodbye and"},{"title":"CSV","type":"string","description":"Comma-separated values response with headers for each caption property","example":"text,duration,offset,lang,wordCount,speechRate\n[Music],14.65,0,en,1,5\nwe&amp;#39;re no strangers to,7.239,18.8,en,7,59\nlove you know the rules and so do,7.84,21.8,en,8,62\nI I full commitments while I&amp;#39;m thinking,5.201,26.039,en,10,116\nof,5.88,29.64,en,1,11\nyou wouldn&amp;#39;t get this from any other guy,8.2,31.24,en,11,81\nI just want to tell you how I&amp;#39;m,7.84,35.52,en,11,85\nfeeling got to make you understand Never,6.759,39.44,en,7,63\nGoing To Give You Up never going to let,6.359,43.36,en,9,85\nyou down never going to run around and,7.441,46.199,en,8,65\ndesert you never going to make you cry,6.401,49.719,en,8,75\nnever going to say goodbye never going,7.12,53.64,en,7,59\nto tell a lie and hurt you,7.84,56.12,en,7,54\nwe&amp;#39;ve known each other for so,6.56,60.76,en,9,83\nlong your heart&amp;#39;s been aching but your,6.64,63.96,en,10,91\nto sh to say it inside we both know,5.2,67.32,en,9,104\nwhat&amp;#39;s been going,6.04,70.6,en,6,60\non we know the game and we&amp;#39;re going to,8.88,72.52,en,12,82\nplaying and if you ask me how I&amp;#39;m,7.96,76.64,en,11,83\nfeeling don&amp;#39;t tell me you&amp;#39;re too my you,6.32,81.4,en,14,133\nsee Never Going To Give You Up never,6.199,84.6,en,8,78\ngoing to let you down never to run,6.679,87.72,en,8,72\naround and desert you never going to,7.28,90.799,en,7,58\nmake you cry never going to say goodbye,7.841,94.399,en,8,62\nnever going to tell a lie and hurt you,6.601,98.079,en,9,82\nnever going to give you up never going,5.44,102.24,en,8,89\nto let you down never going to run,6.64,104.68,en,8,73\naround and desert you never going to,7.52,107.68,en,7,56\nmake you cry never going to sing goodbye,7.52,111.32,en,8,64\ngoing to tell a lie and hurt,6.64,115.2,en,7,64\nyou,3,118.84,en,1,20\ngive,2.32,121.96,en,1,26\nyou give,6.639,125.24,en,2,19\nyou going to give going to give,8.2,127.64,en,7,52\nyou going to give going to give,8.161,131.879,en,7,52\nyou we&amp;#39;ve known each other for so,7.52,135.84,en,10,80\nlong your heart&amp;#39;s been aching but you&amp;#39;re,6.88,140.04,en,13,114\ntoo sh to say inside we both know what&amp;#39;s,5.12,143.36,en,12,141\nbeen going,5.8,146.92,en,2,21\non we the game and we&amp;#39;re going to play,9.28,148.48,en,12,78\nit I just want to tell you how I&amp;#39;m,8.92,152.72,en,12,81\nfeeling got to make you understand Never,6.72,157.76,en,7,63\nGoing To Give You Up never going to let,6.44,161.64,en,9,84\nyou down never going to run around and,7.479,164.48,en,8,65\ndesert you never going to make you cry,6.36,168.08,en,8,76\nnever going to say goodbye never going,6.681,171.959,en,7,63\nto tell you my and Hurt You Never Going,5.96,174.44,en,9,91\nTo Give You Up,4.239,178.64,en,4,57\nnever going to let you down never going,6.68,180.4,en,8,72\nto run around and desert you never going,8.161,182.879,en,8,59\nto make you C never going to say goodbye,5.32,187.08,en,9,102\nnever going to,5.6,191.04,en,3,33\ntell and Hur You Never Going To Give You,7.28,192.4,en,9,75\nUp never going to let you down never,7.319,196.64,en,8,66\ngoing to run around and desert you never,7.35,199.68,en,8,66\ngoing to make you going to,4.721,203.959,en,6,77\n[Music],3.97,207.03,en,1,16\ngoodbye,5.32,208.68,en,1,12\nand,3,211,en,1,20"}]},"examples":{"JSON":{"value":[{"text":"[Music]","duration":14.65,"offset":0,"lang":"en","wordCount":1,"speechRate":5},{"text":"we&amp;#39;re no strangers to","duration":7.239,"offset":18.8,"lang":"en","wordCount":7,"speechRate":59},{"text":"love you know the rules and so do","duration":7.84,"offset":21.8,"lang":"en","wordCount":8,"speechRate":62},{"text":"I I full commitments while I&amp;#39;m thinking","duration":5.201,"offset":26.039,"lang":"en","wordCount":10,"speechRate":116},{"text":"of","duration":5.88,"offset":29.64,"lang":"en","wordCount":1,"speechRate":11},{"text":"you wouldn&amp;#39;t get this from any other guy","duration":8.2,"offset":31.24,"lang":"en","wordCount":11,"speechRate":81},{"text":"I just want to tell you how I&amp;#39;m","duration":7.84,"offset":35.52,"lang":"en","wordCount":11,"speechRate":85},{"text":"feeling got to make you understand Never","duration":6.759,"offset":39.44,"lang":"en","wordCount":7,"speechRate":63},{"text":"Going To Give You Up never going to let","duration":6.359,"offset":43.36,"lang":"en","wordCount":9,"speechRate":85},{"text":"you down never going to run around and","duration":7.441,"offset":46.199,"lang":"en","wordCount":8,"speechRate":65},{"text":"desert you never going to make you cry","duration":6.401,"offset":49.719,"lang":"en","wordCount":8,"speechRate":75},{"text":"never going to say goodbye never going","duration":7.12,"offset":53.64,"lang":"en","wordCount":7,"speechRate":59},{"text":"to tell a lie and hurt you","duration":7.84,"offset":56.12,"lang":"en","wordCount":7,"speechRate":54},{"text":"we&amp;#39;ve known each other for so","duration":6.56,"offset":60.76,"lang":"en","wordCount":9,"speechRate":83},{"text":"long your heart&amp;#39;s been aching but your","duration":6.64,"offset":63.96,"lang":"en","wordCount":10,"speechRate":91},{"text":"to sh to say it inside we both know","duration":5.2,"offset":67.32,"lang":"en","wordCount":9,"speechRate":104},{"text":"what&amp;#39;s been going","duration":6.04,"offset":70.6,"lang":"en","wordCount":6,"speechRate":60},{"text":"on we know the game and we&amp;#39;re going to","duration":8.88,"offset":72.52,"lang":"en","wordCount":12,"speechRate":82},{"text":"playing and if you ask me how I&amp;#39;m","duration":7.96,"offset":76.64,"lang":"en","wordCount":11,"speechRate":83},{"text":"feeling don&amp;#39;t tell me you&amp;#39;re too my you","duration":6.32,"offset":81.4,"lang":"en","wordCount":14,"speechRate":133},{"text":"see Never Going To Give You Up never","duration":6.199,"offset":84.6,"lang":"en","wordCount":8,"speechRate":78},{"text":"going to let you down never to run","duration":6.679,"offset":87.72,"lang":"en","wordCount":8,"speechRate":72},{"text":"around and desert you never going to","duration":7.28,"offset":90.799,"lang":"en","wordCount":7,"speechRate":58},{"text":"make you cry never going to say goodbye","duration":7.841,"offset":94.399,"lang":"en","wordCount":8,"speechRate":62},{"text":"never going to tell a lie and hurt you","duration":6.601,"offset":98.079,"lang":"en","wordCount":9,"speechRate":82},{"text":"never going to give you up never going","duration":5.44,"offset":102.24,"lang":"en","wordCount":8,"speechRate":89},{"text":"to let you down never going to run","duration":6.64,"offset":104.68,"lang":"en","wordCount":8,"speechRate":73},{"text":"around and desert you never going to","duration":7.52,"offset":107.68,"lang":"en","wordCount":7,"speechRate":56},{"text":"make you cry never going to sing goodbye","duration":7.52,"offset":111.32,"lang":"en","wordCount":8,"speechRate":64},{"text":"going to tell a lie and hurt","duration":6.64,"offset":115.2,"lang":"en","wordCount":7,"speechRate":64},{"text":"you","duration":3,"offset":118.84,"lang":"en","wordCount":1,"speechRate":20},{"text":"give","duration":2.32,"offset":121.96,"lang":"en","wordCount":1,"speechRate":26},{"text":"you give","duration":6.639,"offset":125.24,"lang":"en","wordCount":2,"speechRate":19},{"text":"you going to give going to give","duration":8.2,"offset":127.64,"lang":"en","wordCount":7,"speechRate":52},{"text":"you going to give going to give","duration":8.161,"offset":131.879,"lang":"en","wordCount":7,"speechRate":52},{"text":"you we&amp;#39;ve known each other for so","duration":7.52,"offset":135.84,"lang":"en","wordCount":10,"speechRate":80},{"text":"long your heart&amp;#39;s been aching but you&amp;#39;re","duration":6.88,"offset":140.04,"lang":"en","wordCount":13,"speechRate":114},{"text":"too sh to say inside we both know what&amp;#39;s","duration":5.12,"offset":143.36,"lang":"en","wordCount":12,"speechRate":141},{"text":"been going","duration":5.8,"offset":146.92,"lang":"en","wordCount":2,"speechRate":21},{"text":"on we the game and we&amp;#39;re going to play","duration":9.28,"offset":148.48,"lang":"en","wordCount":12,"speechRate":78},{"text":"it I just want to tell you how I&amp;#39;m","duration":8.92,"offset":152.72,"lang":"en","wordCount":12,"speechRate":81},{"text":"feeling got to make you understand Never","duration":6.72,"offset":157.76,"lang":"en","wordCount":7,"speechRate":63},{"text":"Going To Give You Up never going to let","duration":6.44,"offset":161.64,"lang":"en","wordCount":9,"speechRate":84},{"text":"you down never going to run around and","duration":7.479,"offset":164.48,"lang":"en","wordCount":8,"speechRate":65},{"text":"desert you never going to make you cry","duration":6.36,"offset":168.08,"lang":"en","wordCount":8,"speechRate":76},{"text":"never going to say goodbye never going","duration":6.681,"offset":171.959,"lang":"en","wordCount":7,"speechRate":63},{"text":"to tell you my and Hurt You Never Going","duration":5.96,"offset":174.44,"lang":"en","wordCount":9,"speechRate":91},{"text":"To Give You Up","duration":4.239,"offset":178.64,"lang":"en","wordCount":4,"speechRate":57},{"text":"never going to let you down never going","duration":6.68,"offset":180.4,"lang":"en","wordCount":8,"speechRate":72},{"text":"to run around and desert you never going","duration":8.161,"offset":182.879,"lang":"en","wordCount":8,"speechRate":59},{"text":"to make you C never going to say goodbye","duration":5.32,"offset":187.08,"lang":"en","wordCount":9,"speechRate":102},{"text":"never going to","duration":5.6,"offset":191.04,"lang":"en","wordCount":3,"speechRate":33},{"text":"tell and Hur You Never Going To Give You","duration":7.28,"offset":192.4,"lang":"en","wordCount":9,"speechRate":75},{"text":"Up never going to let you down never","duration":7.319,"offset":196.64,"lang":"en","wordCount":8,"speechRate":66},{"text":"going to run around and desert you never","duration":7.35,"offset":199.68,"lang":"en","wordCount":8,"speechRate":66},{"text":"going to make you going to","duration":4.721,"offset":203.959,"lang":"en","wordCount":6,"speechRate":77},{"text":"[Music]","duration":3.97,"offset":207.03,"lang":"en","wordCount":1,"speechRate":16},{"text":"goodbye","duration":5.32,"offset":208.68,"lang":"en","wordCount":1,"speechRate":12},{"text":"and","duration":3,"offset":211,"lang":"en","wordCount":1,"speechRate":20}]},"Text":{"value":"[Music] we&amp;#39;re no strangers to love you know the rules and so do I I full commitments while I&amp;#39;m thinking of you wouldn&amp;#39;t get this from any other guy I just want to tell you how I&amp;#39;m feeling got to make you understand Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you cry never going to say goodbye never going to tell a lie and hurt you we&amp;#39;ve known each other for so long your heart&amp;#39;s been aching but your to sh to say it inside we both know what&amp;#39;s been going on we know the game and we&amp;#39;re going to playing and if you ask me how I&amp;#39;m feeling don&amp;#39;t tell me you&amp;#39;re too my you see Never Going To Give You Up never going to let you down never to run around and desert you never going to make you cry never going to say goodbye never going to tell a lie and hurt you never going to give you up never going to let you down never going to run around and desert you never going to make you cry never going to sing goodbye going to tell a lie and hurt you give you give you going to give going to give you going to give going to give you we&amp;#39;ve known each other for so long your heart&amp;#39;s been aching but you&amp;#39;re too sh to say inside we both know what&amp;#39;s been going on we the game and we&amp;#39;re going to play it I just want to tell you how I&amp;#39;m feeling got to make you understand Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you cry never going to say goodbye never going to tell you my and Hurt You Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you C never going to say goodbye never going to tell and Hur You Never Going To Give You Up never going to let you down never going to run around and desert you never going to make you going to [Music] goodbye and"},"CSV":{"value":"text,duration,offset,lang,wordCount,speechRate\n[Music],14.65,0,en,1,5\nwe&amp;#39;re no strangers to,7.239,18.8,en,7,59\nlove you know the rules and so do,7.84,21.8,en,8,62\nI I full commitments while I&amp;#39;m thinking,5.201,26.039,en,10,116\nof,5.88,29.64,en,1,11\nyou wouldn&amp;#39;t get this from any other guy,8.2,31.24,en,11,81\nI just want to tell you how I&amp;#39;m,7.84,35.52,en,11,85\nfeeling got to make you understand Never,6.759,39.44,en,7,63\nGoing To Give You Up never going to let,6.359,43.36,en,9,85\nyou down never going to run around and,7.441,46.199,en,8,65\ndesert you never going to make you cry,6.401,49.719,en,8,75\nnever going to say goodbye never going,7.12,53.64,en,7,59\nto tell a lie and hurt you,7.84,56.12,en,7,54\nwe&amp;#39;ve known each other for so,6.56,60.76,en,9,83\nlong your heart&amp;#39;s been aching but your,6.64,63.96,en,10,91\nto sh to say it inside we both know,5.2,67.32,en,9,104\nwhat&amp;#39;s been going,6.04,70.6,en,6,60\non we know the game and we&amp;#39;re going to,8.88,72.52,en,12,82\nplaying and if you ask me how I&amp;#39;m,7.96,76.64,en,11,83\nfeeling don&amp;#39;t tell me you&amp;#39;re too my you,6.32,81.4,en,14,133\nsee Never Going To Give You Up never,6.199,84.6,en,8,78\ngoing to let you down never to run,6.679,87.72,en,8,72\naround and desert you never going to,7.28,90.799,en,7,58\nmake you cry never going to say goodbye,7.841,94.399,en,8,62\nnever going to tell a lie and hurt you,6.601,98.079,en,9,82\nnever going to give you up never going,5.44,102.24,en,8,89\nto let you down never going to run,6.64,104.68,en,8,73\naround and desert you never going to,7.52,107.68,en,7,56\nmake you cry never going to sing goodbye,7.52,111.32,en,8,64\ngoing to tell a lie and hurt,6.64,115.2,en,7,64\nyou,3,118.84,en,1,20\ngive,2.32,121.96,en,1,26\nyou give,6.639,125.24,en,2,19\nyou going to give going to give,8.2,127.64,en,7,52\nyou going to give going to give,8.161,131.879,en,7,52\nyou we&amp;#39;ve known each other for so,7.52,135.84,en,10,80\nlong your heart&amp;#39;s been aching but you&amp;#39;re,6.88,140.04,en,13,114\ntoo sh to say inside we both know what&amp;#39;s,5.12,143.36,en,12,141\nbeen going,5.8,146.92,en,2,21\non we the game and we&amp;#39;re going to play,9.28,148.48,en,12,78\nit I just want to tell you how I&amp;#39;m,8.92,152.72,en,12,81\nfeeling got to make you understand Never,6.72,157.76,en,7,63\nGoing To Give You Up never going to let,6.44,161.64,en,9,84\nyou down never going to run around and,7.479,164.48,en,8,65\ndesert you never going to make you cry,6.36,168.08,en,8,76\nnever going to say goodbye never going,6.681,171.959,en,7,63\nto tell you my and Hurt You Never Going,5.96,174.44,en,9,91\nTo Give You Up,4.239,178.64,en,4,57\nnever going to let you down never going,6.68,180.4,en,8,72\nto run around and desert you never going,8.161,182.879,en,8,59\nto make you C never going to say goodbye,5.32,187.08,en,9,102\nnever going to,5.6,191.04,en,3,33\ntell and Hur You Never Going To Give You,7.28,192.4,en,9,75\nUp never going to let you down never,7.319,196.64,en,8,66\ngoing to run around and desert you never,7.35,199.68,en,8,66\ngoing to make you going to,4.721,203.959,en,6,77\n[Music],3.97,207.03,en,1,16\ngoodbye,5.32,208.68,en,1,12\nand,3,211,en,1,20"}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","type","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"too_big","maximum":11,"type":"string","inclusive":true,"exact":true,"message":"String must contain exactly 11 character(s)","path":["videoId"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/files/video/{videoId}":{"get":{"summary":"Get video files list","operationId":"getVideoFilesList","description":"This endpoint retrieves a list of video files for a specified YouTube video.","tags":["Files"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","minLength":11,"maxLength":11,"description":"The YouTube video ID","example":"dQw4w9WgXcQ"},"required":true,"name":"videoId","in":"path"},{"schema":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AN","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BM","BN","BO","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","EU","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","ST","SV","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"],"description":"Instructs the API to return results as if the request was made from a specific country. ISO 3166 alpha-2 country code."},"required":false,"description":"Instructs the API to return results as if the request was made from a specific country. ISO 3166 alpha-2 country code.","name":"regionCode","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"itag":{"type":"integer","exclusiveMinimum":0,"description":"The itag of the video format"},"url":{"type":"string","format":"uri","description":"The URL of the video file"},"mimeType":{"type":"string","description":"The MIME type of the video file"},"bitrate":{"type":"integer","exclusiveMinimum":0,"description":"The bitrate of the video in bits per second"},"width":{"type":"integer","exclusiveMinimum":0,"description":"The width of the video in pixels"},"height":{"type":"integer","exclusiveMinimum":0,"description":"The height of the video in pixels"},"initRange":{"type":"object","properties":{"start":{"type":"string","description":"The start byte of the initialization range"},"end":{"type":"string","description":"The end byte of the initialization range"}},"required":["start","end"],"description":"The initialization range for the video file"},"indexRange":{"type":"object","properties":{"start":{"type":"string","description":"The start byte of the index range"},"end":{"type":"string","description":"The end byte of the index range"}},"required":["start","end"],"description":"The index range for the video file"},"lastModified":{"type":"string","description":"The last modified timestamp of the video file"},"contentLength":{"type":"string","description":"The content length of the video file in bytes"},"quality":{"type":"string","description":"The quality label of the video"},"fps":{"type":"integer","exclusiveMinimum":0,"description":"The frames per second of the video"},"qualityLabel":{"type":"string","description":"The quality label of the video (e.g., 720p, 1080p)"},"projectionType":{"type":"string","description":"The projection type of the video"},"averageBitrate":{"type":"integer","exclusiveMinimum":0,"description":"The average bitrate of the video in bits per second"},"approxDurationMs":{"type":"string","description":"The approximate duration of the video in milliseconds"},"parsedContentLength":{"type":"string","description":"The parsed content length in a human-readable format"},"lengthSeconds":{"type":"string","description":"The length of the video in seconds"},"parsedLastModified":{"type":"string","description":"The parsed last modified date in ISO 8601 format"},"highReplication":{"type":"boolean","description":"Indicates if the video has high replication"}},"required":["itag","url","mimeType","bitrate","width","height","initRange","indexRange","lastModified","contentLength","quality","fps","qualityLabel","projectionType","averageBitrate","approxDurationMs","parsedContentLength","lengthSeconds","parsedLastModified"]},"description":"List of available video files"},"example":[{"itag":18,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFTGwNil4uu7CLA9rDEnIqYBg7cJKaqB_AEuBqTO-rFhDr7i8YEeOQ0BEuy4h2wRpSFHtOIueRS2&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=43264901&ratebypass=yes&dur=703.657&lmt=1724964085878348&mt=1727160066&fvip=3&fexp=51299151&c=ANDROID_CREATOR&txp=5538434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cratebypass%2Cdur%2Clmt&sig=AJfQdSswRQIgAhyfIbg6G2UrPd6OvmchXq5CY9LLBbYQ36pFB27Lf3oCIQCucMXLxH_mePAdWYinUjRMRptvnFwjEwi7cfmAf2lXoQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/mp4; codecs=\"avc1.42001E, mp4a.40.2\"","bitrate":491926,"width":640,"height":360,"initRange":{},"indexRange":{},"lastModified":"1724964085878348","contentLength":"43264901","quality":"medium","fps":25,"qualityLabel":"360p","projectionType":"RECTANGULAR","averageBitrate":491886,"approxDurationMs":"703657","parsedContentLength":"41.26 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-09T02:31:18.348Z"},{"itag":137,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=137&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=148092497&dur=703.600&lmt=1724964676123051&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIhALdoySWMmiUJCXmZhdcCPGi8ZTX4XBKqVZC9nU5BAxVCAiA0g3jQMQUOrm9W1ZZG_2tLNM3jWs7nlRPPhJKMrUWgWQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/mp4; codecs=\"avc1.640028\"","bitrate":4549042,"width":1920,"height":1080,"initRange":{"start":"0","end":"741"},"indexRange":{"start":"742","end":"2309"},"lastModified":"1724964676123051","contentLength":"148092497","quality":"hd1080","fps":25,"qualityLabel":"1080p","projectionType":"RECTANGULAR","averageBitrate":1683826,"approxDurationMs":"703600","parsedContentLength":"141.23 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-15T22:28:43.051Z"},{"itag":248,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=248&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=92477954&dur=703.600&lmt=1724964540896123&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRgIhAMiO2b4ZIJbwPA81QXFYoJvt5ONvl_L0Che_Y6RzoQ4XAiEAoz8eTqsYquIXAC4SOI0Ob87cBhFsbrnu5wTdG5T7Q2U%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/webm; codecs=\"vp9\"","bitrate":2549207,"width":1920,"height":1080,"initRange":{"start":"0","end":"219"},"indexRange":{"start":"220","end":"2489"},"lastModified":"1724964540896123","contentLength":"92477954","quality":"hd1080","fps":25,"qualityLabel":"1080p","projectionType":"RECTANGULAR","averageBitrate":1051483,"approxDurationMs":"703600","parsedContentLength":"88.19 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-14T08:54:56.123Z"},{"itag":136,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=136&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=38644716&dur=703.600&lmt=1724964616509682&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRgIhAMeZOMeDCSgSOLgVRLbbX9Im7AppaNjZlJ4sUqydKmKUAiEA37IlOUsSv8CIo4aXD0KvJGeaPH3GfQv8rQnCYJ6c6UM%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/mp4; codecs=\"avc1.4d401f\"","bitrate":2019682,"width":1280,"height":720,"initRange":{"start":"0","end":"739"},"indexRange":{"start":"740","end":"2307"},"lastModified":"1724964616509682","contentLength":"38644716","quality":"hd720","fps":25,"qualityLabel":"720p","projectionType":"RECTANGULAR","averageBitrate":439394,"approxDurationMs":"703600","parsedContentLength":"36.85 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-15T05:55:09.682Z"},{"itag":247,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=247&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=42703548&dur=703.600&lmt=1724964988146615&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIhALbvr9yzW_wlHbtC9IUN-owzNSO9q7VItaQSnZiPux9UAiBd3m6-ykHI9RGOHmBtucZ9h9s-BoabiFYG-b2fqLzxrQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/webm; codecs=\"vp9\"","bitrate":1540241,"width":1280,"height":720,"initRange":{"start":"0","end":"219"},"indexRange":{"start":"220","end":"2463"},"lastModified":"1724964988146615","contentLength":"42703548","quality":"hd720","fps":25,"qualityLabel":"720p","projectionType":"RECTANGULAR","averageBitrate":485543,"approxDurationMs":"703600","parsedContentLength":"40.73 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-19T13:09:06.615Z"},{"itag":135,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=135&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=20918173&dur=703.600&lmt=1724964616614986&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgY-3hHzvrvVD2dzfKRNif9M4evsTJnJ-gJWJ7IB142-QCIQDAvBfabvxG5EPdLzodpYQJ5zubXWAC71HaM-FSyV_l1g%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/mp4; codecs=\"avc1.4d401e\"","bitrate":998809,"width":854,"height":480,"initRange":{"start":"0","end":"740"},"indexRange":{"start":"741","end":"2308"},"lastModified":"1724964616614986","contentLength":"20918173","quality":"large","fps":25,"qualityLabel":"480p","projectionType":"RECTANGULAR","averageBitrate":237841,"approxDurationMs":"703600","parsedContentLength":"19.95 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-15T05:56:54.986Z"},{"itag":244,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=244&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=25963840&dur=703.600&lmt=1724965005814578&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIhAPEs0y5cwTUwcTZ_wR7ZWfJdHU9pzg9igwafukaeHQMtAiAXtiUmkOyTuud5CqZR-SMP2xOW6n-WWt0HNj_t7XTUdA%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/webm; codecs=\"vp9\"","bitrate":771445,"width":854,"height":480,"initRange":{"start":"0","end":"219"},"indexRange":{"start":"220","end":"2439"},"lastModified":"1724965005814578","contentLength":"25963840","quality":"large","fps":25,"qualityLabel":"480p","projectionType":"RECTANGULAR","averageBitrate":295211,"approxDurationMs":"703600","parsedContentLength":"24.76 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-19T18:03:34.578Z"},{"itag":134,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=134&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=13747195&dur=703.600&lmt=1724964615550237&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIgEOAQxUoA26jbbzpiUhpWMg0O0OdI2RaSJ9g1GJVVukYCIBaHQyhyd2w2wkiBhxiUh0rKMG5fGOYWCufNPyu-TjjN&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/mp4; codecs=\"avc1.4d401e\"","bitrate":574931,"width":640,"height":360,"initRange":{"start":"0","end":"740"},"indexRange":{"start":"741","end":"2308"},"lastModified":"1724964615550237","contentLength":"13747195","quality":"medium","fps":25,"qualityLabel":"360p","projectionType":"RECTANGULAR","averageBitrate":156306,"approxDurationMs":"703600","parsedContentLength":"13.11 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-15T05:39:10.237Z","highReplication":true},{"itag":243,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=243&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=17109471&dur=703.600&lmt=1724965011192770&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIhALcoWlMagHrEt84cEJfOSwl6IDMeGm8nK-YIzhm2ehTJAiBtV_CCgQ93Bx4l_TjvxAT7Hyv_vxtfu0OK1mdIJ30d_Q%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/webm; codecs=\"vp9\"","bitrate":416725,"width":640,"height":360,"initRange":{"start":"0","end":"219"},"indexRange":{"start":"220","end":"2389"},"lastModified":"1724965011192770","contentLength":"17109471","quality":"medium","fps":25,"qualityLabel":"360p","projectionType":"RECTANGULAR","averageBitrate":194536,"approxDurationMs":"703600","parsedContentLength":"16.32 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-19T19:33:12.770Z"},{"itag":133,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=133&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=7302791&dur=703.600&lmt=1724964616910813&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgEZKztCbr37gSkJaYQFP9scpaWbDOA5uaBaGiLI9frgICIQD9Trs5ajSxFFECfEgNU2nCRS6wEjrd6iuZYtcyLPiExQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/mp4; codecs=\"avc1.4d4015\"","bitrate":264095,"width":426,"height":240,"initRange":{"start":"0","end":"739"},"indexRange":{"start":"740","end":"2307"},"lastModified":"1724964616910813","contentLength":"7302791","quality":"small","fps":25,"qualityLabel":"240p","projectionType":"RECTANGULAR","averageBitrate":83033,"approxDurationMs":"703600","parsedContentLength":"6.96 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-15T06:01:50.813Z"},{"itag":242,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=242&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=9796934&dur=703.600&lmt=1724964994201450&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgM0n3YJTvcxwC3GHwAIl35uq9ZmcnpoQFg5ffo_0FAo8CIQCVmOYE1Judv1mfAdDeUHwfkIOoBHzxcXca3I01kz2tIA%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/webm; codecs=\"vp9\"","bitrate":226901,"width":426,"height":240,"initRange":{"start":"0","end":"218"},"indexRange":{"start":"219","end":"2385"},"lastModified":"1724964994201450","contentLength":"9796934","quality":"small","fps":25,"qualityLabel":"240p","projectionType":"RECTANGULAR","averageBitrate":111392,"approxDurationMs":"703600","parsedContentLength":"9.34 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-19T14:50:01.450Z"},{"itag":160,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=160&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fmp4&rqh=1&gir=yes&clen=4408649&dur=703.600&lmt=1724964615276870&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgFx2RkP_DhySuvyDtOuL3sQwx7dcgrG7CQqGcfCt7Qg8CIQCX7PoCaB9dgsMdTsCOeT1Q9F4KG-KwUlOn08pPiM8EaA%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/mp4; codecs=\"avc1.4d400c\"","bitrate":108929,"width":256,"height":144,"initRange":{"start":"0","end":"738"},"indexRange":{"start":"739","end":"2306"},"lastModified":"1724964615276870","contentLength":"4408649","quality":"tiny","fps":25,"qualityLabel":"144p","projectionType":"RECTANGULAR","averageBitrate":50126,"approxDurationMs":"703600","parsedContentLength":"4.2 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-15T05:34:36.870Z"},{"itag":278,"url":"https://rr1---sn-fpoq-ca9l.googlevideo.com/videoplayback?expire=1727182133&ei=1WDyZoahMKWM6dsP3qHPgQw&ip=151.82.249.76&id=o-ANh3_4noZDjF8Pjrd-fOJF64u3XR6UXUrQBnI6nMmtGH&itag=278&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=Dt&mm=31%2C29&mn=sn-fpoq-ca9l%2Csn-hpa7knle&ms=au%2Crdu&mv=m&mvi=1&pl=19&initcwndbps=1168750&bui=AXLXGFT6IwRcCk7DaGEUPfx-oh6iNlbrRdZevMdUXHeB5Gb6yV4OUdFHyQ-8zYMXi6fFVFxVf9GVsFSZ&vprv=1&mime=video%2Fwebm&rqh=1&gir=yes&clen=6722602&dur=703.600&lmt=1724964991407489&mt=1727160066&fvip=3&keepalive=yes&fexp=51299151&c=ANDROID_CREATOR&txp=5535434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cbui%2Cvprv%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRgIhAPmsmGw8VECDgDFjxvniJfJukMJHBzJvD1u9DwIdSexBAiEA_1vVz8SQNGHFzh_qbiKsn7-TdOt3T87cmJbaX3_JJbY%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRgIhAOWqvWP_W9FtJbmuvkOvkDXhi1T1DWNyK5G1fybCdAklAiEAz4m9Oj23flgjujmv0FHvD_yQ7bOvCIMclc4jiSZvV5A%3D","mimeType":"video/webm; codecs=\"vp9\"","bitrate":97309,"width":256,"height":144,"initRange":{"start":"0","end":"218"},"indexRange":{"start":"219","end":"2384"},"lastModified":"1724964991407489","contentLength":"6722602","quality":"tiny","fps":25,"qualityLabel":"144p","projectionType":"RECTANGULAR","averageBitrate":76436,"approxDurationMs":"703600","parsedContentLength":"6.41 MiB","lengthSeconds":"704","parsedLastModified":"+056631-12-19T14:03:27.489Z"}]}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","type","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"too_big","maximum":11,"type":"string","inclusive":true,"exact":true,"message":"String must contain exactly 11 character(s)","path":["videoId"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/files/audio/{videoId}":{"get":{"summary":"Get audio files list","operationId":"getAudioFilesList","description":"This endpoint retrieves a list of audio files for a specified YouTube video.","tags":["Files"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","minLength":11,"maxLength":11,"description":"The YouTube video ID","example":"dQw4w9WgXcQ"},"required":true,"name":"videoId","in":"path"},{"schema":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AN","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BM","BN","BO","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","EU","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","ST","SV","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"],"description":"Instructs the API to return results as if the request was made from a specific country. ISO 3166 alpha-2 country code."},"required":false,"description":"Instructs the API to return results as if the request was made from a specific country. ISO 3166 alpha-2 country code.","name":"regionCode","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"itag":{"type":"integer","exclusiveMinimum":0,"description":"The itag of the audio format"},"url":{"type":"string","format":"uri","description":"The URL of the audio file"},"mimeType":{"type":"string","description":"The MIME type of the audio file"},"bitrate":{"type":"integer","exclusiveMinimum":0,"description":"The bitrate of the audio in bits per second"},"initRange":{"type":"object","properties":{"start":{"type":"string","description":"The start byte of the initialization range"},"end":{"type":"string","description":"The end byte of the initialization range"}},"required":["start","end"],"description":"The initialization range for the audio file"},"indexRange":{"type":"object","properties":{"start":{"type":"string","description":"The start byte of the index range"},"end":{"type":"string","description":"The end byte of the index range"}},"required":["start","end"],"description":"The index range for the audio file"},"lastModified":{"type":"string","description":"The last modified timestamp of the audio file"},"contentLength":{"type":"string","description":"The content length of the audio file in bytes"},"quality":{"type":"string","description":"The quality label of the audio"},"projectionType":{"type":"string","description":"The projection type of the audio"},"averageBitrate":{"type":"integer","exclusiveMinimum":0,"description":"The average bitrate of the audio in bits per second"},"audioQuality":{"type":"string","description":"The audio quality label"},"approxDurationMs":{"type":"string","description":"The approximate duration of the audio in milliseconds"},"audioSampleRate":{"type":"string","description":"The audio sample rate"},"audioChannels":{"type":"integer","exclusiveMinimum":0,"description":"The number of audio channels"},"parsedContentLength":{"type":"string","description":"The parsed content length in a human-readable format"},"lengthSeconds":{"type":"string","description":"The length of the audio in seconds"},"parsedLastModified":{"type":"string","description":"The parsed last modified date in ISO 8601 format"},"highReplication":{"type":"boolean","description":"Indicates if the audio has high replication"}},"required":["itag","url","mimeType","bitrate","initRange","indexRange","lastModified","contentLength","quality","projectionType","averageBitrate","audioQuality","approxDurationMs","audioSampleRate","audioChannels","parsedContentLength","lengthSeconds","parsedLastModified"]},"description":"List of available audio files","example":[{"itag":139,"url":"https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=139&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=1295035&dur=212.183&lmt=1717047826596234&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgWMJorIvdLaJa5oqpWV2xWTAuk1sV8oTZ1wjj0TeXq6gCIQCc0aP2FLhIo6RzJJTNQZQs5HSHpoG2h5Xv3gTQ0Bn8RQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D","mimeType":"audio/mp4; codecs=\"mp4a.40.5\"","bitrate":50079,"initRange":{"start":"0","end":"731"},"indexRange":{"start":"732","end":"1027"},"lastModified":"1717047826596234","contentLength":"1295035","quality":"tiny","projectionType":"RECTANGULAR","averageBitrate":48827,"audioQuality":"AUDIO_QUALITY_LOW","approxDurationMs":"212183","audioSampleRate":"22050","audioChannels":2,"parsedContentLength":"1.24 MiB","lengthSeconds":"212","parsedLastModified":"2024-05-30T05:43:46.596Z"},{"itag":140,"url":"https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=140&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fmp4&rqh=1&gir=yes&clen=3433605&dur=212.091&lmt=1717047821006373&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIga0ETV3wIzfWxNuu_lGfcvjsfUXpH8E-WIyji7IufSAMCICJcXNhLSWKt7P7r6FRQIwWeui_BseZ7jSYCAf6esbDh&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D","mimeType":"audio/mp4; codecs=\"mp4a.40.2\"","bitrate":130675,"initRange":{"start":"0","end":"722"},"indexRange":{"start":"723","end":"1018"},"lastModified":"1717047821006373","contentLength":"3433605","quality":"tiny","projectionType":"RECTANGULAR","averageBitrate":129514,"highReplication":true,"audioQuality":"AUDIO_QUALITY_MEDIUM","approxDurationMs":"212091","audioSampleRate":"44100","audioChannels":2,"parsedContentLength":"3.27 MiB","lengthSeconds":"212","parsedLastModified":"2024-05-30T05:43:41.006Z"},{"itag":249,"url":"https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=249&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1232413&dur=212.061&lmt=1717047819209140&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgT1IgHRdP6_0ejnZKkTKrWFF3UWNbYA4N9MNbKOQQJL4CIQDu5ccVYqi0UDWjx3vm9IXdnutM514_3yRrzqczVavudQ%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D","mimeType":"audio/webm; codecs=\"opus\"","bitrate":49668,"initRange":{"start":"0","end":"265"},"indexRange":{"start":"266","end":"635"},"lastModified":"1717047819209140","contentLength":"1232413","quality":"tiny","projectionType":"RECTANGULAR","averageBitrate":46492,"audioQuality":"AUDIO_QUALITY_LOW","approxDurationMs":"212061","audioSampleRate":"48000","audioChannels":2,"parsedContentLength":"1.18 MiB","lengthSeconds":"212","parsedLastModified":"2024-05-30T05:43:39.209Z"},{"itag":250,"url":"https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=250&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=1630086&dur=212.061&lmt=1717047822840442&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRQIgI4Vwy12m6UidKdL0SqCi5G7nbKx1UAXev-TObNRRlGICIQDA0SL6AnZEqhpvypdLKdwR2QtcsUZQSVk-exV4Z10Vaw%3D%3D&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D","mimeType":"audio/webm; codecs=\"opus\"","bitrate":65984,"initRange":{"start":"0","end":"265"},"indexRange":{"start":"266","end":"636"},"lastModified":"1717047822840442","contentLength":"1630086","quality":"tiny","projectionType":"RECTANGULAR","averageBitrate":61494,"audioQuality":"AUDIO_QUALITY_LOW","approxDurationMs":"212061","audioSampleRate":"48000","audioChannels":2,"parsedContentLength":"1.55 MiB","lengthSeconds":"212","parsedLastModified":"2024-05-30T05:43:42.840Z"},{"itag":251,"url":"https://rr1---sn-8vq54voxpu-925e.googlevideo.com/videoplayback?expire=1727179901&ei=HVjyZoX0DraCi9oPuJLFyAI&ip=31.26.138.243&id=o-AGFdx643g1zp1pVHAn6l5PANXDz8Nvmg7DncE_45cMM6&itag=251&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&mh=7c&mm=31%2C29&mn=sn-8vq54voxpu-925e%2Csn-hpa7zns6&ms=au%2Crdu&mv=m&mvi=1&pl=21&initcwndbps=1255000&vprv=1&svpuc=1&mime=audio%2Fwebm&rqh=1&gir=yes&clen=3437753&dur=212.061&lmt=1717047822556748&mt=1727157900&fvip=2&keepalive=yes&c=ANDROID_TESTSUITE&txp=4532434&sparams=expire%2Cei%2Cip%2Cid%2Citag%2Csource%2Crequiressl%2Cxpc%2Cvprv%2Csvpuc%2Cmime%2Crqh%2Cgir%2Cclen%2Cdur%2Clmt&sig=AJfQdSswRAIgPQ-Q-5PkH0mnKI6pXIOEj7f_qrvovoGY7VCh8F4M7ZQCIGy0TOgdwKUHiE3xi0Jm8VqfgUXpQ9TlSSZtk4xXHdcV&lsparams=mh%2Cmm%2Cmn%2Cms%2Cmv%2Cmvi%2Cpl%2Cinitcwndbps&lsig=ABPmVW0wRQIhALudieGQmoIh_qLTgz_EaXn6q9wm5H7WjebX_se0h7RUAiBSsjkCUszwNDJH4RTT4nHrhSy_BFuKV4TuG7ll5go6_A%3D%3D","mimeType":"audio/webm; codecs=\"opus\"","bitrate":136946,"initRange":{"start":"0","end":"265"},"indexRange":{"start":"266","end":"636"},"lastModified":"1717047822556748","contentLength":"3437753","quality":"tiny","projectionType":"RECTANGULAR","averageBitrate":129689,"audioQuality":"AUDIO_QUALITY_MEDIUM","approxDurationMs":"212061","audioSampleRate":"48000","audioChannels":2,"parsedContentLength":"3.28 MiB","lengthSeconds":"212","parsedLastModified":"2024-05-30T05:43:42.556Z"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","type","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"too_big","maximum":11,"type":"string","inclusive":true,"exact":true,"message":"String must contain exactly 11 character(s)","path":["videoId"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/files/captions/{videoId}":{"get":{"summary":"Get captions files list","operationId":"getCaptionsFilesList","description":"This endpoint retrieves a list of caption files for a specified YouTube video.","tags":["Files"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","minLength":11,"maxLength":11,"description":"The YouTube video ID","example":"dQw4w9WgXcQ"},"required":true,"name":"videoId","in":"path"},{"schema":{"type":"string","enum":["en","es","de","fr","ja","pt","tr","it","fa","nl","af","am","ar","as","az","be","bg","bn","bs","ca","cs","da","el","en-GB","en-IN","es-419","es-US","et","eu","fi","fil","fr-CA","gl","gu","hi","hr","hu","hy","id","is","iw","ka","kk","km","kn","ko","ky","lo","lt","lv","mk","ml","mn","mr","ms","my","no","ne","or","pa","pl","pt-PT","ro","ru","si","sk","sl","sq","sr-Latn","sr","sv","sw","ta","te","th","uk","ur","uz","vi","zh-CN","zh-HK","zh-TW","zh-Hans","zu","en-US","zh-Hant","zh","yue"],"description":"The language code of the caption","example":"en"},"required":false,"name":"lang","in":"query"},{"schema":{"type":"string","enum":["json","text","csv","xml","srt","vtt","ttml","srv1","srv2","srv3","json3"],"description":"Filters the response to a specific formats","example":"json"},"required":false,"name":"format","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"languageCode":{"type":"string","description":"The language code of the caption"},"languageName":{"type":"string","description":"The language name of the caption"},"format":{"type":"string","description":"The format of the caption file"},"url":{"type":"string","format":"uri","description":"The YouTube URL of the caption file"},"staticUrl":{"type":"string","format":"uri","description":"The static URL of the caption file"}},"required":["languageCode","languageName","format"]},"description":"List of available caption files"},"example":[{"languageName":"English (auto-generated)","languageCode":"en","format":"srt","url":"https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=TncaZ9mBPNDUi9oPstrKMA&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1729812927&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=481102AD541057C440C43FEB9EF8C1A891FEE386.161E910A7414D7DCB17A69617860A6DEA6F0CCBB&key=yt8&kind=asr&lang=en&fmt=srt","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=srt&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"vtt","url":"https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=TncaZ9mBPNDUi9oPstrKMA&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1729812927&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=481102AD541057C440C43FEB9EF8C1A891FEE386.161E910A7414D7DCB17A69617860A6DEA6F0CCBB&key=yt8&kind=asr&lang=en&fmt=vtt","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=vtt&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"ttml","url":"https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=TncaZ9mBPNDUi9oPstrKMA&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1729812927&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=481102AD541057C440C43FEB9EF8C1A891FEE386.161E910A7414D7DCB17A69617860A6DEA6F0CCBB&key=yt8&kind=asr&lang=en&fmt=ttml","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=ttml&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"srv1","url":"https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=TncaZ9mBPNDUi9oPstrKMA&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1729812927&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=481102AD541057C440C43FEB9EF8C1A891FEE386.161E910A7414D7DCB17A69617860A6DEA6F0CCBB&key=yt8&kind=asr&lang=en&fmt=srv1","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=srv1&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"srv2","url":"https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=TncaZ9mBPNDUi9oPstrKMA&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1729812927&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=481102AD541057C440C43FEB9EF8C1A891FEE386.161E910A7414D7DCB17A69617860A6DEA6F0CCBB&key=yt8&kind=asr&lang=en&fmt=srv2","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=srv2&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"srv3","url":"https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=TncaZ9mBPNDUi9oPstrKMA&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1729812927&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=481102AD541057C440C43FEB9EF8C1A891FEE386.161E910A7414D7DCB17A69617860A6DEA6F0CCBB&key=yt8&kind=asr&lang=en&fmt=srv3","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=srv3&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"json3","url":"https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=TncaZ9mBPNDUi9oPstrKMA&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1729812927&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=481102AD541057C440C43FEB9EF8C1A891FEE386.161E910A7414D7DCB17A69617860A6DEA6F0CCBB&key=yt8&kind=asr&lang=en&fmt=json3","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=json3&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"json","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=json&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"xml","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=xml&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"csv","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=csv&lang=en"},{"languageName":"English (auto-generated)","languageCode":"en","format":"text","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=text&lang=en"},{"languageName":"Spanish (translated)","languageCode":"es","format":"json","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=json&lang=es"},{"languageName":"Spanish (translated)","languageCode":"es","format":"xml","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=xml&lang=es"},{"languageName":"Spanish (translated)","languageCode":"es","format":"csv","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=csv&lang=es"},{"languageName":"Spanish (translated)","languageCode":"es","format":"text","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=text&lang=es"},{"languageName":"Spanish (translated)","languageCode":"es","format":"srt","staticUrl":"https://api.poix.io/captions/dQw4w9WgXcQ?format=srt&lang=es"}]}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","type","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"too_big","maximum":11,"type":"string","inclusive":true,"exact":true,"message":"String must contain exactly 11 character(s)","path":["videoId"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/files/thumbnails/{videoId}":{"get":{"summary":"Get thumbnails files list","operationId":"getThumbnailsFilesList","description":"This endpoint retrieves a list of thumbnail files for a specified YouTube video.","tags":["Files"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","minLength":11,"maxLength":11,"description":"The YouTube video ID","example":"dQw4w9WgXcQ"},"required":true,"name":"videoId","in":"path"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"The URL of the thumbnail image"},"width":{"type":"integer","exclusiveMinimum":0,"description":"The width of the thumbnail image"},"height":{"type":"integer","exclusiveMinimum":0,"description":"The height of the thumbnail image"}},"required":["url","width","height"]},"description":"List of available thumbnail files"},"example":[{"id":"default","width":120,"height":90,"format":"webp","ratio":"4:3","url":"https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/default.webp"},{"id":"medium","width":320,"height":180,"format":"webp","ratio":"16:9","url":"https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/mqdefault.webp"},{"id":"high","width":480,"height":360,"format":"webp","ratio":"4:3","url":"https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/hqdefault.webp"},{"id":"standard","width":640,"height":480,"format":"webp","ratio":"4:3","url":"https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/sddefault.webp"},{"id":"maxres","width":1280,"height":720,"format":"webp","ratio":"16:9","url":"https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp"},{"id":"default","width":120,"height":90,"format":"jpg","ratio":"4:3","url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg"},{"id":"medium","width":320,"height":180,"format":"jpg","ratio":"16:9","url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg"},{"id":"high","width":480,"height":360,"format":"jpg","ratio":"4:3","url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg"},{"id":"standard","width":640,"height":480,"format":"jpg","ratio":"4:3","url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg"},{"id":"maxres","width":1280,"height":720,"format":"jpg","ratio":"16:9","url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"}]}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","type","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"too_big","maximum":11,"type":"string","inclusive":true,"exact":true,"message":"String must contain exactly 11 character(s)","path":["videoId"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/commentThreads":{"get":{"summary":"Get comment threads","operationId":"getVideoCommentThreads","description":"Retrieve comment threads for a specified video, channel, or comment.","tags":["General"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","minLength":11,"maxLength":11,"description":"The YouTube video ID to get comment threads for. This is a unique 11-character string.","example":"dQw4w9WgXcQ"},"required":false,"description":"The YouTube video ID to get comment threads for. This is a unique 11-character string.","name":"videoId","in":"query"},{"schema":{"type":"string","minLength":24,"maxLength":24,"description":"The YouTube channel ID to get comment threads for. This is a unique 24-character string.","example":"UCuAXFkgsw1L7xaCfnd5JJOw"},"required":false,"description":"The YouTube channel ID to get comment threads for. This is a unique 24-character string.","name":"channelId","in":"query"},{"schema":{"type":"string","description":"The list of comment IDs to get threads for. Use this to retrieve replies to a comments.","example":"UgzarqjaaPC7TbFINNx4AaABAg"},"required":false,"description":"The list of comment IDs to get threads for. Use this to retrieve replies to a comments.","name":"commentIds","in":"query"},{"schema":{"type":"string","description":"The page token to retrieve the next page of comment threads. This token is provided in the `nextPageToken` field of the previous response."},"required":false,"description":"The page token to retrieve the next page of comment threads. This token is provided in the `nextPageToken` field of the previous response.","name":"pageToken","in":"query"},{"schema":{"type":"string","description":"A search term to filter comment threads. Only threads containing this term will be returned.","example":"great video"},"required":false,"description":"A search term to filter comment threads. Only threads containing this term will be returned.","name":"searchTerm","in":"query"},{"schema":{"type":"string","enum":["time","relevance"],"description":"The order to sort comment threads by. \"time\" sorts by newest first, \"relevance\" sorts by most relevant first.","example":"time"},"required":false,"description":"The order to sort comment threads by. \"time\" sorts by newest first, \"relevance\" sorts by most relevant first.","name":"order","in":"query"},{"schema":{"type":"string","enum":["html","plainText"],"default":"html","description":"The format to return comments in. \"html\" includes HTML formatting, \"plainText\" returns unformatted text."},"required":false,"description":"The format to return comments in. \"html\" includes HTML formatting, \"plainText\" returns unformatted text.","name":"format","in":"query"},{"schema":{"type":"string","description":"The maximum number of comment threads to return. The default is 100, and the maximum is 100."},"required":false,"description":"The maximum number of comment threads to return. The default is 100, and the maximum is 100.","name":"maxResults","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"nextPageToken":{"type":"string","description":"Token to retrieve the next page of results, if available"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the comment thread"},"channelId":{"type":"string","description":"ID of the channel the comment thread is associated with"},"videoId":{"type":"string","description":"ID of the video the comment thread is associated with"},"textDisplay":{"type":"string","description":"The comment's text with HTML formatting"},"textOriginal":{"type":"string","description":"The comment's original text without formatting"},"authorDisplayName":{"type":"string","description":"Display name of the comment author"},"authorProfileImageUrl":{"type":"string","description":"URL of the author's profile image"},"authorChannelUrl":{"type":"string","description":"URL of the author's YouTube channel"},"authorChannelId":{"type":"object","properties":{"value":{"type":"string","description":"The channel ID of the comment author"}},"required":["value"]},"canRate":{"type":"boolean","description":"Whether the authenticated user can rate this comment"},"viewerRating":{"type":"string","description":"The rating given by the authenticated user, if any"},"likeCount":{"type":"number","description":"Number of likes for this comment"},"publishedAt":{"type":"string","description":"The date and time when this comment was published"},"updatedAt":{"type":"string","description":"The date and time when this comment was last updated"},"totalReplyCount":{"type":"number","description":"Total number of replies to this comment"},"replies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the reply"},"channelId":{"type":"string","description":"ID of the channel the reply is associated with"},"videoId":{"type":"string","description":"ID of the video the reply is associated with"},"textDisplay":{"type":"string","description":"The comment's text with HTML formatting"},"textOriginal":{"type":"string","description":"The comment's original text without formatting"},"parentId":{"type":"string","description":"ID of the parent comment"},"authorDisplayName":{"type":"string","description":"Display name of the comment author"},"authorProfileImageUrl":{"type":"string","description":"URL of the author's profile image"},"authorChannelUrl":{"type":"string","description":"URL of the author's YouTube channel"},"authorChannelId":{"type":"object","properties":{"value":{"type":"string","description":"The channel ID of the comment author"}},"required":["value"]},"canRate":{"type":"boolean","description":"Whether the authenticated user can rate this comment"},"viewerRating":{"type":"string","description":"The rating given by the authenticated user, if any"},"likeCount":{"type":"number","description":"Number of likes for this comment"},"publishedAt":{"type":"string","description":"The date and time when this comment was published"},"updatedAt":{"type":"string","description":"The date and time when this comment was last updated"}},"required":["id","channelId","videoId","textDisplay","textOriginal","parentId","authorDisplayName","authorProfileImageUrl","authorChannelUrl","authorChannelId","canRate","viewerRating","likeCount","publishedAt","updatedAt"]},"minItems":0,"description":"Array of reply objects, if any"}},"required":["id","channelId","videoId","textDisplay","textOriginal","authorDisplayName","authorProfileImageUrl","authorChannelUrl","authorChannelId","canRate","viewerRating","likeCount","publishedAt","updatedAt","totalReplyCount"]},"description":"Array of comment thread objects"}},"required":["data"]},"example":{"nextPageToken":"Z2V0X25ld2VzdF9maXJzdC0tQ2dnSWdBUVZGN2ZST0JJRkNJZ2dHQUFTQlFpb0lCZ0FFZ1VJaVNBWUFCSUZDSWNnR0FBU0JRaWRJQmdCR0FBaURnb01DTVdUeTdjR0VLRFE0SjBC","data":[{"id":"UgzarqjaaPC7TbFINNx4AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"1 BILLION views for Never Gonna Give You Up!  Amazing, crazy, wonderful! Rick ♥️","textOriginal":"1 BILLION views for Never Gonna Give You Up!  Amazing, crazy, wonderful! Rick ♥️","authorDisplayName":"@RickAstleyYT","authorProfileImageUrl":"https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@RickAstleyYT","authorChannelId":{"value":"UCuAXFkgsw1L7xaCfnd5JJOw"},"canRate":true,"viewerRating":"none","likeCount":1404600,"publishedAt":"2021-07-28T21:00:32Z","updatedAt":"2021-07-28T21:00:32Z","totalReplyCount":750,"replies":[{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9Xt-Bv-i","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"🧏","textOriginal":"🧏","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@25mxfu","authorProfileImageUrl":"https://yt3.ggpht.com/eFMdry0aqPatgKf2a4fruwImpjDabWq3FhhI22cv2EaZZ7fFlT1_VIzwag6ix9nfKclvsEpw4w=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@25mxfu","authorChannelId":{"value":"UCNk7c5zOVZH3ep7S0lJOrPQ"},"canRate":true,"viewerRating":"none","likeCount":144865,"publishedAt":"2021-07-28T21:00:45Z","updatedAt":"2024-02-18T20:14:21Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9Y00WCrh","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"You are the king of memes","textOriginal":"You are the king of memes","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@RememberRonSherman","authorProfileImageUrl":"https://yt3.ggpht.com/VVrv3SZ2WS9k_u-pGoIdMjU0hmwBR-gYLMFRX9jc_mCBtNs42IcMCJSVQfJyna6nHrN8smpGYD0=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@RememberRonSherman","authorChannelId":{"value":"UCvrLrfv5QOVbocZFxEIsWXg"},"canRate":true,"viewerRating":"none","likeCount":96555,"publishedAt":"2021-07-28T21:00:47Z","updatedAt":"2021-07-28T21:01:59Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9YYj-kTm","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"If you are seeing this you probably got rickrolled 😔","textOriginal":"If you are seeing this you probably got rickrolled 😔","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@mune1","authorProfileImageUrl":"https://yt3.ggpht.com/_dF2uIfWc72vCTMdCB4jOWRpTfhJmx0FOPtusBhJu6IwuF-jJ6PKYarlcRp-4oS2ic_XAQyRPQ=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@mune1","authorChannelId":{"value":"UCpelf0uhG-_eRnaPl-G7_lA"},"canRate":true,"viewerRating":"none","likeCount":70229,"publishedAt":"2021-07-28T21:00:51Z","updatedAt":"2021-08-09T06:06:58Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9YghC1wE","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"Rick&#39;d","textOriginal":"Rick'd","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@aliale161","authorProfileImageUrl":"https://yt3.ggpht.com/ytc/AIdro_k2y9Y93UgTWST5dVa5h_YXvCUn427wn4yeAA-ZuKo=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@aliale161","authorChannelId":{"value":"UCefA8r7E0qTfvCerb18C82g"},"canRate":true,"viewerRating":"none","likeCount":40331,"publishedAt":"2021-07-28T21:00:52Z","updatedAt":"2021-09-28T02:10:03Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9YnKUTOD","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"1 BILLION BABY!","textOriginal":"1 BILLION BABY!","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@ZerakimSC2","authorProfileImageUrl":"https://yt3.ggpht.com/ytc/AIdro_mRZVaPjSfLd3303hsE_jXA3Sp30ZQ4RkcsFTKGLPskGg=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@ZerakimSC2","authorChannelId":{"value":"UCzXc-QELHzOMohBhsCjxzxA"},"canRate":true,"viewerRating":"none","likeCount":36519,"publishedAt":"2021-07-28T21:00:53Z","updatedAt":"2021-07-28T21:00:53Z"}]},{"id":"UgydjT4M9GRaOeaxBvt4AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"No way my school program had  a button  that I clicked 100 times give me a link to this 💀","textOriginal":"No way my school program had  a button  that I clicked 100 times give me a link to this 💀","authorDisplayName":"@ShadowDreamed","authorProfileImageUrl":"https://yt3.ggpht.com/FH8VFS_k4QVx6qMUVUhoEDWDuzlIU-awGBV2xqvzrabpSYfCPl-VS9CCT-9kEh1Bit_JjUtmxg=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@ShadowDreamed","authorChannelId":{"value":"UCT4E8RSd3QMUT53w8yWE-lg"},"canRate":true,"viewerRating":"none","likeCount":0,"publishedAt":"2024-09-24T14:58:13Z","updatedAt":"2024-09-24T14:58:13Z","totalReplyCount":0},{"id":"Ugy1Zun8eh2Y1cbbuq14AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"Ko je preveo neka lajka","textOriginal":"Ko je preveo neka lajka","authorDisplayName":"@NevenaAntonic-jy4wc","authorProfileImageUrl":"https://yt3.ggpht.com/QMHUnRfpJAlUKAnCGavuBtttceA-a7OW1_KWgeKfpgYst61NvJufSlIisJmU1Ez4Z8Aqzo0aHQ=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@NevenaAntonic-jy4wc","authorChannelId":{"value":"UCMkBeAaKxaRna_RVpLNoC5w"},"canRate":true,"viewerRating":"none","likeCount":0,"publishedAt":"2024-09-24T14:52:42Z","updatedAt":"2024-09-24T14:52:42Z","totalReplyCount":0},{"id":"UgycpikRoe5J6J6YtK14AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"Anyone in September 2011 ??","textOriginal":"Anyone in September 2011 ??","authorDisplayName":"@kartikrausa9524","authorProfileImageUrl":"https://yt3.ggpht.com/VCSTeRoY_PRdQQbMLWKpVraDEtYxoLCdxG2XQI3IjLWvHIuiXnZnQiDx1Ov3t91NUOuT4dhW=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@kartikrausa9524","authorChannelId":{"value":"UCvMNrkUaPGeFSQhSnpPmeJg"},"canRate":true,"viewerRating":"none","likeCount":1,"publishedAt":"2024-09-24T14:50:45Z","updatedAt":"2024-09-24T14:50:45Z","totalReplyCount":0},{"id":"Ugxq7VnnGsSsBXBTlUV4AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"So this is Postal III thought it was worse but this is a banger thanks RWS. PS: I regert nothing!","textOriginal":"So this is Postal III thought it was worse but this is a banger thanks RWS. PS: I regert nothing!","authorDisplayName":"@RealDataHolmes","authorProfileImageUrl":"https://yt3.ggpht.com/vsC10MF2AV-lpNgbFKPLuuuSvz69_iZb-CQSaUGAD6jk-ktiLACtFdrmA0K1BQNFrWD_g83TXxw=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@RealDataHolmes","authorChannelId":{"value":"UCXRGzjWpdi9TeYBrFmcI6hA"},"canRate":true,"viewerRating":"none","likeCount":0,"publishedAt":"2024-09-24T14:36:48Z","updatedAt":"2024-09-24T14:36:48Z","totalReplyCount":0},{"id":"UgzadDqHRmOIN6RbEn14AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"BAAAAH I GOOGLED LENSED IT NOOOOO","textOriginal":"BAAAAH I GOOGLED LENSED IT NOOOOO","authorDisplayName":"@DemestryFox","authorProfileImageUrl":"https://yt3.ggpht.com/oqyk8dgh9YH7BqvEJyNndMRHV7uQILHdVbRX5y6HkAd8SgmlGdYIapjHdOtZ8KYfoWxsOBFTlsk=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@DemestryFox","authorChannelId":{"value":"UCtAF0yh7s452KNakEwofjYQ"},"canRate":true,"viewerRating":"none","likeCount":0,"publishedAt":"2024-09-24T14:30:07Z","updatedAt":"2024-09-24T14:30:07Z","totalReplyCount":0},{"id":"UgxMBv9QsQFr1GViGKl4AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"now I am subscribe for you<br>this video song is very nice<br>you so singing","textOriginal":"now I am subscribe for you\nthis video song is very nice\nyou so singing","authorDisplayName":"@ur.philistine","authorProfileImageUrl":"https://yt3.ggpht.com/HJA6OfByTezDL7mSRgiPtxdKFE0L_H9pIoWBzMZbB2v20MxLggmDzkMUso90TiLIxg9td4yj5A=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@ur.philistine","authorChannelId":{"value":"UCJgTq0_vltZYdeWpAPY-Hqg"},"canRate":true,"viewerRating":"none","likeCount":0,"publishedAt":"2024-09-24T14:24:07Z","updatedAt":"2024-09-24T14:24:07Z","totalReplyCount":0},{"id":"UgyvD0rQrsOOnI6fov14AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"I just got rick rolled","textOriginal":"I just got rick rolled","authorDisplayName":"@Kirupro820","authorProfileImageUrl":"https://yt3.ggpht.com/zUI6d1sQ88m7N03r97S2H5FKdURcAVzLk_Hbi8qgaPhJlucNO9yzcytXv_3lnh5ER1XGiIkO=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@Kirupro820","authorChannelId":{"value":"UCZ4OjZUJgcs7e4OHbBASklQ"},"canRate":true,"viewerRating":"none","likeCount":0,"publishedAt":"2024-09-24T14:20:10Z","updatedAt":"2024-09-24T14:20:10Z","totalReplyCount":1,"replies":[{"id":"UgyvD0rQrsOOnI6fov14AaABAg.A8lu1Zj0sz9A8luO81913D","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"Fr","textOriginal":"Fr","parentId":"UgyvD0rQrsOOnI6fov14AaABAg","authorDisplayName":"@SH_511YT","authorProfileImageUrl":"https://yt3.ggpht.com/A7zR3TIO9OXytoBMg9V_krrH_5jtFY6M7nznLO7c88cpF-_Pi2itbkSttj-ogD4f26EE7MEXm6E=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@SH_511YT","authorChannelId":{"value":"UCfD0aVnGi089uX64uJy84Ag"},"canRate":true,"viewerRating":"none","likeCount":0,"publishedAt":"2024-09-24T14:23:15Z","updatedAt":"2024-09-24T14:23:15Z"}]},{"id":"UgzywJ71KwwDqzjwgpN4AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"Кто тоже с пинтереста?","textOriginal":"Кто тоже с пинтереста?","authorDisplayName":"@РоманБел-э6е","authorProfileImageUrl":"https://yt3.ggpht.com/ytc/AIdro_mLp_RGINKBSTO7UmyXia_g0_TP34B7TwdE0IrvgvvBAKMUUg4Mp9bwf4-tb7ElqKcsUfw=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@%D0%A0%D0%BE%D0%BC%D0%B0%D0%BD%D0%91%D0%B5%D0%BB-%D1%8D6%D0%B5","authorChannelId":{"value":"UC2DcSaaO7Nhbhn0d_GpxPiw"},"canRate":true,"viewerRating":"none","likeCount":0,"publishedAt":"2024-09-24T14:17:30Z","updatedAt":"2024-09-24T14:17:30Z","totalReplyCount":0},{"id":"UgxjU1Mu1PYTQTfBMS94AaABAg","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"They said it was free Robux","textOriginal":"They said it was free Robux","authorDisplayName":"@Rossdoestuff","authorProfileImageUrl":"https://yt3.ggpht.com/7A98h5d1Yh87Kf_dQ50ZPikAPMHe7ZjkFwuBlMnGDXVNaIM6MpNEobuHcIRbxWVReKNp866lXQ=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@Rossdoestuff","authorChannelId":{"value":"UCSj4Azj-uVkjrE4ZswTMgdQ"},"canRate":true,"viewerRating":"none","likeCount":1,"publishedAt":"2024-09-24T14:16:37Z","updatedAt":"2024-09-24T14:16:37Z","totalReplyCount":1,"replies":[{"id":"UgxjU1Mu1PYTQTfBMS94AaABAg.A8ltc_hd2CLA8lvFuICxC2","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","videoId":"dQw4w9WgXcQ","textDisplay":"HAHAHAHAHA😭😭","textOriginal":"HAHAHAHAHA😭😭","parentId":"UgxjU1Mu1PYTQTfBMS94AaABAg","authorDisplayName":"@princ3ss_dalia","authorProfileImageUrl":"https://yt3.ggpht.com/A5lEPCErGs7m5maVHLWqIu416QTB2jwHn2Qkc2VtmTYRzF27Nh86OlH3e4yjzUNkz2J4i0z0pw=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@princ3ss_dalia","authorChannelId":{"value":"UCJjl7szsSdAoMh_GdbCdhYw"},"canRate":true,"viewerRating":"none","likeCount":0,"publishedAt":"2024-09-24T14:30:52Z","updatedAt":"2024-09-24T14:30:52Z"}]}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","type","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"too_big","maximum":11,"type":"string","inclusive":true,"exact":true,"message":"String must contain exactly 11 character(s)","path":["videoId"]},{"code":"custom","message":"Only one of 'videoId', 'channelId', or 'commentId' must be provided","path":["videoId","channelId","commentId"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/commentReplies":{"get":{"summary":"Get comment replies","operationId":"getVideoCommentThreads","description":"Get replies for a specific comment","tags":["General"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","description":"The comment ID to get replies for"},"required":true,"description":"The comment ID to get replies for","name":"parentCommentId","in":"query"},{"schema":{"type":"string","description":"The page token to get the next page of comment threads if available"},"required":false,"description":"The page token to get the next page of comment threads if available","name":"pageToken","in":"query"},{"schema":{"type":"string","enum":["html","plainText"],"default":"html","description":"The format to return comments in"},"required":false,"description":"The format to return comments in","name":"format","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"nextPageToken":{"type":"string","description":"Token to retrieve the next page of results, if available."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique ID of the comment thread."},"channelId":{"type":"string","description":"The ID of the channel that owns the comment thread."},"videoId":{"type":"string","description":"The ID of the video the comment thread is associated with."},"textDisplay":{"type":"string","description":"The text of the comment displayed to the user."},"textOriginal":{"type":"string","description":"The original text of the comment, without formatting."},"authorDisplayName":{"type":"string","description":"The display name of the comment author."},"authorProfileImageUrl":{"type":"string","description":"The URL of the author’s profile image."},"authorChannelUrl":{"type":"string","description":"The URL of the author’s channel."},"authorChannelId":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]},"canRate":{"type":"boolean","description":"Indicates if the comment can be rated by the viewer."},"viewerRating":{"type":"string","description":"The rating given by the viewer, if applicable."},"likeCount":{"type":"number","description":"The number of likes the comment has received."},"publishedAt":{"type":"string","description":"The date and time when the comment was published."},"updatedAt":{"type":"string","description":"The date and time when the comment was last updated."},"totalReplyCount":{"type":"number","description":"The total number of replies to this comment."},"replies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique ID of the reply."},"channelId":{"type":"string","description":"The ID of the channel that owns the reply."},"videoId":{"type":"string","description":"The ID of the video the reply is associated with."},"textDisplay":{"type":"string","description":"The text of the reply displayed to the user."},"textOriginal":{"type":"string","description":"The original text of the reply, without formatting."},"parentId":{"type":"string","description":"The ID of the parent comment this reply is associated with."},"authorDisplayName":{"type":"string","description":"The display name of the reply author."},"authorProfileImageUrl":{"type":"string","description":"The URL of the author’s profile image."},"authorChannelUrl":{"type":"string","description":"The URL of the author’s channel."},"authorChannelId":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]},"canRate":{"type":"boolean","description":"Indicates if the reply can be rated by the viewer."},"viewerRating":{"type":"string","description":"The rating given by the viewer, if applicable."},"likeCount":{"type":"number","description":"The number of likes the reply has received."},"publishedAt":{"type":"string","description":"The date and time when the reply was published."},"updatedAt":{"type":"string","description":"The date and time when the reply was last updated."}},"required":["id","channelId","videoId","textDisplay","textOriginal","parentId","authorDisplayName","authorProfileImageUrl","authorChannelUrl","authorChannelId","canRate","viewerRating","likeCount","publishedAt","updatedAt"]},"description":"An array of replies to the comment, if available."}},"required":["id","channelId","videoId","textDisplay","textOriginal","authorDisplayName","authorProfileImageUrl","authorChannelUrl","authorChannelId","canRate","viewerRating","likeCount","publishedAt","updatedAt","totalReplyCount"]},"description":"Array of comment thread objects."}},"required":["data"]},"example":{"nextPageToken":"Z2V0X2NvbW1lbnRfd2l0aF9yZXBsaWVzX3N0cmVhbS0tQ2dnSWdBUVZGN2ZST0JJRkNLQWdHQUVZQUNJTkNnc0lpWXVIaUFZUWdJRzlNUQ==","data":[{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9Xt-Bv-i","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"🧏","textOriginal":"🧏","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@25mxfu","authorProfileImageUrl":"https://yt3.ggpht.com/eFMdry0aqPatgKf2a4fruwImpjDabWq3FhhI22cv2EaZZ7fFlT1_VIzwag6ix9nfKclvsEpw4w=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@25mxfu","authorChannelId":{"value":"UCNk7c5zOVZH3ep7S0lJOrPQ"},"canRate":true,"viewerRating":"none","likeCount":144865,"publishedAt":"2021-07-28T21:00:45Z","updatedAt":"2024-02-18T20:14:21Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9Y00WCrh","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"You are the king of memes","textOriginal":"You are the king of memes","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@RememberRonSherman","authorProfileImageUrl":"https://yt3.ggpht.com/VVrv3SZ2WS9k_u-pGoIdMjU0hmwBR-gYLMFRX9jc_mCBtNs42IcMCJSVQfJyna6nHrN8smpGYD0=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@RememberRonSherman","authorChannelId":{"value":"UCvrLrfv5QOVbocZFxEIsWXg"},"canRate":true,"viewerRating":"none","likeCount":96555,"publishedAt":"2021-07-28T21:00:47Z","updatedAt":"2021-07-28T21:01:59Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9YYj-kTm","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"If you are seeing this you probably got rickrolled 😔","textOriginal":"If you are seeing this you probably got rickrolled 😔","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@mune1","authorProfileImageUrl":"https://yt3.ggpht.com/_dF2uIfWc72vCTMdCB4jOWRpTfhJmx0FOPtusBhJu6IwuF-jJ6PKYarlcRp-4oS2ic_XAQyRPQ=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@mune1","authorChannelId":{"value":"UCpelf0uhG-_eRnaPl-G7_lA"},"canRate":true,"viewerRating":"none","likeCount":70229,"publishedAt":"2021-07-28T21:00:51Z","updatedAt":"2021-08-09T06:06:58Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9YghC1wE","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"Rick&#39;d","textOriginal":"Rick'd","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@aliale161","authorProfileImageUrl":"https://yt3.ggpht.com/ytc/AIdro_k2y9Y93UgTWST5dVa5h_YXvCUn427wn4yeAA-ZuKo=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@aliale161","authorChannelId":{"value":"UCefA8r7E0qTfvCerb18C82g"},"canRate":true,"viewerRating":"none","likeCount":40331,"publishedAt":"2021-07-28T21:00:52Z","updatedAt":"2021-09-28T02:10:03Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9YnKUTOD","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"1 BILLION BABY!","textOriginal":"1 BILLION BABY!","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@ZerakimSC2","authorProfileImageUrl":"https://yt3.ggpht.com/ytc/AIdro_mRZVaPjSfLd3303hsE_jXA3Sp30ZQ4RkcsFTKGLPskGg=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@ZerakimSC2","authorChannelId":{"value":"UCzXc-QELHzOMohBhsCjxzxA"},"canRate":true,"viewerRating":"none","likeCount":36519,"publishedAt":"2021-07-28T21:00:53Z","updatedAt":"2021-07-28T21:00:53Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9YrMhOkO","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"This video is the reason I&#39;m afraid of clicking links.","textOriginal":"This video is the reason I'm afraid of clicking links.","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@RememberRonSherman","authorProfileImageUrl":"https://yt3.ggpht.com/VVrv3SZ2WS9k_u-pGoIdMjU0hmwBR-gYLMFRX9jc_mCBtNs42IcMCJSVQfJyna6nHrN8smpGYD0=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@RememberRonSherman","authorChannelId":{"value":"UCvrLrfv5QOVbocZFxEIsWXg"},"canRate":true,"viewerRating":"none","likeCount":34223,"publishedAt":"2021-07-28T21:00:53Z","updatedAt":"2021-07-29T21:52:27Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9Yv5lnLT","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"Fun Fact:<br><br><br><br>‎<br>‎","textOriginal":"Fun Fact:\n\n\n\n‎\n‎","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@DVFT","authorProfileImageUrl":"https://yt3.ggpht.com/EqUTseldaGYsrjJ1lOyF7rfheMqA4E_xWDBiMm9XwJzz53reic2Sh5CFiYgQBzyb__BCg-WSg6w=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@DVFT","authorChannelId":{"value":"UCLy-mLFHwnj0XPZ4WSy_Png"},"canRate":true,"viewerRating":"none","likeCount":37434,"publishedAt":"2021-07-28T21:00:54Z","updatedAt":"2021-08-18T02:24:01Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9Z69KVBw","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"Yo","textOriginal":"Yo","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@cryux3691","authorProfileImageUrl":"https://yt3.ggpht.com/ncsmqv4uwzN2nqY4fi5rfhMk3lDhLugk-mlLgBlN__HCpnIUl5KcwbDRof0DCiPaL7rvkgFsJQ=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@cryux3691","authorChannelId":{"value":"UCPu8bfAuRMYoRY-etrYXDSQ"},"canRate":true,"viewerRating":"none","likeCount":17589,"publishedAt":"2021-07-28T21:00:55Z","updatedAt":"2021-07-28T21:00:55Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9Z9m-U5E","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"YOO BIG FAN HERE!<br><br> congratulations Rick, you are a legend!!!","textOriginal":"YOO BIG FAN HERE!\n\n congratulations Rick, you are a legend!!!","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@jrxjared1621","authorProfileImageUrl":"https://yt3.ggpht.com/qWhmNbauFJpBbzmoRRfQNl-1QbZ7n3f5Ilk8V8WHLtfUTRs2EBUUmGk-tiQHNojorH-WZZkrVRw=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@jrxjared1621","authorChannelId":{"value":"UCx1FNk_r2k48qj5Zf1ZVPhA"},"canRate":true,"viewerRating":"none","likeCount":17486,"publishedAt":"2021-07-28T21:00:56Z","updatedAt":"2023-03-18T16:37:50Z"},{"id":"UgzarqjaaPC7TbFINNx4AaABAg.9QM9WCCnud69QM9ZEcqG-W","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","textDisplay":"RICK!!!!","textOriginal":"RICK!!!!","parentId":"UgzarqjaaPC7TbFINNx4AaABAg","authorDisplayName":"@5StarEric","authorProfileImageUrl":"https://yt3.ggpht.com/wPn01NlSu6wIEioGvAHrQqM_B2tH7PHVgdbLXYwnGqTBkBeAyxKLeHcNCHjk4g3202mkXlKF4QY=s48-c-k-c0x00ffffff-no-rj","authorChannelUrl":"http://www.youtube.com/@5StarEric","authorChannelId":{"value":"UCEKdrPmLZQyLpTSvUBGU7_Q"},"canRate":true,"viewerRating":"none","likeCount":12194,"publishedAt":"2021-07-28T21:00:57Z","updatedAt":"2021-07-28T21:00:57Z"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","type","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"too_big","maximum":11,"type":"string","inclusive":true,"exact":true,"message":"String must contain exactly 11 character(s)","path":["videoId"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/search":{"get":{"summary":"Get search results","operationId":"getSearchResults","description":"This endpoint retrieves search results based on the provided query parameters.","tags":["Search"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","description":"Specifies the query term to search for. \n\n Your request can also use the Boolean NOT (-) and OR (|) operators to exclude videos or to find videos that are associated with one of several search terms. For example, to search for videos matching either \"boating\" or \"sailing\", set the **q** parameter value to **boating|sailing**. Similarly, to search for videos matching either \"boating\" or \"sailing\" but not \"fishing\", set the **q** parameter value to **boating|sailing -fishing**. Note that the pipe character must be URL-escaped when it is sent in your API request. The URL-escaped value for the pipe character is **%7C**."},"required":false,"description":"Specifies the query term to search for. \n\n Your request can also use the Boolean NOT (-) and OR (|) operators to exclude videos or to find videos that are associated with one of several search terms. For example, to search for videos matching either \"boating\" or \"sailing\", set the **q** parameter value to **boating|sailing**. Similarly, to search for videos matching either \"boating\" or \"sailing\" but not \"fishing\", set the **q** parameter value to **boating|sailing -fishing**. Note that the pipe character must be URL-escaped when it is sent in your API request. The URL-escaped value for the pipe character is **%7C**.","name":"q","in":"query"},{"schema":{"type":"string","minLength":24,"maxLength":24,"pattern":"^UC","description":"Indicates that the API response should only contain resources created by the channel."},"required":false,"description":"Indicates that the API response should only contain resources created by the channel.","name":"channelId","in":"query"},{"schema":{"type":"string","enum":["any","show","channelTypeUnspecified"],"description":"Lets you restrict a search to a particular type of channel."},"required":false,"description":"Lets you restrict a search to a particular type of channel.","name":"channelType","in":"query"},{"schema":{"type":"string","default":"50","description":"Specifies the maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive."},"required":false,"description":"Specifies the maximum number of items that should be returned in the result set. Acceptable values are 0 to 50, inclusive.","name":"maxResults","in":"query"},{"schema":{"type":"string","enum":["searchSortUnspecified","date","rating","relevance","title","videoCount","viewCount"],"default":"relevance","description":"Specifies the method that will be used to order resources in the API response."},"required":false,"description":"Specifies the method that will be used to order resources in the API response.","name":"order","in":"query"},{"schema":{"type":"string","description":"Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved."},"required":false,"description":"Identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.","name":"pageToken","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$","description":"Indicates that the API response should only contain resources created at or after the specified time. The value is an RFC 3339 formatted date-time value (1970-01-01T00:00:00Z)."},"required":false,"description":"Indicates that the API response should only contain resources created at or after the specified time. The value is an RFC 3339 formatted date-time value (1970-01-01T00:00:00Z).","name":"publishedAfter","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$","description":"Indicates that the API response should only contain resources created before or at the specified time. The value is an RFC 3339 formatted date-time value (1970-01-01T00:00:00Z)."},"required":false,"description":"Indicates that the API response should only contain resources created before or at the specified time. The value is an RFC 3339 formatted date-time value (1970-01-01T00:00:00Z).","name":"publishedBefore","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":2,"description":"Instructs the API to return search results for videos that can be viewed in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code."},"required":false,"description":"Instructs the API to return search results for videos that can be viewed in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code.","name":"regionCode","in":"query"},{"schema":{"type":"string","description":"Instructs the API to return search results that are most relevant to the specified language. The parameter value is typically an ISO 639-1 two-letter language code."},"required":false,"description":"Instructs the API to return search results that are most relevant to the specified language. The parameter value is typically an ISO 639-1 two-letter language code.","name":"relevanceLanguage","in":"query"},{"schema":{"type":"string","enum":["moderate","none","strict","safeSearchSettingUnspecified"],"default":"moderate","description":"Indicates whether the search results should include restricted content as well as standard content."},"required":false,"description":"Indicates whether the search results should include restricted content as well as standard content.","name":"safeSearch","in":"query"},{"schema":{"type":"string","enum":["/m/04rlf","/m/02mscn","/m/0ggq0m","/m/01lyv","/m/02lkt","/m/0glt670","/m/05rwpb","/m/03_d0","/m/028sqc","/m/0g293","/m/064t9","/m/06cqb","/m/06j6l","/m/06by7","/m/0gywn","/m/0bzvm2","/m/025zzc","/m/02ntfj","/m/0b1vjn","/m/02hygl","/m/04q1x3q","/m/01sjng","/m/0403l3g","/m/021bp2","/m/022dc6","/m/03hf_rm","/m/06ntj","/m/0jm_","/m/018jz","/m/018w8","/m/01cgz","/m/09xp_","/m/02vx4","/m/037hz","/m/03tmr","/m/01h7lh","/m/0410tth","/m/07bs0","/m/07_53","/m/02jjt","/m/09kqc","/m/02vxn","/m/05qjc","/m/066wd","/m/0f2f9","/m/019_rr","/m/032tl","/m/027x7n","/m/02wbm","/m/03glg","/m/068hy","/m/041xxh","/m/07c1v","/m/07bxq","/m/07yv9","/m/098wr","/m/09s1f","/m/0kt51","/m/01h6rj","/m/05qt0","/m/06bvp","/m/01k8wb"],"description":"Indicates that the API response should only contain resources associated with the specified topic. The value identifies a Freebase topic ID."},"required":false,"description":"Indicates that the API response should only contain resources associated with the specified topic. The value identifies a Freebase topic ID.","name":"topicId","in":"query"},{"schema":{"type":"string","pattern":"^(video|channel|playlist)(,(video|channel|playlist))*$","default":"video,channel,playlist","description":"Restricts a search query to only retrieve a particular type of resource. The value is a comma-separated list of resource types. The default value is video,channel,playlist."},"required":false,"description":"Restricts a search query to only retrieve a particular type of resource. The value is a comma-separated list of resource types. The default value is video,channel,playlist.","name":"type","in":"query"},{"schema":{"type":"string","enum":["completed","live","upcoming","none"],"description":"Restricts a search to broadcast events. If you specify a value for this parameter, you must also set the type parameter's value to video."},"required":false,"description":"Restricts a search to broadcast events. If you specify a value for this parameter, you must also set the type parameter's value to video.","name":"eventType","in":"query"},{"schema":{"type":"string","description":"In conjunction with the locationRadius parameter, defines a circular geographic area and also restricts a search to videos that specify, in their metadata, a geographic location that falls within that area."},"required":false,"description":"In conjunction with the locationRadius parameter, defines a circular geographic area and also restricts a search to videos that specify, in their metadata, a geographic location that falls within that area.","name":"location","in":"query"},{"schema":{"type":"string","description":"In conjunction with the location parameter, defines a circular geographic area."},"required":false,"description":"In conjunction with the location parameter, defines a circular geographic area.","name":"locationRadius","in":"query"},{"schema":{"type":"string","enum":["any","closedCaption","none","videoCaptionUnspecified"],"description":"Indicates whether the API should filter video search results based on whether they have captions."},"required":false,"description":"Indicates whether the API should filter video search results based on whether they have captions.","name":"videoCaption","in":"query"},{"schema":{"type":"string","enum":["0","1","2","10","15","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44"],"description":"Filters video search results based on their category."},"required":false,"description":"Filters video search results based on their category.","name":"videoCategoryId","in":"query"},{"schema":{"type":"string","enum":["any","high","standard"],"description":"Lets you restrict a search to only include either high definition (HD) or standard definition (SD) videos."},"required":false,"description":"Lets you restrict a search to only include either high definition (HD) or standard definition (SD) videos.","name":"videoDefinition","in":"query"},{"schema":{"type":"string","enum":["2d","3d","any"],"default":"any","description":"Lets you restrict a search to only retrieve 2D or 3D videos."},"required":false,"description":"Lets you restrict a search to only retrieve 2D or 3D videos.","name":"videoDimension","in":"query"},{"schema":{"type":"string","enum":["any","long","medium","short","videoDurationUnspecified"],"default":"any","description":"Filters video search results based on their duration."},"required":false,"description":"Filters video search results based on their duration.","name":"videoDuration","in":"query"},{"schema":{"type":"string","enum":["any","true","videoEmbeddableUnspecified"],"description":"Lets you to restrict a search to only videos that can be embedded into a webpage."},"required":false,"description":"Lets you to restrict a search to only videos that can be embedded into a webpage.","name":"videoEmbeddable","in":"query"},{"schema":{"type":"string","enum":["any","creativeCommon","youtube"],"description":"Filters search results to only include videos with a particular license."},"required":false,"description":"Filters search results to only include videos with a particular license.","name":"videoLicense","in":"query"},{"schema":{"type":"string","enum":["any","true","videoPaidProductPlacementUnspecified"],"description":"Flters search results to only include videos that the creator has denoted as having a paid promotion."},"required":false,"description":"Flters search results to only include videos that the creator has denoted as having a paid promotion.","name":"videoPaidProductPlacement","in":"query"},{"schema":{"type":"string","enum":["any","true","videoSyndicatedUnspecified"],"description":"Lets you to restrict a search to only videos that can be played outside youtube.com."},"required":false,"description":"Lets you to restrict a search to only videos that can be played outside youtube.com.","name":"videoSyndicated","in":"query"},{"schema":{"type":"string","enum":["any","episode","movie","videoTypeUnspecified"],"description":"Lets you restrict a search to a particular type of videos."},"required":false,"description":"Lets you restrict a search to a particular type of videos.","name":"videoType","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"nextPageToken":{"type":"string","description":"Token to retrieve the next page of results, if available"},"prevPageToken":{"type":"string","description":"Token to retrieve the previous page of results, if available"},"regionCode":{"type":"string","description":"The region code that was used for the search."},"totalResults":{"type":"number","description":"The total number of results in the result set."},"resultsPerPage":{"type":"number","description":"The number of results included in the API response."},"data":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","description":"The type of resource returned."},"videoId":{"type":"string","description":"The unique ID of the video."},"publishedAt":{"type":"string","description":"The date and time when the video was published."},"publishTime":{"type":"string","description":"The time the video was published."},"title":{"type":"string","description":"The title of the video."},"description":{"type":"string","description":"The description of the video."},"channelId":{"type":"string","description":"The ID of the channel that owns the video."},"channelTitle":{"type":"string","description":"The title of the channel that owns the video."},"liveBroadcastContent":{"type":"string","description":"Indicates if the video is a live broadcast."},"thumbnails":{"type":"object","additionalProperties":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]},"description":"The thumbnails for the video, available in different sizes."}},"required":["kind","videoId","publishedAt","publishTime","title","description","channelId","channelTitle","liveBroadcastContent","thumbnails"]},"description":"Array of search result objects."}},"required":["regionCode","totalResults","resultsPerPage","data"]},"example":{"regionCode":"US","totalResults":1000000,"resultsPerPage":5,"nextPageToken":"CAUQAA","data":[{"kind":"youtube#video","videoId":"2zmX1cKsu7o","publishedAt":"2024-09-23T19:03:49Z","channelId":"UCwU_XmppMy9R9k4YJET7R6w","title":"CRAZY HEAVY Surf BEFORE Beach CLOSED!  |  RAW Video","description":"September 4, 2024 unleashed a raging Noreaster that made for some ugly, but crazy heavy waves. In true fashion, the boys sent it ...","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/2zmX1cKsu7o/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/2zmX1cKsu7o/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/2zmX1cKsu7o/hqdefault.jpg","width":480,"height":360}},"channelTitle":"Brett Barley","liveBroadcastContent":"none","publishTime":"2024-09-23T19:03:49Z"},{"kind":"youtube#video","videoId":"Oygw2a_C1B0","publishedAt":"2024-09-24T08:30:50Z","channelId":"UCoicMEw3njXscfwHlaAJVcQ","title":"SURFING A NEW BOARD IN CLEAN BEACH BREAK WAVES! (RAW POV)","description":"Join me as I surf on my NEW surfboard at 3 different spots! I scored some CLEAN beach break waves around home Business ...","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/Oygw2a_C1B0/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/Oygw2a_C1B0/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/Oygw2a_C1B0/hqdefault.jpg","width":480,"height":360}},"channelTitle":"Surfing With Noz","liveBroadcastContent":"none","publishTime":"2024-09-24T08:30:50Z"},{"kind":"youtube#video","videoId":"l0B4vVn57pA","publishedAt":"2024-07-22T18:43:36Z","channelId":"UCfwsgnjLrzTWbWc3pOsg6xw","title":"Pop-Up Progression #surf #surfing","description":"","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/l0B4vVn57pA/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/l0B4vVn57pA/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/l0B4vVn57pA/hqdefault.jpg","width":480,"height":360}},"channelTitle":"Hydro Mind","liveBroadcastContent":"none","publishTime":"2024-07-22T18:43:36Z"},{"kind":"youtube#video","videoId":"I_74QSTwg-U","publishedAt":"2024-09-23T19:40:00Z","channelId":"UC6uX6GF5q2JxLjMkyivM2Og","title":"RETURN THE GURGLE SLAB!","description":"YOUTUBE VIDS CONTINUE WEEKLY AS ALWAYS MY FRIENDS PLEASE SUBSCRIBE to help SUPPORT the channel!","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/I_74QSTwg-U/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/I_74QSTwg-U/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/I_74QSTwg-U/hqdefault.jpg","width":480,"height":360}},"channelTitle":"Nathan Florence","liveBroadcastContent":"none","publishTime":"2024-09-23T19:40:00Z"},{"kind":"youtube#video","videoId":"ma67yOdMQfs","publishedAt":"2021-01-23T17:00:15Z","channelId":"UC--3c8RqSfAqYBdDjIG3UNA","title":"These Were The All-Time Surfing Moments Of The Year | Best Of 2020","description":"Well, that was a weird ride. Though it hasn't been easy, at least when we fixed our gaze on the ocean — or favorite place in the ...","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/ma67yOdMQfs/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/ma67yOdMQfs/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/ma67yOdMQfs/hqdefault.jpg","width":480,"height":360}},"channelTitle":"Red Bull Surfing","liveBroadcastContent":"none","publishTime":"2021-01-23T17:00:15Z"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"custom","message":"The 'type' property must be set to 'video' when using video-specific parameters","path":["type"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/batch/videos":{"post":{"summary":"Get batch videos","operationId":"getBatchVideos","description":"Retrieve up to 1000 videos data based on IDs","tags":["Batch"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","enum":["en","es","de","fr","ja","pt","tr","it","fa","nl","af","am","ar","as","az","be","bg","bn","bs","ca","cs","da","el","en-GB","en-IN","es-419","es-US","et","eu","fi","fil","fr-CA","gl","gu","hi","hr","hu","hy","id","is","iw","ka","kk","km","kn","ko","ky","lo","lt","lv","mk","ml","mn","mr","ms","my","no","ne","or","pa","pl","pt-PT","ro","ru","si","sk","sl","sq","sr-Latn","sr","sv","sw","ta","te","th","uk","ur","uz","vi","zh-CN","zh-HK","zh-TW","zh-Hans","zu"],"description":"The language to retrieve localized data in."},"required":false,"description":"The language to retrieve localized data in.","name":"hl","in":"query"},{"schema":{"type":"string","description":"An array of fields to include in the response. If not provided, all fields will be returned."},"required":false,"description":"An array of fields to include in the response. If not provided, all fields will be returned.","name":"fields","in":"query"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","minLength":11,"maxLength":11},"minItems":1,"maxItems":1000,"description":"An array of video IDs to retrieve data for.","example":["dQw4w9WgXcQ","yPYZpwSpKmA","eYuUAGXN0KM","C2xel6q0yao","yBwD4iYcWC4"],"minimum":1,"maximum":1000},"includeLocalizations":{"type":"boolean","description":"Whether to include localized data."}},"required":["ids"],"additionalProperties":false},"example":{"ids":["dQw4w9WgXcQ","yPYZpwSpKmA","eYuUAGXN0KM","C2xel6q0yao","yBwD4iYcWC4"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalResults":{"type":"number","description":"Total number of videos returned."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique ID of the video."},"publishedAt":{"type":"string","description":"The date and time when the video was published."},"channelId":{"type":"string","description":"The ID of the channel that owns the video."},"title":{"type":"string","description":"The title of the video."},"description":{"type":"string","description":"The description of the video."},"thumbnails":{"type":"object","properties":{"default":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]},"medium":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]},"high":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]}},"required":["default","medium","high"],"description":"The thumbnails for the video, available in different sizes."},"channelTitle":{"type":"string","description":"The title of the channel that owns the video."},"tags":{"type":"array","items":{"type":"string"},"description":"An array of tags associated with the video."},"categoryId":{"type":"string","description":"The ID of the category the video belongs to."},"defaultLanguage":{"type":"string","description":"The default language of the video."},"defaultAudioLanguage":{"type":"string","description":"The default audio language of the video."},"viewCount":{"type":"string","description":"The number of views the video has received."},"likeCount":{"type":"string","description":"The number of likes the video has received."},"commentCount":{"type":"string","description":"The number of comments on the video."},"topicCategories":{"type":"array","items":{"type":"string"},"description":"An array of topic categories associated with the video."},"uploadStatus":{"type":"string","description":"The upload status of the video."},"privacyStatus":{"type":"string","description":"The privacy status of the video."},"license":{"type":"string","description":"The license type of the video."},"embeddable":{"type":"boolean","description":"Indicates if the video can be embedded."},"publicStatsViewable":{"type":"boolean","description":"Indicates if the video statistics are publicly viewable."},"madeForKids":{"type":"boolean","description":"Indicates if the video is made for kids."},"hasPaidProductPlacement":{"type":"boolean","description":"Indicates if the video has paid product placement."},"localizations":{"type":"object","additionalProperties":{"type":"object","properties":{"title":{"type":"string","description":"The localized title of the video."},"description":{"type":"string","description":"The localized description of the video."}},"required":["title","description"]},"description":"Localized titles and descriptions for the video."},"categoryTitle":{"type":"string","description":"The title of the category the video belongs to."},"caption":{"type":"boolean","description":"Indicates if the video has captions."},"duration":{"type":"string","description":"The duration of the video."},"parsedDuration":{"type":"number","description":"The parsed duration of the video in seconds."}},"required":["id"]},"description":"Array of video detail objects."}},"required":["totalResults","data"]},"example":{"totalResults":1,"data":[{"id":"dQw4w9WgXcQ","publishedAt":"2009-10-25T06:57:33Z","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","title":"Rick Astley - Never Gonna Give You Up (Official Music Video)","description":"The official video for “Never Gonna Give You Up” by Rick Astley. \n\nThe new album 'Are We There Yet?' is out now: Download here: https://RickAstley.lnk.to/AreWeThereYetFA/itunes\n\n“Never Gonna Give You Up” was a global smash on its release in July 1987, topping the charts in 25 countries including Rick’s native UK and the US Billboard Hot 100.  It also won the Brit Award for Best single in 1988. Stock Aitken and Waterman wrote and produced the track which was the lead-off single and lead track from Rick’s debut LP “Whenever You Need Somebody”.  The album was itself a UK number one and would go on to sell over 15 million copies worldwide.\n\nThe legendary video was directed by Simon West – who later went on to make Hollywood blockbusters such as Con Air, Lara Croft – Tomb Raider and The Expendables 2.  The video passed the 1bn YouTube views milestone on 28 July 2021.\n\nSubscribe to the official Rick Astley YouTube channel: https://RickAstley.lnk.to/YTSubID\n\nFollow Rick Astley:\nFacebook: https://RickAstley.lnk.to/FBFollowID \nTwitter: https://RickAstley.lnk.to/TwitterID \nInstagram: https://RickAstley.lnk.to/InstagramID \nWebsite: https://RickAstley.lnk.to/storeID \nTikTok: https://RickAstley.lnk.to/TikTokID\n\nListen to Rick Astley:\nSpotify: https://RickAstley.lnk.to/SpotifyID \nApple Music: https://RickAstley.lnk.to/AppleMusicID \nAmazon Music: https://RickAstley.lnk.to/AmazonMusicID \nDeezer: https://RickAstley.lnk.to/DeezerID \n\nLyrics:\nWe’re no strangers to love\nYou know the rules and so do I\nA full commitment’s what I’m thinking of\nYou wouldn’t get this from any other guy\n\nI just wanna tell you how I’m feeling\nGotta make you understand\n\nNever gonna give you up\nNever gonna let you down\nNever gonna run around and desert you\nNever gonna make you cry\nNever gonna say goodbye\nNever gonna tell a lie and hurt you\n\nWe’ve known each other for so long\nYour heart’s been aching but you’re too shy to say it\nInside we both know what’s been going on\nWe know the game and we’re gonna play it\n\nAnd if you ask me how I’m feeling\nDon’t tell me you’re too blind to see\n\nNever gonna give you up\nNever gonna let you down\nNever gonna run around and desert you\nNever gonna make you cry\nNever gonna say goodbye\nNever gonna tell a lie and hurt you\n\n#RickAstley #NeverGonnaGiveYouUp #WheneverYouNeedSomebody #OfficialMusicVideo","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg","width":480,"height":360},"standard":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg","width":640,"height":480},"maxres":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg","width":1280,"height":720}},"channelTitle":"Rick Astley","tags":["rick astley","Never Gonna Give You Up","nggyu","never gonna give you up lyrics","rick rolled","Rick Roll","rick astley official","rickrolled","Fortnite song","Fortnite event","Fortnite dance","fortnite never gonna give you up","rick roll","rickrolling","rick rolling","never gonna give you up","80s music","rick astley new","animated video","rickroll","meme songs","never gonna give u up lyrics","Rick Astley 2022","never gonna let you down","animated","rick rolls 2022","never gonna give you up karaoke"],"categoryId":"10","defaultLanguage":"en","defaultAudioLanguage":"en","viewCount":"1575717222","likeCount":"17875159","commentCount":"2359576","topicCategories":["https://en.wikipedia.org/wiki/Electronic_music","https://en.wikipedia.org/wiki/Music","https://en.wikipedia.org/wiki/Pop_music","https://en.wikipedia.org/wiki/Rhythm_and_blues","https://en.wikipedia.org/wiki/Soul_music"],"uploadStatus":"processed","privacyStatus":"public","license":"youtube","embeddable":true,"publicStatsViewable":true,"madeForKids":false,"hasPaidProductPlacement":false,"localizations":{"en":{"title":"Rick Astley - Never Gonna Give You Up (Official Music Video)","description":"The official video for “Never Gonna Give You Up” by Rick Astley. \n\nThe new album 'Are We There Yet?' is out now: Download here: https://RickAstley.lnk.to/AreWeThereYetFA/itunes\n\n“Never Gonna Give You Up” was a global smash on its release in July 1987, topping the charts in 25 countries including Rick’s native UK and the US Billboard Hot 100.  It also won the Brit Award for Best single in 1988. Stock Aitken and Waterman wrote and produced the track which was the lead-off single and lead track from Rick’s debut LP “Whenever You Need Somebody”.  The album was itself a UK number one and would go on to sell over 15 million copies worldwide.\n\nThe legendary video was directed by Simon West – who later went on to make Hollywood blockbusters such as Con Air, Lara Croft – Tomb Raider and The Expendables 2.  The video passed the 1bn YouTube views milestone on 28 July 2021.\n\nSubscribe to the official Rick Astley YouTube channel: https://RickAstley.lnk.to/YTSubID\n\nFollow Rick Astley:\nFacebook: https://RickAstley.lnk.to/FBFollowID \nTwitter: https://RickAstley.lnk.to/TwitterID \nInstagram: https://RickAstley.lnk.to/InstagramID \nWebsite: https://RickAstley.lnk.to/storeID \nTikTok: https://RickAstley.lnk.to/TikTokID\n\nListen to Rick Astley:\nSpotify: https://RickAstley.lnk.to/SpotifyID \nApple Music: https://RickAstley.lnk.to/AppleMusicID \nAmazon Music: https://RickAstley.lnk.to/AmazonMusicID \nDeezer: https://RickAstley.lnk.to/DeezerID \n\nLyrics:\nWe’re no strangers to love\nYou know the rules and so do I\nA full commitment’s what I’m thinking of\nYou wouldn’t get this from any other guy\n\nI just wanna tell you how I’m feeling\nGotta make you understand\n\nNever gonna give you up\nNever gonna let you down\nNever gonna run around and desert you\nNever gonna make you cry\nNever gonna say goodbye\nNever gonna tell a lie and hurt you\n\nWe’ve known each other for so long\nYour heart’s been aching but you’re too shy to say it\nInside we both know what’s been going on\nWe know the game and we’re gonna play it\n\nAnd if you ask me how I’m feeling\nDon’t tell me you’re too blind to see\n\nNever gonna give you up\nNever gonna let you down\nNever gonna run around and desert you\nNever gonna make you cry\nNever gonna say goodbye\nNever gonna tell a lie and hurt you\n\n#RickAstley #NeverGonnaGiveYouUp #WheneverYouNeedSomebody #OfficialMusicVideo"}},"categoryTitle":"Music","duration":"PT3M33S","parsedDuration":213}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}},"received":{"type":"string"},"options":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"received":"subscriberCount","code":"invalid_enum_value","options":["publishedAt","channelId","title","description","thumbnails","channelTitle","tags","categoryId","defaultLanguage","defaultAudioLanguage","viewCount","likeCount","commentCount","topicCategories","uploadStatus","privacyStatus","license","embeddable","publicStatsViewable","madeForKids","hasPaidProductPlacement","localizations","categoryTitle","duration","parsedDuration","caption"],"path":["fields",0],"message":"Invalid enum value. Expected 'publishedAt' | 'channelId' | 'title' | 'description' | 'thumbnails' | 'channelTitle' | 'tags' | 'categoryId' | 'defaultLanguage' | 'defaultAudioLanguage' | 'viewCount' | 'likeCount' | 'commentCount' | 'topicCategories' | 'uploadStatus' | 'privacyStatus' | 'license' | 'embeddable' | 'publicStatsViewable' | 'madeForKids' | 'hasPaidProductPlacement' | 'localizations' | 'categoryTitle' | 'duration' | 'parsedDuration' | 'caption', received 'subscriberCount'"}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/batch/channels":{"post":{"summary":"Get batch channels","operationId":"getBatchChannels","description":"Retrieve data for up to 1000 channels based on their IDs","tags":["Batch"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","enum":["en","es","de","fr","ja","pt","tr","it","fa","nl","af","am","ar","as","az","be","bg","bn","bs","ca","cs","da","el","en-GB","en-IN","es-419","es-US","et","eu","fi","fil","fr-CA","gl","gu","hi","hr","hu","hy","id","is","iw","ka","kk","km","kn","ko","ky","lo","lt","lv","mk","ml","mn","mr","ms","my","no","ne","or","pa","pl","pt-PT","ro","ru","si","sk","sl","sq","sr-Latn","sr","sv","sw","ta","te","th","uk","ur","uz","vi","zh-CN","zh-HK","zh-TW","zh-Hans","zu"],"description":"The language code (e.g., \"en-US\", \"es\") to retrieve localized data in. If not specified, the default language of the channel is used."},"required":false,"description":"The language code (e.g., \"en-US\", \"es\") to retrieve localized data in. If not specified, the default language of the channel is used.","name":"hl","in":"query"},{"schema":{"type":"string","description":"A comma-separated list of fields to include in the response. If not provided, all fields will be returned."},"required":false,"description":"A comma-separated list of fields to include in the response. If not provided, all fields will be returned.","name":"fields","in":"query"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","minLength":24,"maxLength":24},"minItems":1,"maxItems":1000,"description":"An array of channel IDs to retrieve data for. Each ID should be a valid 24-character channel ID. Minimum 1, maximum 1000 IDs."},"includeLocalizations":{"type":"boolean","default":false,"description":"Whether to include localized data for the channel. If `true`, localized fields will be returned in the specified language (`hl` parameter). Default is `false`."}},"required":["ids"],"additionalProperties":false},"example":{"ids":["UCuAXFkgsw1L7xaCfnd5JJOw","UC0C-w0YjGpqDXGB8IHb662A","UCSY5V7BJSrxNvvBF0Drslow","UCBVjMGOIkavEAhyqpxJ73Dw","UCi4EDAgjULwwNBHOg1aaCig"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalResults":{"type":"number","description":"The total number of channels returned"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier for the YouTube channel"},"title":{"type":"string","description":"The channel's title"},"description":{"type":"string","description":"The channel's description"},"keywords":{"type":"string","description":"Comma-separated keywords associated with the channel"},"unsubscribedTrailer":{"type":"string","description":"The ID of the channel's trailer video for unsubscribed viewers"},"country":{"type":"string","description":"The country where the channel is based"},"customUrl":{"type":"string","description":"The custom URL of the channel, if set"},"publishedAt":{"type":"string","description":"The date and time when the channel was created (ISO 8601 format)"},"viewCount":{"type":"string","description":"The number of times the channel has been viewed"},"subscriberCount":{"type":"string","description":"The number of subscribers the channel has"},"hiddenSubscriberCount":{"type":"boolean","description":"Indicates if the channel's subscriber count is publicly visible"},"videoCount":{"type":"string","description":"The number of public videos uploaded to the channel"},"topicIds":{"type":"array","items":{"type":"string"},"description":"A list of topic IDs associated with the channel"},"topicCategories":{"type":"array","items":{"type":"string"},"description":"A list of topic categories associated with the channel"},"relatedPlaylists":{"type":"object","properties":{"likes":{"type":"string","description":"The ID of the playlist containing videos liked by the channel"},"uploads":{"type":"string","description":"The ID of the playlist containing videos uploaded to the channel"}},"required":["likes","uploads"]},"privacyStatus":{"type":"string","description":"The privacy status of the channel (e.g., \"public\", \"private\", \"unlisted\")"},"isLinked":{"type":"boolean","description":"Indicates if the channel is linked to either a YouTube content owner or a YouTube user"},"longUploadsStatus":{"type":"string","description":"The status of the channel for featuring longer videos"},"madeForKids":{"type":"boolean","description":"Indicates if the channel is designated as child-directed and complies with the Children's Online Privacy Protection Act (COPPA)"},"bannerExternalUrl":{"type":"string","description":"The URL of the banner image shown on the channel page on desktop"},"thumbnailUrl":{"type":"string","description":"The URL of the channel's thumbnail image"},"thumbnails":{"type":"object","properties":{"default":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image"},"width":{"type":"number","description":"The width of the thumbnail image in pixels"},"height":{"type":"number","description":"The height of the thumbnail image in pixels"}},"required":["url","width","height"]},"medium":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image"},"width":{"type":"number","description":"The width of the thumbnail image in pixels"},"height":{"type":"number","description":"The height of the thumbnail image in pixels"}},"required":["url","width","height"]},"high":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image"},"width":{"type":"number","description":"The width of the thumbnail image in pixels"},"height":{"type":"number","description":"The height of the thumbnail image in pixels"}},"required":["url","width","height"]}},"required":["default","medium","high"],"description":"An object containing thumbnail images for the channel in different sizes"}},"required":["id"]}}},"required":["totalResults","data"]},"example":{"totalResults":1,"data":[{"id":"UCuAXFkgsw1L7xaCfnd5JJOw","title":"Rick Astley","description":"'Free' Remaster out now!","keywords":"Official Rick Astley \"rick astley\" \"never gonna give you up\" \"the best of me\" \"best of me\" \"together forever\" \"cry for help\" \"beautiful life\" \"official video\" \"official audio\" rickroll rickrolled \"rick roll\" \"rick asltey\" \"give up\" meme","unsubscribedTrailer":"mIHHfNVfhPk","country":"GB","customUrl":"@rickastleyyt","publishedAt":"2015-02-01T16:32:30Z","thumbnails":{"default":{"url":"https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s88-c-k-c0x00ffffff-no-rj","width":88,"height":88},"medium":{"url":"https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s240-c-k-c0x00ffffff-no-rj","width":240,"height":240},"high":{"url":"https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s800-c-k-c0x00ffffff-no-rj","width":800,"height":800}},"viewCount":"2100929381","subscriberCount":"4160000","hiddenSubscriberCount":false,"videoCount":"265","topicIds":["/m/04rlf","/m/0gywn","/m/06by7","/m/064t9"],"topicCategories":["https://en.wikipedia.org/wiki/Music","https://en.wikipedia.org/wiki/Soul_music","https://en.wikipedia.org/wiki/Rock_music","https://en.wikipedia.org/wiki/Pop_music"],"relatedPlaylists":{"likes":"","uploads":"UUuAXFkgsw1L7xaCfnd5JJOw"},"privacyStatus":"public","isLinked":true,"longUploadsStatus":"longUploadsUnspecified","madeForKids":false,"bannerExternalUrl":"https://yt3.googleusercontent.com/KBtTGhBjiM4CD9oUrQke85BALlD1Tt-QFh_AQqzJIQJXFUQt1mtS6jJjIJkQDEbphga9O1Kt","thumbnailUrl":"https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s240-c-k-c0x00ffffff-no-rj"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}},"received":{"type":"string"},"options":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"received":"defaultLanguage","code":"invalid_enum_value","options":["title","description","keywords","country","customUrl","publishedAt","viewCount","subscriberCount","hiddenSubscriberCount","unsubscribedTrailer","videoCount","topicIds","topicCategories","relatedPlaylists","privacyStatus","isLinked","longUploadsStatus","madeForKids","bannerExternalUrl","thumbnailUrl","localizations","thumbnails"],"path":["fields",1],"message":"Invalid enum value. Expected 'title' | 'description' | 'keywords' | 'country' | 'customUrl' | 'publishedAt' | 'viewCount' | 'subscriberCount' | 'hiddenSubscriberCount' | 'unsubscribedTrailer' | 'videoCount' | 'topicIds' | 'topicCategories' | 'relatedPlaylists' | 'privacyStatus' | 'isLinked' | 'longUploadsStatus' | 'madeForKids' | 'bannerExternalUrl' | 'thumbnailUrl' | 'localizations' | 'thumbnails', received 'defaultLanguage'"}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/playlistItems":{"get":{"summary":"Get playlist items","operationId":"getPlaylistItems","description":"Get playlist items by ID, playlist or channel","tags":["Details"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string"},"required":false,"name":"ids","in":"query"},{"schema":{"type":"string","description":"The unique ID of the playlist for which you want to retrieve playlist items"},"required":false,"description":"The unique ID of the playlist for which you want to retrieve playlist items","name":"playlistId","in":"query"},{"schema":{"type":"string","minLength":24,"maxLength":24,"pattern":"^UC","description":"The unique ID of the channel for which you want to retrieve uploads videos"},"required":false,"description":"The unique ID of the channel for which you want to retrieve uploads videos","name":"channelId","in":"query"},{"schema":{"type":"string","minLength":11,"maxLength":11,"description":"The unique ID of the video for which you want to retrieve the playlist items"},"required":false,"description":"The unique ID of the video for which you want to retrieve the playlist items","name":"videoId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"pageToken","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalResults":{"type":"number","description":"Total number of playlist items returned."},"resultsPerPage":{"type":"number","description":"Number of results returned per page."},"nextPageToken":{"type":"string","description":"Token to retrieve the next page of results, if available."},"prevPageToken":{"type":"string","description":"Token to retrieve the previous page of results, if available."},"data":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","description":"The type of resource this item represents."},"videoId":{"type":"string","description":"The unique ID of the video associated with this playlist item."},"id":{"type":"string","description":"The unique ID of the playlist item."},"privacyStatus":{"type":"string","description":"The privacy status of the playlist item (e.g., public, private)."},"videoPublishedAt":{"type":"string","description":"The date and time when the video was published."},"publishedAt":{"type":"string","description":"The date and time when the playlist item was added."},"channelId":{"type":"string","description":"The ID of the channel that owns the video."},"title":{"type":"string","description":"The title of the video."},"description":{"type":"string","description":"The description of the video."},"channelTitle":{"type":"string","description":"The title of the channel that owns the video."},"playlistId":{"type":"string","description":"The ID of the playlist that this item belongs to."},"position":{"type":"number","description":"The position of the video in the playlist."},"videoOwnerChannelTitle":{"type":"string","description":"The title of the channel that owns the video."},"videoOwnerChannelId":{"type":"string","description":"The ID of the channel that owns the video."}},"required":["kind","videoId","id","privacyStatus","videoPublishedAt","publishedAt","channelId","title","description","channelTitle","playlistId","position","videoOwnerChannelTitle","videoOwnerChannelId"]},"description":"Array of playlist item objects."}},"required":["totalResults","resultsPerPage","data"]},"example":{"totalResults":212,"resultsPerPage":50,"nextPageToken":"EAAaelBUOkNHUWlFRGM0TURZd05VSkROamxETmtNeU5UQW9BVWpveU5yMjZlV0hBMUFCV2pZaVEyaG9WbFpYV2pSV1J6RXpUMFJhVjJKVk1WVmpWM2g1VVZkT2VscEhNSGhSVjJOVFEzZHFjVFU1VHpGQ2FFUkJjRTQwY0NJ","prevPageToken":"EAEaelBUOkNESWlFRGhETlVaQlJUWkNNVFkwT0RFelF6Z29BVWpveU5yMjZlV0hBMUFBV2pZaVEyaG9WbFpYV2pSV1J6RXpUMFJhVjJKVk1WVmpWM2g1VVZkT2VscEhNSGhSVjJOVFEzZHFjVFU1VHpGQ2FFUkJjRTQwY0NJ","data":[{"kind":"youtube#video","videoId":"-4hfcRWJMTs","id":"VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLi00aGZjUldKTVRz","privacyStatus":"public","videoPublishedAt":"2021-06-12T07:58:19Z","publishedAt":"2021-06-12T07:58:19Z","channelId":"UCfxTmw86VmMTqlrAcsdm1Ag","title":"player stares death in the face decides to end it","description":"player stares death in the face decides to end it\n\n#warzone","channelTitle":"Always Call of Duty","playlistId":"UUfxTmw86VmMTqlrAcsdm1Ag","position":50,"videoOwnerChannelTitle":"Always Call of Duty","videoOwnerChannelId":"UCfxTmw86VmMTqlrAcsdm1Ag"},{"kind":"youtube#video","videoId":"Q5lU0OLLJGI","id":"VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLlE1bFUwT0xMSkdJ","privacyStatus":"public","videoPublishedAt":"2021-05-31T10:00:28Z","publishedAt":"2021-05-31T10:00:28Z","channelId":"UCfxTmw86VmMTqlrAcsdm1Ag","title":"Call of Duty Black Ops: Cold War RTX 3090 4K | Satelite Gun Game 3rd","description":"Call of Duty Black Ops: Cold War RTX 3090 4K Satelite Gun Game Gameplay\nSatelite - Gun Game - 2021 - 4K - PC\n\n\n\n\n\n\n\n\n\n\n\n\n#CallofDuty #ColdWar #RTX3090","channelTitle":"Always Call of Duty","playlistId":"UUfxTmw86VmMTqlrAcsdm1Ag","position":51,"videoOwnerChannelTitle":"Always Call of Duty","videoOwnerChannelId":"UCfxTmw86VmMTqlrAcsdm1Ag"},{"kind":"youtube#video","videoId":"QHm7Ysbm8Mk","id":"VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLlFIbTdZc2JtOE1r","privacyStatus":"public","videoPublishedAt":"2021-05-31T10:00:27Z","publishedAt":"2021-05-31T10:00:27Z","channelId":"UCfxTmw86VmMTqlrAcsdm1Ag","title":"Call of Duty Ghosts RTX 3090 4K | Siege","description":"Call of Duty Ghosts RTX 3090 4K Siege Gameplay\nSiege - Team Deathmatch - 2021 - 4K - PC\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n#CallofDuty #Ghosts #RTX3090","channelTitle":"Always Call of Duty","playlistId":"UUfxTmw86VmMTqlrAcsdm1Ag","position":52,"videoOwnerChannelTitle":"Always Call of Duty","videoOwnerChannelId":"UCfxTmw86VmMTqlrAcsdm1Ag"},{"kind":"youtube#video","videoId":"vwOSYnlH2XY","id":"VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLnZ3T1NZbmxIMlhZ","privacyStatus":"public","videoPublishedAt":"2021-05-31T10:00:24Z","publishedAt":"2021-05-31T10:00:24Z","channelId":"UCfxTmw86VmMTqlrAcsdm1Ag","title":"Call of Duty World at War RTX 3090 | Airfield  new","description":"Call of Duty World at War RTX 3090 Airfield Gameplay\nAirfield - Team Deathmatch - 2021 - 4K - PC\n\n\n\n\n\n\n\n\n\n\n\n\n\n#RTX3090 #CallofDuty #WorldatWar","channelTitle":"Always Call of Duty","playlistId":"UUfxTmw86VmMTqlrAcsdm1Ag","position":53,"videoOwnerChannelTitle":"Always Call of Duty","videoOwnerChannelId":"UCfxTmw86VmMTqlrAcsdm1Ag"},{"kind":"youtube#video","videoId":"rxvIGm5DmFs","id":"VVVmeFRtdzg2Vm1NVHFsckFjc2RtMUFnLnJ4dklHbTVEbUZz","privacyStatus":"public","videoPublishedAt":"2021-05-31T10:00:17Z","publishedAt":"2021-05-31T10:00:17Z","channelId":"UCfxTmw86VmMTqlrAcsdm1Ag","title":"Call of Duty Black Ops Cold War RTX 3090 4K | Nuketown victory","description":"Call of Duty Black Ops Cold War RTX 3090 4K Nuketown Gameplay\nNuketown - Team Deathmatch - 2021 - 4K - PC\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n#CallofDuty #BlackOps #RTX3090","channelTitle":"Always Call of Duty","playlistId":"UUfxTmw86VmMTqlrAcsdm1Ag","position":54,"videoOwnerChannelTitle":"Always Call of Duty","videoOwnerChannelId":"UCfxTmw86VmMTqlrAcsdm1Ag"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}},"received":{"type":"string"},"options":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"success":false,"error":{"issues":[{"code":"too_big","maximum":24,"type":"string","inclusive":true,"exact":true,"message":"String must contain exactly 24 character(s)","path":["channelId"]}],"name":"ZodError"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/channels":{"get":{"summary":"Get channels details","operationId":"getChannelsDetails","description":"Get details for channels by their IDs, handle, or username.","tags":["Details"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","description":"An array of channel IDs to retrieve data for. Each ID should be a valid channel ID."},"required":false,"description":"An array of channel IDs to retrieve data for. Each ID should be a valid channel ID.","name":"ids","in":"query"},{"schema":{"type":"string","description":"The unique channel handle of the channel for which you want to retrieve data."},"required":false,"description":"The unique channel handle of the channel for which you want to retrieve data.","name":"forHandle","in":"query"},{"schema":{"type":"string","description":"The unique channel username of the channel for which you want to retrieve data. This is the legacy username format."},"required":false,"description":"The unique channel username of the channel for which you want to retrieve data. This is the legacy username format.","name":"forUsername","in":"query"},{"schema":{"type":"string","enum":["en","es","de","fr","ja","pt","tr","it","fa","nl","af","am","ar","as","az","be","bg","bn","bs","ca","cs","da","el","en-GB","en-IN","es-419","es-US","et","eu","fi","fil","fr-CA","gl","gu","hi","hr","hu","hy","id","is","iw","ka","kk","km","kn","ko","ky","lo","lt","lv","mk","ml","mn","mr","ms","my","no","ne","or","pa","pl","pt-PT","ro","ru","si","sk","sl","sq","sr-Latn","sr","sv","sw","ta","te","th","uk","ur","uz","vi","zh-CN","zh-HK","zh-TW","zh-Hans","zu"],"description":"The language to retrieve localized data in. If not specified, the default language will be used."},"required":false,"description":"The language to retrieve localized data in. If not specified, the default language will be used.","name":"hl","in":"query"},{"schema":{"type":"string","description":"An array of fields to include in the response. If not provided, all fields will be returned."},"required":false,"description":"An array of fields to include in the response. If not provided, all fields will be returned.","name":"fields","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalResults":{"type":"number","description":"Total number of channels returned"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier for the YouTube channel"},"title":{"type":"string","description":"The channel's title"},"description":{"type":"string","description":"The channel's description"},"keywords":{"type":"string","description":"Comma-separated keywords associated with the channel"},"unsubscribedTrailer":{"type":"string","description":"The ID of the channel's trailer video for unsubscribed viewers"},"country":{"type":"string","description":"The country where the channel is based"},"customUrl":{"type":"string","description":"The custom URL of the channel, if set"},"publishedAt":{"type":"string","description":"The date and time when the channel was created (ISO 8601 format)"},"viewCount":{"type":"string","description":"The number of times the channel has been viewed"},"subscriberCount":{"type":"string","description":"The number of subscribers the channel has"},"hiddenSubscriberCount":{"type":"boolean","description":"Indicates if the channel's subscriber count is publicly visible"},"videoCount":{"type":"string","description":"The number of public videos uploaded to the channel"},"topicIds":{"type":"array","items":{"type":"string"},"description":"A list of topic IDs associated with the channel"},"topicCategories":{"type":"array","items":{"type":"string"},"description":"A list of topic categories associated with the channel"},"relatedPlaylists":{"type":"object","properties":{"likes":{"type":"string","description":"The ID of the playlist containing videos liked by the channel"},"uploads":{"type":"string","description":"The ID of the playlist containing videos uploaded to the channel"}},"required":["likes","uploads"]},"privacyStatus":{"type":"string","description":"The privacy status of the channel (e.g., \"public\", \"private\", \"unlisted\")"},"isLinked":{"type":"boolean","description":"Indicates if the channel is linked to either a YouTube content owner or a YouTube user"},"longUploadsStatus":{"type":"string","description":"The status of the channel for featuring longer videos"},"madeForKids":{"type":"boolean","description":"Indicates if the channel is designated as child-directed and complies with the Children's Online Privacy Protection Act (COPPA)"},"bannerExternalUrl":{"type":"string","description":"The URL of the banner image shown on the channel page on desktop"},"thumbnailUrl":{"type":"string","description":"The URL of the channel's thumbnail image"},"thumbnails":{"type":"object","properties":{"default":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image"},"width":{"type":"number","description":"The width of the thumbnail image in pixels"},"height":{"type":"number","description":"The height of the thumbnail image in pixels"}},"required":["url","width","height"]},"medium":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image"},"width":{"type":"number","description":"The width of the thumbnail image in pixels"},"height":{"type":"number","description":"The height of the thumbnail image in pixels"}},"required":["url","width","height"]},"high":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image"},"width":{"type":"number","description":"The width of the thumbnail image in pixels"},"height":{"type":"number","description":"The height of the thumbnail image in pixels"}},"required":["url","width","height"]}},"required":["default","medium","high"],"description":"An object containing thumbnail images for the channel in different sizes"}},"required":["id"]},"description":"Array of channel objects"}},"required":["totalResults","data"]},"example":{"totalResults":1,"data":[{"id":"UCuAXFkgsw1L7xaCfnd5JJOw","title":"Rick Astley","description":"'Free' Remaster out now!","keywords":"Official Rick Astley \"rick astley\" \"never gonna give you up\" \"the best of me\" \"best of me\" \"together forever\" \"cry for help\" \"beautiful life\" \"official video\" \"official audio\" rickroll rickrolled \"rick roll\" \"rick asltey\" \"give up\" meme","unsubscribedTrailer":"mIHHfNVfhPk","country":"GB","customUrl":"@rickastleyyt","publishedAt":"2015-02-01T16:32:30Z","thumbnails":{"default":{"url":"https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s88-c-k-c0x00ffffff-no-rj","width":88,"height":88},"medium":{"url":"https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s240-c-k-c0x00ffffff-no-rj","width":240,"height":240},"high":{"url":"https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s800-c-k-c0x00ffffff-no-rj","width":800,"height":800}},"viewCount":"2100929381","subscriberCount":"4160000","hiddenSubscriberCount":false,"videoCount":"265","topicIds":["/m/04rlf","/m/0gywn","/m/06by7","/m/064t9"],"topicCategories":["https://en.wikipedia.org/wiki/Music","https://en.wikipedia.org/wiki/Soul_music","https://en.wikipedia.org/wiki/Rock_music","https://en.wikipedia.org/wiki/Pop_music"],"relatedPlaylists":{"likes":"","uploads":"UUuAXFkgsw1L7xaCfnd5JJOw"},"privacyStatus":"public","isLinked":true,"longUploadsStatus":"longUploadsUnspecified","madeForKids":false,"bannerExternalUrl":"https://yt3.googleusercontent.com/KBtTGhBjiM4CD9oUrQke85BALlD1Tt-QFh_AQqzJIQJXFUQt1mtS6jJjIJkQDEbphga9O1Kt","thumbnailUrl":"https://yt3.ggpht.com/coJBIm7rugfAkdb9_cw5Lry2NDnfSYDjL5MBu_R2st_YCLsZtDxYu28h2EAJzPfY8qudaF8U=s240-c-k-c0x00ffffff-no-rj"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}},"received":{"type":"string"},"options":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"received":"defaultLanguage","code":"invalid_enum_value","options":["title","description","keywords","country","customUrl","publishedAt","viewCount","subscriberCount","hiddenSubscriberCount","unsubscribedTrailer","videoCount","topicIds","topicCategories","relatedPlaylists","privacyStatus","isLinked","longUploadsStatus","madeForKids","bannerExternalUrl","thumbnailUrl","localizations","thumbnails"],"path":["fields",1],"message":"Invalid enum value. Expected 'title' | 'description' | 'keywords' | 'country' | 'customUrl' | 'publishedAt' | 'viewCount' | 'subscriberCount' | 'hiddenSubscriberCount' | 'unsubscribedTrailer' | 'videoCount' | 'topicIds' | 'topicCategories' | 'relatedPlaylists' | 'privacyStatus' | 'isLinked' | 'longUploadsStatus' | 'madeForKids' | 'bannerExternalUrl' | 'thumbnailUrl' | 'localizations' | 'thumbnails', received 'defaultLanguage'"}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/videos":{"get":{"summary":"Get videos details","operationId":"getVideosDetails","description":"Get details for a list of videos.","tags":["Details"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","description":"An array of video IDs to retrieve data for.","minItems":1,"maxItems":50,"items":{"type":"string","minLength":11,"maxLength":11,"example":"dQw4w9WgXcQ"}},"required":true,"name":"ids","in":"query"},{"schema":{"type":"string","enum":["en","es","de","fr","ja","pt","tr","it","fa","nl","af","am","ar","as","az","be","bg","bn","bs","ca","cs","da","el","en-GB","en-IN","es-419","es-US","et","eu","fi","fil","fr-CA","gl","gu","hi","hr","hu","hy","id","is","iw","ka","kk","km","kn","ko","ky","lo","lt","lv","mk","ml","mn","mr","ms","my","no","ne","or","pa","pl","pt-PT","ro","ru","si","sk","sl","sq","sr-Latn","sr","sv","sw","ta","te","th","uk","ur","uz","vi","zh-CN","zh-HK","zh-TW","zh-Hans","zu"],"description":"The language to retrieve localized data in."},"required":false,"description":"The language to retrieve localized data in.","name":"hl","in":"query"},{"schema":{"type":"string","description":"A list of fields to include in the response. If not provided, all fields will be returned.","enum":["id","publishedAt","channelId","title","description","thumbnails","channelTitle","tags","categoryId","defaultLanguage","defaultAudioLanguage","viewCount","likeCount","commentCount","topicCategories","uploadStatus","privacyStatus","license","embeddable","publicStatsViewable","madeForKids","hasPaidProductPlacement","localizations","categoryTitle","duration","parsedDuration","caption","isShort"],"example":"id,title,viewCount,description"},"required":false,"name":"fields","in":"query"},{"schema":{"type":"string","description":"A list of additional fields to include in the response.","example":"isShort","enum":["isShort"]},"required":false,"name":"include","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalResults":{"type":"number","description":"Total number of video details returned."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique ID of the video."},"publishedAt":{"type":"string","description":"The date and time when the video was published."},"channelId":{"type":"string","description":"The ID of the channel that owns the video."},"title":{"type":"string","description":"The title of the video."},"description":{"type":"string","description":"The description of the video."},"thumbnails":{"type":"object","properties":{"default":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]},"medium":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]},"high":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]}},"required":["default","medium","high"],"description":"The thumbnails for the video, available in different sizes."},"channelTitle":{"type":"string","description":"The title of the channel that owns the video."},"tags":{"type":"array","items":{"type":"string"},"description":"An array of tags associated with the video."},"categoryId":{"type":"string","description":"The ID of the category the video belongs to."},"defaultLanguage":{"type":"string","description":"The default language of the video."},"defaultAudioLanguage":{"type":"string","description":"The default audio language of the video."},"viewCount":{"type":"string","description":"The number of views the video has received."},"likeCount":{"type":"string","description":"The number of likes the video has received."},"commentCount":{"type":"string","description":"The number of comments on the video."},"topicCategories":{"type":"array","items":{"type":"string"},"description":"An array of topic categories associated with the video."},"uploadStatus":{"type":"string","description":"The upload status of the video."},"privacyStatus":{"type":"string","description":"The privacy status of the video."},"license":{"type":"string","description":"The license type of the video."},"embeddable":{"type":"boolean","description":"Indicates if the video can be embedded."},"publicStatsViewable":{"type":"boolean","description":"Indicates if the video statistics are publicly viewable."},"madeForKids":{"type":"boolean","description":"Indicates if the video is made for kids."},"hasPaidProductPlacement":{"type":"boolean","description":"Indicates if the video has paid product placement."},"localizations":{"type":"object","additionalProperties":{"type":"object","properties":{"title":{"type":"string","description":"The localized title of the video."},"description":{"type":"string","description":"The localized description of the video."}},"required":["title","description"]},"description":"Localized titles and descriptions for the video."},"categoryTitle":{"type":"string","description":"The title of the category the video belongs to."},"caption":{"type":"boolean","description":"Indicates if the video has captions."},"duration":{"type":"string","description":"The duration of the video."},"parsedDuration":{"type":"number","description":"The parsed duration of the video in seconds."},"isShort":{"type":"boolean","description":"Indicates if the video is short."}},"required":["id"]},"description":"Array of video detail objects."}},"required":["totalResults","data"]},"example":{"totalResults":1,"data":[{"id":"dQw4w9WgXcQ","publishedAt":"2009-10-25T06:57:33Z","channelId":"UCuAXFkgsw1L7xaCfnd5JJOw","title":"Rick Astley - Never Gonna Give You Up (Official Music Video)","description":"The official video for “Never Gonna Give You Up” by Rick Astley. \n\nThe new album 'Are We There Yet?' is out now: Download here: https://RickAstley.lnk.to/AreWeThereYetFA/itunes\n\n“Never Gonna Give You Up” was a global smash on its release in July 1987, topping the charts in 25 countries including Rick’s native UK and the US Billboard Hot 100.  It also won the Brit Award for Best single in 1988. Stock Aitken and Waterman wrote and produced the track which was the lead-off single and lead track from Rick’s debut LP “Whenever You Need Somebody”.  The album was itself a UK number one and would go on to sell over 15 million copies worldwide.\n\nThe legendary video was directed by Simon West – who later went on to make Hollywood blockbusters such as Con Air, Lara Croft – Tomb Raider and The Expendables 2.  The video passed the 1bn YouTube views milestone on 28 July 2021.\n\nSubscribe to the official Rick Astley YouTube channel: https://RickAstley.lnk.to/YTSubID\n\nFollow Rick Astley:\nFacebook: https://RickAstley.lnk.to/FBFollowID \nTwitter: https://RickAstley.lnk.to/TwitterID \nInstagram: https://RickAstley.lnk.to/InstagramID \nWebsite: https://RickAstley.lnk.to/storeID \nTikTok: https://RickAstley.lnk.to/TikTokID\n\nListen to Rick Astley:\nSpotify: https://RickAstley.lnk.to/SpotifyID \nApple Music: https://RickAstley.lnk.to/AppleMusicID \nAmazon Music: https://RickAstley.lnk.to/AmazonMusicID \nDeezer: https://RickAstley.lnk.to/DeezerID \n\nLyrics:\nWe’re no strangers to love\nYou know the rules and so do I\nA full commitment’s what I’m thinking of\nYou wouldn’t get this from any other guy\n\nI just wanna tell you how I’m feeling\nGotta make you understand\n\nNever gonna give you up\nNever gonna let you down\nNever gonna run around and desert you\nNever gonna make you cry\nNever gonna say goodbye\nNever gonna tell a lie and hurt you\n\nWe’ve known each other for so long\nYour heart’s been aching but you’re too shy to say it\nInside we both know what’s been going on\nWe know the game and we’re gonna play it\n\nAnd if you ask me how I’m feeling\nDon’t tell me you’re too blind to see\n\nNever gonna give you up\nNever gonna let you down\nNever gonna run around and desert you\nNever gonna make you cry\nNever gonna say goodbye\nNever gonna tell a lie and hurt you\n\n#RickAstley #NeverGonnaGiveYouUp #WheneverYouNeedSomebody #OfficialMusicVideo","channelTitle":"Rick Astley","categoryId":"10","isShort":false,"defaultLanguage":"en","defaultAudioLanguage":"en","viewCount":"1576236315","likeCount":"17879517","commentCount":"2359970","uploadStatus":"processed","privacyStatus":"public","license":"youtube","embeddable":true,"publicStatsViewable":true,"madeForKids":false,"hasPaidProductPlacement":false,"categoryTitle":"Music","duration":"PT3M33S","parsedDuration":213,"topicCategories":["https://en.wikipedia.org/wiki/Electronic_music","https://en.wikipedia.org/wiki/Music","https://en.wikipedia.org/wiki/Pop_music","https://en.wikipedia.org/wiki/Rhythm_and_blues","https://en.wikipedia.org/wiki/Soul_music"],"tags":["rick astley","Never Gonna Give You Up","nggyu","never gonna give you up lyrics","rick rolled","Rick Roll","rick astley official","rickrolled","Fortnite song","Fortnite event","Fortnite dance","fortnite never gonna give you up","rick roll","rickrolling","rick rolling","never gonna give you up","80s music","rick astley new","animated video","rickroll","meme songs","never gonna give u up lyrics","Rick Astley 2022","never gonna let you down","animated","rick rolls 2022","never gonna give you up karaoke"],"thumbnails":{"default":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg","width":480,"height":360},"standard":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg","width":640,"height":480},"maxres":{"url":"https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg","width":1280,"height":720}}}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}},"received":{"type":"string"},"options":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"received":"subscriberCount","code":"invalid_enum_value","options":["id","publishedAt","channelId","title","description","thumbnails","channelTitle","tags","categoryId","defaultLanguage","defaultAudioLanguage","viewCount","likeCount","commentCount","topicCategories","uploadStatus","privacyStatus","license","embeddable","publicStatsViewable","madeForKids","hasPaidProductPlacement","localizations","categoryTitle","duration","parsedDuration","caption","isShort"],"path":["fields",0],"message":"Invalid enum value. Expected 'id' | 'publishedAt' | 'channelId' | 'title' | 'description' | 'thumbnails' | 'channelTitle' | 'tags' | 'categoryId' | 'defaultLanguage' | 'defaultAudioLanguage' | 'viewCount' | 'likeCount' | 'commentCount' | 'topicCategories' | 'uploadStatus' | 'privacyStatus' | 'license' | 'embeddable' | 'publicStatsViewable' | 'madeForKids' | 'hasPaidProductPlacement' | 'localizations' | 'categoryTitle' | 'duration' | 'parsedDuration' | 'caption' | 'isShort', received 'subscriberCount'"}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/popularVideos":{"get":{"summary":"Get popular videos","operationId":"getPopularVideos","description":"Get popular videos with filters","tags":["Search"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","enum":["en","es","de","fr","ja","pt","tr","it","fa","nl","af","am","ar","as","az","be","bg","bn","bs","ca","cs","da","el","en-GB","en-IN","es-419","es-US","et","eu","fi","fil","fr-CA","gl","gu","hi","hr","hu","hy","id","is","iw","ka","kk","km","kn","ko","ky","lo","lt","lv","mk","ml","mn","mr","ms","my","no","ne","or","pa","pl","pt-PT","ro","ru","si","sk","sl","sq","sr-Latn","sr","sv","sw","ta","te","th","uk","ur","uz","vi","zh-CN","zh-HK","zh-TW","zh-Hans","zu"],"description":"The language to retrieve localized data in."},"required":false,"description":"The language to retrieve localized data in.","name":"hl","in":"query"},{"schema":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AN","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BM","BN","BO","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","EU","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","ST","SV","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"],"description":"Instructs the API to return results for videos that can be viewed in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code."},"required":false,"description":"Instructs the API to return results for videos that can be viewed in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code.","name":"regionCode","in":"query"},{"schema":{"type":"string","enum":["0","1","2","10","15","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31","32","33","34","35","36","37","38","39","40","41","42","43","44"],"description":"Filters video search results based on their category."},"required":false,"description":"Filters video search results based on their category.","name":"videoCategoryId","in":"query"},{"schema":{"type":"string","description":"An array of fields to include in the response. If not provided, all fields will be returned."},"required":false,"description":"An array of fields to include in the response. If not provided, all fields will be returned.","name":"fields","in":"query"},{"schema":{"type":"string","default":"50","description":"Specifies the maximum number of items that should be returned in the result set."},"required":false,"description":"Specifies the maximum number of items that should be returned in the result set.","name":"maxResults","in":"query"},{"schema":{"type":"string","description":"The page token to get the next page for the search results. If not provided, the first page will be returned."},"required":false,"description":"The page token to get the next page for the search results. If not provided, the first page will be returned.","name":"pageToken","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalResults":{"type":"number","description":"Total number of popular videos returned."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique ID of the video."},"publishedAt":{"type":"string","description":"The date and time when the video was published."},"channelId":{"type":"string","description":"The ID of the channel that owns the video."},"title":{"type":"string","description":"The title of the video."},"description":{"type":"string","description":"The description of the video."},"thumbnails":{"type":"object","properties":{"default":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]},"medium":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]},"high":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the thumbnail image."},"width":{"type":"number","description":"The width of the thumbnail image."},"height":{"type":"number","description":"The height of the thumbnail image."}},"required":["url","width","height"]}},"required":["default","medium","high"],"description":"The thumbnails for the video, available in different sizes."},"channelTitle":{"type":"string","description":"The title of the channel that owns the video."},"tags":{"type":"array","items":{"type":"string"},"description":"An array of tags associated with the video."},"categoryId":{"type":"string","description":"The ID of the category the video belongs to."},"defaultLanguage":{"type":"string","description":"The default language of the video."},"defaultAudioLanguage":{"type":"string","description":"The default audio language of the video."},"viewCount":{"type":"string","description":"The number of views the video has received."},"likeCount":{"type":"string","description":"The number of likes the video has received."},"commentCount":{"type":"string","description":"The number of comments on the video."},"topicCategories":{"type":"array","items":{"type":"string"},"description":"An array of topic categories associated with the video."},"uploadStatus":{"type":"string","description":"The upload status of the video."},"privacyStatus":{"type":"string","description":"The privacy status of the video."},"license":{"type":"string","description":"The license type of the video."},"embeddable":{"type":"boolean","description":"Indicates if the video can be embedded."},"publicStatsViewable":{"type":"boolean","description":"Indicates if the video statistics are publicly viewable."},"madeForKids":{"type":"boolean","description":"Indicates if the video is made for kids."},"hasPaidProductPlacement":{"type":"boolean","description":"Indicates if the video has paid product placement."},"localizations":{"type":"object","additionalProperties":{"type":"object","properties":{"title":{"type":"string","description":"The localized title of the video."},"description":{"type":"string","description":"The localized description of the video."}},"required":["title","description"]},"description":"Localized titles and descriptions for the video."},"categoryTitle":{"type":"string","description":"The title of the category the video belongs to."},"duration":{"type":"string","description":"The duration of the video."},"parsedDuration":{"type":"number","description":"The parsed duration of the video in seconds."},"captionsUrl":{"type":"string","description":"The URL for the video captions, if available."},"videoFileUrl":{"type":"string","description":"The URL for the video file, if available."},"audioFileUrl":{"type":"string","description":"The URL for the audio file, if available."}},"required":["id"]},"description":"Array of popular video objects."}},"required":["totalResults","data"]},"example":{"totalResults":200,"resultsPerPage":5,"nextPageToken":"CAUQAA","data":[{"id":"snX5YyflrGw","publishedAt":"2024-09-28T16:00:00Z","channelId":"UCX6OQ3DkcsbYNE6H8uQQuVA","title":"100 Identical Twins Fight For $250,000","description":"I’ve never seen this many twins in one place before lol\nOur brand new flavor is here: Cookies & Creme, made with rich chocolatey filling, studded with crunchy cookie pieces and real creamy white chocolate. Now available at Walmart & Target! https://feastables.com/products/cookies-creme\n\nLunch just got better. #LeaveNoCrumbs https://lunchly.com/pages/lunchly-locator\n\nNew Merch - https://mrbeast.store\n\nCheck out Viewstats! - https://www.viewstats.com/\n\nSUBSCRIBE OR I TAKE YOUR DOG\n╔═╦╗╔╦╗╔═╦═╦╦╦╦╗╔═╗\n║╚╣║║║╚╣╚╣╔╣╔╣║╚╣═╣ \n╠╗║╚╝║║╠╗║╚╣║║║║║═╣\n╚═╩══╩═╩═╩═╩╝╚╩═╩═╝\n\nFor any questions or inquiries regarding this video, please reach out to chucky@mrbeastbusiness.com\n\nMusic Provided by https://www.extrememusic.com\n\n----------------------------------------------------------------\nfollow all of these or i will kick you\n\n• Facebook - https://www.facebook.com/MrBeast6000/\n• Twitter - https://twitter.com/MrBeast\n•  Instagram - https://www.instagram.com/mrbeast\n•  Im Hiring! - https://www.mrbeastjobs.com/","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/snX5YyflrGw/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/snX5YyflrGw/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/snX5YyflrGw/hqdefault.jpg","width":480,"height":360},"standard":{"url":"https://i.ytimg.com/vi/snX5YyflrGw/sddefault.jpg","width":640,"height":480},"maxres":{"url":"https://i.ytimg.com/vi/snX5YyflrGw/maxresdefault.jpg","width":1280,"height":720}},"channelTitle":"MrBeast","categoryId":"24","defaultLanguage":"en","defaultAudioLanguage":"en","viewCount":"16837247","likeCount":"937850","commentCount":"4378","topicCategories":["https://en.wikipedia.org/wiki/Entertainment","https://en.wikipedia.org/wiki/Television_program"],"uploadStatus":"processed","privacyStatus":"public","license":"youtube","embeddable":true,"publicStatsViewable":true,"madeForKids":false,"hasPaidProductPlacement":false,"categoryTitle":"Entertainment","duration":"PT35M40S","parsedDuration":2140},{"id":"9ZXzsjeRtdk","publishedAt":"2024-09-28T15:00:25Z","channelId":"UCnmGIkw-KdI0W5siakKPKog","title":"I Tried Every Airbnb Category","description":"OMG! a rat!","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/9ZXzsjeRtdk/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/9ZXzsjeRtdk/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/9ZXzsjeRtdk/hqdefault.jpg","width":480,"height":360},"standard":{"url":"https://i.ytimg.com/vi/9ZXzsjeRtdk/sddefault.jpg","width":640,"height":480},"maxres":{"url":"https://i.ytimg.com/vi/9ZXzsjeRtdk/maxresdefault.jpg","width":1280,"height":720}},"channelTitle":"Ryan Trahan","tags":["Ryan","Trahan","airbnb","I tried every airbnb category","weird hotel","I stayed in"],"categoryId":"24","defaultAudioLanguage":"en","viewCount":"1434842","likeCount":"82676","commentCount":"6748","topicCategories":["https://en.wikipedia.org/wiki/Lifestyle_(sociology)","https://en.wikipedia.org/wiki/Tourism"],"uploadStatus":"processed","privacyStatus":"public","license":"youtube","embeddable":true,"publicStatsViewable":true,"madeForKids":false,"hasPaidProductPlacement":false,"categoryTitle":"Entertainment","duration":"PT27M15S","parsedDuration":1635},{"id":"QMe-ce78GJk","publishedAt":"2024-09-27T22:33:10Z","channelId":"UCXoMM35ugF5iOzAEb-PmfRA","title":"Hurricane Helene Historic Storm Surge Devastates Cedar Key, Florida","description":"Stop data brokers from exposing your personal information. Go to my sponsor https://aura.com/jp to get a 14-day free trial and see how much of yours is being sold!\n\nWitness the full fury of Hurricane Helene as it slams into Cedar Key, Florida! This powerful Category 4 storm unleashes a historic storm surge, causing widespread devastation. Homes and businesses are ripped apart, leaving generations of residents in shock. Many have never seen a surge this high, even those whose families have lived in Cedar Key since the 1800s.\n\nThis video documents the destruction and the heartbreak left in the wake of Hurricane Helene.\n\n00:00 Intro\n01:35 Before the Hurricane\n02:24 Storm surge begins\n03:37 Peak storm surge\n06:59 The morning after at the Faraway Inn\n08:22 Historic downtown lost a lot of history\n10:25 Cedar Key's future","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/QMe-ce78GJk/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/QMe-ce78GJk/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/QMe-ce78GJk/hqdefault.jpg","width":480,"height":360},"standard":{"url":"https://i.ytimg.com/vi/QMe-ce78GJk/sddefault.jpg","width":640,"height":480},"maxres":{"url":"https://i.ytimg.com/vi/QMe-ce78GJk/maxresdefault.jpg","width":1280,"height":720}},"channelTitle":"Jonathan Petramala","tags":["hurricane helene","hurricane storm surge","hurricane damage","category 4 hurricane footage","category 4 hurricane","storm surge","major hurricane helene","florida hurricane","natural disaster","cedar key","cedar key florida","cedar key hurricane damage","devastation in cedar key","hurricane helene live","hurricane","reed timmer","ryan hall","ryan hall y'all","hurricane hits florida","storm surge florida","storm surge video"],"categoryId":"25","defaultAudioLanguage":"en-US","viewCount":"2092695","likeCount":"25252","commentCount":"3703","uploadStatus":"processed","privacyStatus":"public","license":"youtube","embeddable":true,"publicStatsViewable":true,"madeForKids":false,"hasPaidProductPlacement":true,"categoryTitle":"News & Politics","duration":"PT11M32S","parsedDuration":692},{"id":"BLCOufzhaMY","publishedAt":"2024-09-28T15:01:07Z","channelId":"UCo8bcnLyZH8tBIH9V1mLgqQ","title":"We Made It This Far","description":"Thank you for 10 years!!\nInstagram ➤ https://www.instagram.com/theodd1sout/\nTikTok ➤ https://www.tiktok.com/@theoddtiktoksout\nTwitter ➤ https://twitter.com/theodd1sout\n\nART TEAM:\nEmilee Dummer ➤ https://www.instagram.com/edummerart/\nKelly Jensen ➤ https://www.instagram.com/kelly_anne_art/\nClaire Anne ➤ https://www.instagram.com/claireanneillustration\nAmelia Rosenbalm ➤ https://www.instagram.com/galloame/\nRikikuniyuki_art ➤ https://www.instagram.com/rikikuniyuki_art/","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/BLCOufzhaMY/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/BLCOufzhaMY/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/BLCOufzhaMY/hqdefault.jpg","width":480,"height":360},"standard":{"url":"https://i.ytimg.com/vi/BLCOufzhaMY/sddefault.jpg","width":640,"height":480},"maxres":{"url":"https://i.ytimg.com/vi/BLCOufzhaMY/maxresdefault.jpg","width":1280,"height":720}},"channelTitle":"TheOdd1sOut","categoryId":"23","defaultAudioLanguage":"en","viewCount":"883139","likeCount":"127631","commentCount":"11297","topicCategories":["https://en.wikipedia.org/wiki/Entertainment","https://en.wikipedia.org/wiki/Film"],"uploadStatus":"processed","privacyStatus":"public","license":"youtube","embeddable":true,"publicStatsViewable":true,"madeForKids":false,"hasPaidProductPlacement":false,"categoryTitle":"Comedy","duration":"PT1M39S","parsedDuration":99},{"id":"V9PVRfjEBTI","publishedAt":"2024-09-27T15:00:38Z","channelId":"UCDGmojLIoWpXok597xYo8cg","title":"Billie Eilish - BIRDS OF A FEATHER (Official Music Video)","description":"Listen to HIT ME HARD AND SOFT: http://BillieEilish.lnk.to/HITMEHARDARDANDSOFT\nDownload BIRDS OF A FEATHER Live from Billie’s Amazon Music Songline performance: https://billieeilish.lnk.to/BIRDSOFAFEATHER-AMAZONDOWNLOAD \nGet tickets: https://BillieEilish.lnk.to/TourDates \n\n Follow Billie Eilish: \n\nTikTok: https://BillieEilish.lnk.to/TikTok \nInstagram: https://BillieEilish.lnk.to/Instagram \nFacebook: https://BillieEilish.lnk.to/Facebook \nTwitter: https://BillieEilish.lnk.to/Twitter \nYouTube:    / billieeilish   \nWhatsApp: https://BillieEilish.lnk.to/WhatsApp \nEmail: https://BillieEilish.lnk.to/SignUp \nStore: https://BillieEilish.lnk.to/Store \nCell: +1 (310) 807-3956\n\nMusic video by Billie Eilish performing BIRDS OF A FEATHER.© 2024 Darkroom/Interscope Records","thumbnails":{"default":{"url":"https://i.ytimg.com/vi/V9PVRfjEBTI/default.jpg","width":120,"height":90},"medium":{"url":"https://i.ytimg.com/vi/V9PVRfjEBTI/mqdefault.jpg","width":320,"height":180},"high":{"url":"https://i.ytimg.com/vi/V9PVRfjEBTI/hqdefault.jpg","width":480,"height":360},"standard":{"url":"https://i.ytimg.com/vi/V9PVRfjEBTI/sddefault.jpg","width":640,"height":480},"maxres":{"url":"https://i.ytimg.com/vi/V9PVRfjEBTI/maxresdefault.jpg","width":1280,"height":720}},"channelTitle":"BillieEilishVEVO","tags":["Billie Eilish","Darkroom/Interscope Records","Alternative"],"categoryId":"10","defaultAudioLanguage":"en","viewCount":"5055455","likeCount":"567926","commentCount":"27854","topicCategories":["https://en.wikipedia.org/wiki/Independent_music","https://en.wikipedia.org/wiki/Music","https://en.wikipedia.org/wiki/Pop_music"],"uploadStatus":"processed","privacyStatus":"public","license":"youtube","embeddable":true,"publicStatsViewable":true,"madeForKids":false,"hasPaidProductPlacement":false,"categoryTitle":"Music","duration":"PT3M51S","parsedDuration":231}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}},"received":{"type":"string"},"options":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"received":"subscriberCount","code":"invalid_enum_value","options":["publishedAt","channelId","title","description","thumbnails","channelTitle","tags","categoryId","defaultLanguage","defaultAudioLanguage","viewCount","likeCount","commentCount","topicCategories","uploadStatus","privacyStatus","license","embeddable","publicStatsViewable","madeForKids","hasPaidProductPlacement","localizations","categoryTitle","duration","parsedDuration","captionsUrl","videoFileUrl","audioFileUrl"],"path":["fields",0],"message":"Invalid enum value. Expected 'publishedAt' | 'channelId' | 'title' | 'description' | 'thumbnails' | 'channelTitle' | 'tags' | 'categoryId' | 'defaultLanguage' | 'defaultAudioLanguage' | 'viewCount' | 'likeCount' | 'commentCount' | 'topicCategories' | 'uploadStatus' | 'privacyStatus' | 'license' | 'embeddable' | 'publicStatsViewable' | 'madeForKids' | 'hasPaidProductPlacement' | 'localizations' | 'categoryTitle' | 'duration' | 'parsedDuration' | 'captionsUrl' | 'videoFileUrl' | 'audioFileUrl', received 'subscriberCount'"}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/relatedVideos":{"get":{"summary":"Get related videos","operationId":"getRelatedVideos","description":"This endpoint retrieves a list of videos related to a specified video.","tags":["Search"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","minLength":1,"description":"The ID of the video to retrieve related videos for."},"required":true,"description":"The ID of the video to retrieve related videos for.","name":"videoId","in":"query"},{"schema":{"type":"string","default":"1","description":"The number of provider pages to fetch, each returning up to 20 videos. Between 1 and 10. Each page that is actually fetched is billed; if the provider runs out of results early, only the pages that were fetched are charged."},"required":false,"description":"The number of provider pages to fetch, each returning up to 20 videos. Between 1 and 10. Each page that is actually fetched is billed; if the provider runs out of results early, only the pages that were fetched are charged.","name":"pages","in":"query"},{"schema":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AN","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BM","BN","BO","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","EU","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","ST","SV","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"],"description":"Instructs the API to return results as if the request was made from a specific country. The parameter value is an ISO 3166-1 alpha-2 country code."},"required":false,"description":"Instructs the API to return results as if the request was made from a specific country. The parameter value is an ISO 3166-1 alpha-2 country code.","name":"regionCode","in":"query"},{"schema":{"type":"string","enum":["en","es","de","fr","ja","pt","tr","it","fa","nl","af","am","ar","as","az","be","bg","bn","bs","ca","cs","da","el","en-GB","en-IN","es-419","es-US","et","eu","fi","fil","fr-CA","gl","gu","hi","hr","hu","hy","id","is","iw","ka","kk","km","kn","ko","ky","lo","lt","lv","mk","ml","mn","mr","ms","my","no","ne","or","pa","pl","pt-PT","ro","ru","si","sk","sl","sq","sr-Latn","sr","sv","sw","ta","te","th","uk","ur","uz","vi","zh-CN","zh-HK","zh-TW","zh-Hans","zu"],"description":"The language to retrieve localized data in."},"required":false,"description":"The language to retrieve localized data in.","name":"hl","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalResults":{"type":"number","description":"Total number of related videos returned."},"pagesFetched":{"type":"number","description":"The number of provider pages actually fetched for this request. This is what the request was billed for, and it can be lower than the requested `pages` when the provider has no further results."},"data":{"type":"array","items":{"type":"object","properties":{"videoId":{"type":"string","description":"The ID of the related video."},"title":{"type":"string","description":"The title of the related video."},"channelId":{"type":"string","description":"The ID of the channel that published the video. Omitted when the provider does not expose channel details for this video."},"channelHandle":{"type":"string","description":"The handle of the channel that published the video, including the leading \"@\"."},"channelTitle":{"type":"string","description":"The title of the channel that published the video."},"viewCount":{"type":"number","description":"The number of views the video has."},"publishedAt":{"type":"string","description":"The date the video was published, in ISO 8601 format. The provider reports day precision, so the time component is always midnight UTC."}},"required":["videoId","title","viewCount","publishedAt"]},"description":"Array of related video objects."}},"required":["totalResults","pagesFetched","data"]},"example":{"totalResults":3,"pagesFetched":1,"data":[{"videoId":"3ix8kNGRwxE","title":"The Lord Of The Rings | When Hope Moves In Silence — Emotional Deep Focus","channelId":"UCyPNg3TV04kk4FF5laSoROA","channelHandle":"@CinematicSoulChannel","channelTitle":"CinematicSoul","viewCount":698000,"publishedAt":"2026-01-17T00:00:00Z"},{"videoId":"t-yD25Kbv6c","title":"Read with Aragorn in Rivendell 🌿 | LOTR Ambient Music for Peace, Focus & Reflection","channelId":"UCBGbmFOOYnXWTIWzsJNADbQ","channelHandle":"@QuietHourAmbience","channelTitle":"The Quiet Hour","viewCount":348000,"publishedAt":"2026-01-17T00:00:00Z"},{"videoId":"B5Lfey8nBYM","title":"Well... now I understand why he's the perfect Aragorn","viewCount":230000,"publishedAt":"2026-07-17T00:00:00Z"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"expected":{"type":"string"},"received":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"invalid_type","expected":"string","received":"undefined","path":["videoId"],"message":"Required"}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}},"/v1/project":{"get":{"summary":"Get project details","operationId":"getProjectDetails","description":"Returns the details of a project.","tags":["Projects"],"security":[{"Bearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The project ID in UUID format."},"name":{"type":"string","description":"The name of the project."},"balance":{"type":"number","description":"The balance of the project."},"createdAt":{"type":"string","description":"The creation date of the project."},"tokenCount":{"type":"number","description":"The number of tokens associated with the project."},"dailySpent":{"type":"number","description":"The daily spent amount for the project."},"dailyRequests":{"type":"number","description":"The number of daily requests for the project."}},"required":["id","name","balance","createdAt","tokenCount","dailySpent","dailyRequests"]},"example":{"id":"3740249b-d8d1-4235-ac59-b965fc1bee44","name":"Default","balance":231.4455,"createdAt":"2024-09-14 19:37:51","tokenCount":28,"dailySpent":13.74484999521519,"dailyRequests":43561}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"API key is invalid."}}}}}}}},"/v1/project/tokens":{"post":{"summary":"Create a token","operationId":"createProjectToken","description":"Creates a new token for the project.","tags":["Tokens"],"security":[{"Bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":128,"description":"The label for the token."},"settings":{"type":"object","properties":{"rateLimit":{"type":"object","properties":{"limit":{"type":"number","description":"The rate limit value."},"window":{"type":"number","description":"The rate limit window value."}},"required":["limit","window"],"description":"The rate limit settings for the token."}},"description":"The settings for the token."}},"additionalProperties":false},"example":{"label":"Dev token"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique ID of the token."},"token":{"type":"string","description":"The token value."}},"required":["id","token"]},"example":{"id":"0659684b-7658-451d-bb1e-3c400e0b0950","token":"poix-OzhCUl37R4yswp2EOKBGE6bjZ6EIWHjxJ6H3JOERkmIAmeibAbQ"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"keys":{"type":"array","items":{"type":"string"}},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","keys","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"unrecognized_keys","keys":["validations"],"path":[],"message":"Unrecognized key(s) in object: 'validations'"}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"API key is invalid."}}}}}}},"get":{"summary":"Get tokens list","operationId":"getProjectTokens","description":"Returns the tokens associated with a project.","tags":["Tokens"],"security":[{"Bearer":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique ID of the token."},"label":{"type":"string","description":"The label of the token."},"createdAt":{"type":"string","description":"The creation date of the token."},"revokedAt":{"type":"string","description":"The revocation date of the token, if any."},"settings":{"type":"object","properties":{"rateLimit":{"type":"object","properties":{"limit":{"type":"number","description":"The rate limit value."},"window":{"type":"number","description":"The rate limit window value."}},"required":["limit","window"],"description":"The rate limit settings for the token."}},"description":"The settings for the token."}},"required":["id","label","createdAt"]},"description":"Array of token objects."}},"required":["data"]},"example":{"data":[{"id":"b3e2538e-f2e3-43df-b213-337c88029542","label":"Prod Token","createdAt":"2024-10-16 20:24:06","settings":{"rateLimit":{"limit":100,"window":60}}}]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"API key is invalid."}}}}}}}},"/v1/project/tokens/{tokenId}":{"patch":{"summary":"Update a token","operationId":"updateProjectToken","description":"Updates a project token.","tags":["Tokens"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"The token ID in UUID format.","example":"a9e6a7a1-dc72-4b68-944f-4652d4402193"},"required":true,"name":"tokenId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["active","revoked"],"description":"The status of the token.","example":"active"}},"required":["status"],"additionalProperties":false},"example":{"status":"revoked"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"validation":"uuid","code":"invalid_string","message":"Invalid uuid","path":["tokenId"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"API key is invalid."}}}}}}},"delete":{"summary":"Delete a token","operationId":"deleteProjectToken","description":"Deletes a project token.","tags":["Tokens"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"The token ID in UUID format.","example":"123e4567-e89b-12d3-a456-426614174000"},"required":true,"name":"tokenId","in":"path"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"validation":"uuid","code":"invalid_string","message":"Invalid uuid","path":["tokenId"]}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"API key is invalid."}}}}}}}},"/autocomplete":{"get":{"summary":"Get search suggestions","operationId":"getSearchSuggestions","description":"This endpoint retrieves a list of search suggestions for a specified query.","tags":["Search"],"security":[{"Bearer":[]}],"parameters":[{"schema":{"type":"string","description":"The search query to retrieve suggestions for."},"required":true,"description":"The search query to retrieve suggestions for.","name":"q","in":"query"},{"schema":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AN","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BM","BN","BO","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","EU","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","ST","SV","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"],"description":"Instructs the API to return results as if the request was made from a specific country. ISO 3166 alpha-2 country code."},"required":false,"description":"Instructs the API to return results as if the request was made from a specific country. ISO 3166 alpha-2 country code.","name":"regionCode","in":"query"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"string"},"description":"Array of search suggestion strings."}},"required":["data"]},"example":{"data":["cats","cats meowing","cats in the cradle","cats talking","cats fighting","cats meowing to attract cats","cats funny videos","cats mating","cats and cucumbers","cats in the cradle harry chapin","cats can talk","cats funny","cats speaking english","cats musical"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"object","properties":{"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"expected":{"type":"string"},"received":{"type":"string"},"maximum":{"type":"number"},"type":{"type":"string"},"inclusive":{"type":"boolean"},"exact":{"type":"boolean"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}},"name":{"type":"string","enum":["ZodError"]}},"required":["issues","name"]}},"required":["success","error"]},"example":{"success":false,"error":{"issues":[{"code":"invalid_type","expected":"string","received":"undefined","path":["q"],"message":"Required"}],"name":"ZodError"}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["error"]},"example":{"error":{"message":"Forbidden"}}}}}}}}},"webhooks":{}}