nzhMSSKJrJrJr SSKJr SSK7 SSKJr "SS\5r "SS\5r "S S \5r "S S \5r "S S\5r "SS\5rg))AnyDictOptional)ChannelSearchCore)*) SearchCorec f^\rSrSrSrS S\S\S\S\S\\4 U4SjjjrS \ \\ 44S jr S r U=r $) Searchu Searches for videos, channels & playlists in YouTube. Args: query (str): Sets the search query. limit (int, optional): Sets limit to the number of results. Defaults to 20. language (str, optional): Sets the result language. Defaults to 'en'. region (str, optional): Sets the result region. Defaults to 'US'. Examples: Calling `result` method gives the search result. >>> search = Search('Watermelon Sugar', limit = 1) >>> result = await search.next() >>> print(result) { "result": [ { "type": "video", "id": "E07s5ZYygMg", "title": "Harry Styles - Watermelon Sugar (Official Video)", "publishedTime": "6 months ago", "duration": "3:09", "viewCount": { "text": "162,235,006 views", "short": "162M views" }, "thumbnails": [ { "url": "https://i.ytimg.com/vi/E07s5ZYygMg/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLAOWBTE1SDrtrDQ1aWNzpDZ7YiMIw", "width": 360, "height": 202 }, { "url": "https://i.ytimg.com/vi/E07s5ZYygMg/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD7U54pGZLPKTuMP-J3kpm4LIDPVg", "width": 720, "height": 404 } ], "descriptionSnippet": [ { "text": "This video is dedicated to touching. Listen to Harry Styles' new album 'Fine Line' now: https://HStyles.lnk.to/FineLineAY Follow ..." } ], "channel": { "name": "Harry Styles", "id": "UCZFWPqqPkFlNwIxcpsLOwew", "thumbnails": [ { "url": "https://yt3.ggpht.com/a-/AOh14GgNUvHxwlnz4RpHamcGnZF1px13VHj01TPksw=s68-c-k-c0x00ffffff-no-rj-mo", "width": 68, "height": 68 } ], "link": "https://www.youtube.com/channel/UCZFWPqqPkFlNwIxcpsLOwew" }, "accessibility": { "title": "Harry Styles - Watermelon Sugar (Official Video) by Harry Styles 6 months ago 3 minutes, 9 seconds 162,235,006 views", "duration": "3 minutes, 9 seconds" }, "link": "https://www.youtube.com/watch?v=E07s5ZYygMg", "shelfTitle": null } ] } querylimitlanguageregiontimeoutc8>SUl[TU] XX4SU5 gN)TTT searchModesuper__init__selfr r rrr __class__s _/home/james-whalen/.local/lib/python3.13/site-packages/youtubesearchpython/__future__/search.pyrSearch.__init__Js, xwGreturnc># UR5IShvN $N7fN _nextAsyncrs rnext Search.nextN__&&&& renUSN__name__ __module__ __qualname____firstlineno____doc__strintrrrrr#__static_attributes__ __classcell__rs@rr r s_@BHcH#HcHRUHgopsgtHH'DcN''rr c f^\rSrSrSrS S\S\S\S\S\\4 U4SjjjrS \ \\ 44S jr S r U=r $) VideosSearchRu Searches for videos in YouTube. Args: query (str): Sets the search query. limit (int, optional): Sets limit to the number of results. Defaults to 20. language (str, optional): Sets the result language. Defaults to 'en'. region (str, optional): Sets the result region. Defaults to 'US'. Examples: Calling `result` method gives the search result. >>> search = VideosSearch('Watermelon Sugar', limit = 1) >>> result = await search.next() >>> print(result) { "result": [ { "type": "video", "id": "E07s5ZYygMg", "title": "Harry Styles - Watermelon Sugar (Official Video)", "publishedTime": "6 months ago", "duration": "3:09", "viewCount": { "text": "162,235,006 views", "short": "162M views" }, "thumbnails": [ { "url": "https://i.ytimg.com/vi/E07s5ZYygMg/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLAOWBTE1SDrtrDQ1aWNzpDZ7YiMIw", "width": 360, "height": 202 }, { "url": "https://i.ytimg.com/vi/E07s5ZYygMg/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD7U54pGZLPKTuMP-J3kpm4LIDPVg", "width": 720, "height": 404 } ], "descriptionSnippet": [ { "text": "This video is dedicated to touching. Listen to Harry Styles' new album 'Fine Line' now: https://HStyles.lnk.to/FineLineAY Follow ..." } ], "channel": { "name": "Harry Styles", "id": "UCZFWPqqPkFlNwIxcpsLOwew", "thumbnails": [ { "url": "https://yt3.ggpht.com/a-/AOh14GgNUvHxwlnz4RpHamcGnZF1px13VHj01TPksw=s68-c-k-c0x00ffffff-no-rj-mo", "width": 68, "height": 68 } ], "link": "https://www.youtube.com/channel/UCZFWPqqPkFlNwIxcpsLOwew" }, "accessibility": { "title": "Harry Styles - Watermelon Sugar (Official Video) by Harry Styles 6 months ago 3 minutes, 9 seconds 162,235,006 views", "duration": "3 minutes, 9 seconds" }, "link": "https://www.youtube.com/watch?v=E07s5ZYygMg", "shelfTitle": null } ] } r r rrrcT>SUl[TU] XX4[RU5 g)N)TFF)rrr SearchModevideosrs rrVideosSearch.__init__s#. x9J9JGTrrc># UR5IShvN $N7frr r"s rr#VideosSearch.nextr%r&r'r(r,r6s@rr8r8Rs_@BUcU#UcURUUgopsgtUU'DcN''rr8c f^\rSrSrSrS S\S\S\S\S\\4 U4SjjjrS \ \\ 44S jr S r U=r $) ChannelsSearchaSearches for channels in YouTube. Args: query (str): Sets the search query. limit (int, optional): Sets limit to the number of results. Defaults to 20. language (str, optional): Sets the result language. Defaults to 'en'. region (str, optional): Sets the result region. Defaults to 'US'. Examples: Calling `result` method gives the search result. >>> search = ChannelsSearch('Harry Styles', limit = 1) >>> result = await search.next() >>> print(result) { "result": [ { "type": "channel", "id": "UCZFWPqqPkFlNwIxcpsLOwew", "title": "Harry Styles", "thumbnails": [ { "url": "https://yt3.ggpht.com/ytc/AAUvwnhR81ocC_KalYEk5ItnJcfMBqaiIpuM1B0lJyg4Rw=s88-c-k-c0x00ffffff-no-rj-mo", "width": 88, "height": 88 }, { "url": "https://yt3.ggpht.com/ytc/AAUvwnhR81ocC_KalYEk5ItnJcfMBqaiIpuM1B0lJyg4Rw=s176-c-k-c0x00ffffff-no-rj-mo", "width": 176, "height": 176 } ], "videoCount": "7", "descriptionSnippet": null, "subscribers": "9.25M subscribers", "link": "https://www.youtube.com/channel/UCZFWPqqPkFlNwIxcpsLOwew" } ] } r r rrrcT>SUl[TU] XX4[RU5 g)N)FTF)rrrr;channelsrs rrChannelsSearch.__init__s#. x9L9LgVrrc># UR5IShvN $N7frr r"s rr#ChannelsSearch.nextr%r&r'r(r,r6s@rrArAs^'PWcW#WcWRUWgopsgtWW'DcN''rrAc f^\rSrSrSrS S\S\S\S\S\\4 U4SjjjrS \ \\ 44S jr S r U=r $) PlaylistsSearchaSearches for playlists in YouTube. Args: query (str): Sets the search query. limit (int, optional): Sets limit to the number of results. Defaults to 20. language (str, optional): Sets the result language. Defaults to 'en'. region (str, optional): Sets the result region. Defaults to 'US'. Examples: Calling `result` method gives the search result. >>> search = PlaylistsSearch('Harry Styles', limit = 1) >>> result = await search.next() >>> print(result) { "result": [ { "type": "playlist", "id": "PL-Rt4gIwHnyvxpEl-9Le0ePztR7WxGDGV", "title": "fine line harry styles full album lyrics", "videoCount": "12", "channel": { "name": "ourmemoriestonight", "id": "UCZCmb5a8LE9LMxW9I3-BFjA", "link": "https://www.youtube.com/channel/UCZCmb5a8LE9LMxW9I3-BFjA" }, "thumbnails": [ { "url": "https://i.ytimg.com/vi/raTh8Mu5oyM/hqdefault.jpg?sqp=-oaymwEWCKgBEF5IWvKriqkDCQgBFQAAiEIYAQ==&rs=AOn4CLCdCfOQYMrPImHMObdrMcNimKi1PA", "width": 168, "height": 94 }, { "url": "https://i.ytimg.com/vi/raTh8Mu5oyM/hqdefault.jpg?sqp=-oaymwEWCMQBEG5IWvKriqkDCQgBFQAAiEIYAQ==&rs=AOn4CLDsKmyGH8bkmt9MzZqIoXI4UaduBw", "width": 196, "height": 110 }, { "url": "https://i.ytimg.com/vi/raTh8Mu5oyM/hqdefault.jpg?sqp=-oaymwEXCPYBEIoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD9v7S0KeHLBLr0bF-LrRjYVycUFA", "width": 246, "height": 138 }, { "url": "https://i.ytimg.com/vi/raTh8Mu5oyM/hqdefault.jpg?sqp=-oaymwEXCNACELwBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAIzQIVxZsC0PfvLOt-v9UWJ-109Q", "width": 336, "height": 188 } ], "link": "https://www.youtube.com/playlist?list=PL-Rt4gIwHnyvxpEl-9Le0ePztR7WxGDGV" } ] } r r rrrcT>SUl[TU] XX4[RU5 g)N)FFT)rrrr; playlistsrs rrPlaylistsSearch.__init__s#. x9M9MwWrrc># UR5IShvN $N7frr r"s rr#PlaylistsSearch.nextr%r&r'r(r,r6s@rrIrIs^4jXcX#XcXRUXgopsgtXX'DcN''rrIcj^\rSrSrSrS S\S\S\S\S\S\\4 U4S jjjrS \ \\ 44S jr S r U=r $) CustomSearchi u[ Performs custom search in YouTube with search filters or sorting orders. Few of the predefined filters and sorting orders are: 1 - SearchMode.videos 2 - VideoUploadDateFilter.lastHour 3 - VideoDurationFilter.long 4 - VideoSortOrder.viewCount There are many other to use. The value of `sp` parameter in the YouTube search query can be used as a search filter e.g. `EgQIBRAB` from https://www.youtube.com/results?search_query=NoCopyrightSounds&sp=EgQIBRAB can be passed as `searchPreferences`, to get videos, which are uploaded this year. Args: query (str): Sets the search query. searchPreferences (str): Sets the `sp` query parameter in the YouTube search request. limit (int, optional): Sets limit to the number of results. Defaults to 20. language (str, optional): Sets the result language. Defaults to 'en'. region (str, optional): Sets the result region. Defaults to 'US'. Examples: Calling `result` method gives the search result. >>> search = CustomSearch('Harry Styles', VideoSortOrder.viewCount, limit = 1) >>> result = await search.next() >>> print(result) { "result": [ { "type": "video", "id": "QJO3ROT-A4E", "title": "One Direction - What Makes You Beautiful (Official Video)", "publishedTime": "9 years ago", "duration": "3:27", "viewCount": { "text": "1,212,146,802 views", "short": "1.2B views" }, "thumbnails": [ { "url": "https://i.ytimg.com/vi/QJO3ROT-A4E/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLDeFKrH99gmpnvKyG4czdd__YRDkw", "width": 360, "height": 202 }, { "url": "https://i.ytimg.com/vi/QJO3ROT-A4E/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBJ_wUjsRFXGsbvRpwYpSLlsGmbkw", "width": 720, "height": 404 } ], "descriptionSnippet": [ { "text": "One Direction – What Makes You Beautiful (Official Video) Follow on Spotify - https://1D.lnk.to/Spotify Listen on Apple Music ..." } ], "channel": { "name": "One Direction", "id": "UCb2HGwORFBo94DmRx4oLzow", "thumbnails": [ { "url": "https://yt3.ggpht.com/a-/AOh14Gj3SMvtIAvVNUrHWFTJFubPN7qozzPl5gFkoA=s68-c-k-c0x00ffffff-no-rj-mo", "width": 68, "height": 68 } ], "link": "https://www.youtube.com/channel/UCb2HGwORFBo94DmRx4oLzow" }, "accessibility": { "title": "One Direction - What Makes You Beautiful (Official Video) by One Direction 9 years ago 3 minutes, 27 seconds 1,212,146,802 views", "duration": "3 minutes, 27 seconds" }, "link": "https://www.youtube.com/watch?v=QJO3ROT-A4E", "shelfTitle": null } ] } r searchPreferencesr rrrc6>SUl[TU] XXEX&5 grr)rr rRr rrrrs rrCustomSearch.__init__Ws, x9JTrrc># UR5IShvN $N7frr r"s rr#CustomSearch.next[r%r&r'r(r,r6s@rrQrQ stKXUcUcU#UVYUjmU@HIL@MUU'DcN''rrQcR^\rSrSrSrS S\S\S\S\S\S\\4 U4S jjjrS r U=r $) ChannelSearchi^ux Searches for videos in specific channel in YouTube. Args: query (str): Sets the search query. browseId (str): Channel ID language (str, optional): Sets the result language. Defaults to 'en'. region (str, optional): Sets the result region. Defaults to 'US'. Examples: Calling `result` method gives the search result. >>> search = ChannelSearch('Watermelon Sugar', "UCZFWPqqPkFlNwIxcpsLOwew") >>> result = await search.next() >>> print(result) { "result": [ { "id": "WMcIfZuRuU8", "thumbnails": { "normal": [ { "url": "https://i.ytimg.com/vi/WMcIfZuRuU8/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLClFg6C1r5NfTQy7TYUq6X5qHUmPA", "width": 168, "height": 94 }, { "url": "https://i.ytimg.com/vi/WMcIfZuRuU8/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLAoOyftwY0jLV4geWb5hejULYp3Zw", "width": 196, "height": 110 }, { "url": "https://i.ytimg.com/vi/WMcIfZuRuU8/hqdefault.jpg?sqp=-oaymwEcCPYBEIoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCdqkhn7JDwLvRtTNx3jq-olz7k-Q", "width": 246, "height": 138 }, { "url": "https://i.ytimg.com/vi/WMcIfZuRuU8/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAhYedsqBFKI0Ra2qzIv9cVoZhfKQ", "width": 336, "height": 188 } ], "rich": null }, "title": "Harry Styles – Watermelon Sugar (Lost Tour Visual)", "descriptionSnippet": "This video is dedicated to touching. Listen to Harry Styles’ new album ‘Fine Line’ now: https://HStyles.lnk.to/FineLineAY Follow Harry Styles: Facebook: https://HarryStyles.lnk.to/followFI...", "uri": "/watch?v=WMcIfZuRuU8", "views": { "precise": "3,888,287 views", "simple": "3.8M views", "approximate": "3.8 million views" }, "duration": { "simpleText": "2:55", "text": "2 minutes, 55 seconds" }, "published": "10 months ago", "channel": { "name": "Harry Styles", "thumbnails": [ { "url": "https://yt3.ggpht.com/ytc/AAUvwnhR81ocC_KalYEk5ItnJcfMBqaiIpuM1B0lJyg4Rw=s88-c-k-c0x00ffffff-no-rj", "width": 68, "height": 68 } ] }, "type": "video" }, ] } r browseIdrrrRrc(>[TU]XXEX&5 gr)rr)rr rYrrrRrrs rrChannelSearch.__init__s &XWr)r*r+zEgZzZWFyY2g%3DN) r-r.r/r0r1r2rr3rr4r5r6s@rrXrX^s[FPXcXSXCXPSXorXQYZ]Q^XXrrXN)typingrrr&youtubesearchpython.core.channelsearchr"youtubesearchpython.core.constantsyoutubesearchpython.core.searchrr r8rArIrQrXr\rrrasl&&D06G'ZG'TG':G'T.'Z.'b;'j;'zR':R'hJX%JXr