nzh MSSK7 SSKJr SSKJr "SS\5r"SS\5r"SS \5r"S S \5r"S S \5r "SS\5r g))*) SearchCore)ChannelSearchCorec V^\rSrSrSrS S\S\S\S\S\4 U4SjjjrS \4S 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) >>> print(search.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 } ] } querylimitlanguageregiontimeoutc>SUl[TU] XX4SU5 UR5 UR"UR6 gN)TTT searchModesuper__init__ sync_create_getComponentsselfr r r r r __class__s T/home/james-whalen/.local/lib/python3.13/site-packages/youtubesearchpython/search.pyrSearch.__init__Gs;, xwG  T__-returnc"UR5$N_nextrs rnext Search.nextMzz|rrenUSN __name__ __module__ __qualname____firstlineno____doc__strintrboolr"__static_attributes__ __classcell__rs@rrrI?@.c.#.c.RU.gj.. drrc V^\rSrSrSrS S\S\S\S\S\4 U4SjjjrS \4S jr S r U=r $) VideosSearchPu 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) >>> print(search.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 r r r c>SUl[TU] XX4[RU5 UR 5 UR "UR6 g)N)TFF)rrr SearchModevideosrrrs rrVideosSearch.__init__sA. x9J9JGT  T__-rrc"UR5$rrr!s rr"VideosSearch.nextr$rr%r&r*r5s@rr8r8Pr6rr8c V^\rSrSrSrS S\S\S\S\S\4 U4SjjjrS \4S 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) >>> print(search.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 r r r c>SUl[TU] XX4[RU5 UR 5 UR "UR6 g)N)FTF)rrrr;channelsrrrs rrChannelsSearch.__init__sA. x9L9LgV  T__-rrc"UR5$rrr!s rr"ChannelsSearch.nextr$rr%r&r*r5s@rrArAsI&N.c.#.c.RU.gj.. drrAc V^\rSrSrSrS S\S\S\S\S\4 U4SjjjrS \4S 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) >>> print(search.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 r r r c>SUl[TU] XX4[RU5 UR 5 UR "UR6 g)N)FFT)rrrr; playlistsrrrs rrPlaylistsSearch.__init__sA. x9M9MwW  T__-rrc"UR5$rrr!s rr"PlaylistsSearch.nextr$rr%r&r*r5s@rrIrIsI3h.c.#.c.RU.gj.. drrIc L^\rSrSrSrS S\S\S\S\S\S\4 U4S jjjrS rU=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") >>> print(search.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 browseIdr r searchPreferencesr cH>[TU]XXEX&5 UR5 gr)rrr)rr rRr r rSr rs rrChannelSearch.__init__Ts  &XW r)r(r)zEgZzZWFyY2g%3DN) r+r,r-r.r/r0r1rr3r4r5s@rrQrQ sEENcSCPSorQTrrQc R^\rSrSrSrS S\S\S\S\S\S\4 U4S jjjrS rS r U=r $) CustomSearchiYu? 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) >>> print(search.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 rSr r r r c>SUl[TU] XXEX&5 UR5 UR"UR6 grr)rr rSr r r r rs rrCustomSearch.__init__s:, x9JT  T__-rc$UR5 grrr!s rr"CustomSearch.nexts  rr%r&) r+r,r-r.r/r0r1rr"r3r4r5s@rrXrXYsOJV.c.c.#.VY.jm.@C.. rrXN) "youtubesearchpython.core.constantsyoutubesearchpython.core.searchr&youtubesearchpython.core.channelsearchrrr8rArIrQrXrVrrr`sd06DHZHTH:HV/Z/d<j<~J%JZS:Sr