From e897a595593c2d93db9751fc9f2eea1b7752e465 Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sun, 13 Nov 2022 21:42:41 -0500
Subject: [PATCH 01/12] Revert "Add Filters.has_global"

This reverts commit 0e9399af3ffe464317fc8916fc16b42500b590e7.
---
 pomice/player.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/pomice/player.py b/pomice/player.py
index 22db950..774ec89 100644
--- a/pomice/player.py
+++ b/pomice/player.py
@@ -33,11 +33,6 @@ class Filters:
         """Property which checks if any applied filters were preloaded"""
         return any(f for f in self._filters if f.preload == True)
 
-    @property
-    def has_global(self):
-        """Property which checks if any applied filters are global"""
-        return any(f for f in self._filters if f.preload == False)
-
     @property
     def empty(self):
         """Property which checks if the filter list is empty"""

From 8dfdf9f2008ae41f4d7e3585cf16253be18888da Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sun, 13 Nov 2022 21:49:14 -0500
Subject: [PATCH 02/12] fixing local git

---
 pomice/player.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/pomice/player.py b/pomice/player.py
index 774ec89..22db950 100644
--- a/pomice/player.py
+++ b/pomice/player.py
@@ -33,6 +33,11 @@ class Filters:
         """Property which checks if any applied filters were preloaded"""
         return any(f for f in self._filters if f.preload == True)
 
+    @property
+    def has_global(self):
+        """Property which checks if any applied filters are global"""
+        return any(f for f in self._filters if f.preload == False)
+
     @property
     def empty(self):
         """Property which checks if the filter list is empty"""

From ec2f2d734fc92401ca23aae2628fa119d245d3a0 Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sun, 13 Nov 2022 22:01:15 -0500
Subject: [PATCH 03/12] make queue.remove take Track instead of int

---
 pomice/queue.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/pomice/queue.py b/pomice/queue.py
index a44a8aa..97d0cf7 100644
--- a/pomice/queue.py
+++ b/pomice/queue.py
@@ -118,15 +118,14 @@ class Queue(Iterable[Track]):
     def _index(self, item: Track) -> int:
         return self._queue.index(item)
 
-
     def _put(self, item: Track) -> None:
         self._queue.append(item)
 
     def _insert(self, index: int, item: Track) -> None:
         self._queue.insert(index, item)
 
-    def _remove(self, index: int) -> None:
-        self._queue.remove(index)
+    def _remove(self, item: Track) -> None:
+        self._queue.remove(item)
 
     def _get_random_float(self) -> float:
         return random.random()
@@ -233,7 +232,7 @@ class Queue(Iterable[Track]):
         Removes a item within the queue.
         Raises ValueError if item is not in queue.
         """
-        return self._remove(self._index(self._check_track(item)))
+        return self._remove(self._check_track(item))
 
 
     def find_position(self, item: Track) -> int:

From 5bd523c0f83eaf83d1537aa2616bab89730de504 Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sat, 19 Nov 2022 12:02:27 -0500
Subject: [PATCH 04/12] change version number for hotfix

---
 pomice/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pomice/__init__.py b/pomice/__init__.py
index cf09b08..a5f1602 100644
--- a/pomice/__init__.py
+++ b/pomice/__init__.py
@@ -18,7 +18,7 @@ if not discord.version_info.major >= 2:
         "using 'pip install discord.py'"
     )
 
-__version__ = "1.1.8a"
+__version__ = "1.1.7.1"
 __title__ = "pomice"
 __author__ = "cloudwithax"
 

From 70815d45fff066c28477f420d850a9ed4b62cb11 Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sat, 19 Nov 2022 12:12:39 -0500
Subject: [PATCH 05/12] revert version number for next release

---
 pomice/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pomice/__init__.py b/pomice/__init__.py
index a5f1602..cf09b08 100644
--- a/pomice/__init__.py
+++ b/pomice/__init__.py
@@ -18,7 +18,7 @@ if not discord.version_info.major >= 2:
         "using 'pip install discord.py'"
     )
 
-__version__ = "1.1.7.1"
+__version__ = "1.1.8a"
 __title__ = "pomice"
 __author__ = "cloudwithax"
 

From 9fde02c2e08729aadb5f56475a0b13449bf851ae Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sat, 19 Nov 2022 14:28:15 -0500
Subject: [PATCH 06/12] update advanced.py cog

---
 examples/advanced.py | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/examples/advanced.py b/examples/advanced.py
index 85350fe..88a364a 100644
--- a/examples/advanced.py
+++ b/examples/advanced.py
@@ -21,7 +21,7 @@ class Player(pomice.Player):
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
  
-        self.queue = asyncio.Queue()
+        self.queue = pomice.Queue()
         self.controller: discord.Message = None
         # Set context here so we can send a now playing embed
         self.context: commands.Context = None
@@ -49,8 +49,8 @@ class Player(pomice.Player):
 
        # Queue up the next track, else teardown the player
         try:
-            track: pomice.Track = self.queue.get_nowait()
-        except asyncio.queues.QueueEmpty:  
+            track: pomice.Track = self.queue.get()
+        except pomice.QueueEmpty:  
             return await self.teardown()
 
         await self.play(track)
@@ -143,7 +143,7 @@ class Music(commands.Cog):
     async def on_pomice_track_exception(self, player: Player, track, _):
         await player.do_next()
         
-    @commands.command(aliases=['join', 'joi', 'j', 'summon', 'su', 'con'])
+    @commands.command(aliases=['joi', 'j', 'summon', 'su', 'con', 'connect'])
     async def join(self, ctx: commands.Context, *, channel: discord.VoiceChannel = None) -> None:
         if not channel:
             channel = getattr(ctx.author.voice, "channel", None)
@@ -157,7 +157,7 @@ class Music(commands.Cog):
         player: Player = ctx.voice_client
 
         # Set the player context so we can use it so send messages
-        player.set_context(ctx=ctx)
+        await player.set_context(ctx=ctx)
         await ctx.send(f"Joined the voice channel `{channel.name}`")
 
     @commands.command(aliases=['disconnect', 'dc', 'disc', 'lv', 'fuckoff'])
@@ -172,7 +172,9 @@ class Music(commands.Cog):
     async def play(self, ctx: commands.Context, *, search: str) -> None:
         # Checks if the player is in the channel before we play anything
         if not (player := ctx.voice_client):
-            await ctx.invoke(self.join)   
+            await ctx.author.voice.channel.connect(cls=Player)
+            player: Player = ctx.voice_client
+            await player.set_context(ctx=ctx)   
 
         # If you search a keyword, Pomice will automagically search the result using YouTube
         # You can pass in "search_type=" as an argument to change the search type
@@ -187,10 +189,10 @@ class Music(commands.Cog):
         
         if isinstance(results, pomice.Playlist):
             for track in results.tracks:
-                await player.queue.put(track)
+                player.queue.put(track)
         else:
             track = results[0]
-            await player.queue.put(track)
+            player.queue.put(track)
 
         if not player.is_playing:
             await player.do_next()
@@ -315,7 +317,7 @@ class Music(commands.Cog):
         if self.is_privileged(ctx):
             await ctx.send('An admin or DJ has shuffled the queue.', delete_after=10)
             player.shuffle_votes.clear()
-            return random.shuffle(player.queue._queue)
+            return player.queue.shuffle()
 
         required = self.required(ctx)
         player.shuffle_votes.add(ctx.author)
@@ -323,7 +325,7 @@ class Music(commands.Cog):
         if len(player.shuffle_votes) >= required:
             await ctx.send('Vote to shuffle passed. Shuffling the queue.', delete_after=10)
             player.shuffle_votes.clear()
-            random.shuffle(player.queue._queue)
+            player.queue.shuffle()
         else:
             await ctx.send(f'{ctx.author.mention} has voted to shuffle the queue. Votes: {len(player.shuffle_votes)}/{required}', delete_after=15)
 
@@ -348,7 +350,7 @@ class Music(commands.Cog):
     
 
 
-def setup(bot: commands.Bot):
-    bot.add_cog(Music(bot))
+async def setup(bot: commands.Bot):
+    await bot.add_cog(Music(bot))
 
 

From 23fd49be1a731e922d110269b7da9caa5123011a Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sun, 11 Dec 2022 21:06:33 -0500
Subject: [PATCH 07/12] add playlist video correction and timestamp retrivial
 for qualifying videos

---
 pomice/objects.py |  4 +++-
 pomice/player.py  |  1 -
 pomice/pool.py    | 36 +++++++++++++++++++++++++++++++-----
 3 files changed, 34 insertions(+), 7 deletions(-)

diff --git a/pomice/objects.py b/pomice/objects.py
index d84478f..aac262e 100644
--- a/pomice/objects.py
+++ b/pomice/objects.py
@@ -25,12 +25,14 @@ class Track:
         spotify: bool = False,
         search_type: SearchType = SearchType.ytsearch,
         spotify_track = None,
-        filters: Optional[List[Filter]] = None
+        filters: Optional[List[Filter]] = None,
+        timestamp: Optional[float] = None
     ):
         self.track_id = track_id
         self.info = info
         self.spotify = spotify
         self.filters: List[Filter] = filters
+        self.timestamp: Optional[float] = None
 
         self.original: Optional[Track] = None if spotify else self
         self._search_type = search_type
diff --git a/pomice/player.py b/pomice/player.py
index 22db950..47b4f0b 100644
--- a/pomice/player.py
+++ b/pomice/player.py
@@ -21,7 +21,6 @@ from .exceptions import FilterInvalidArgument, FilterTagAlreadyInUse, FilterTagI
 from .filters import Filter
 from .objects import Track
 from .pool import Node, NodePool
-from .queue import Queue
 
 class Filters:
     """Helper class for filters"""
diff --git a/pomice/pool.py b/pomice/pool.py
index 9eee0ed..1f39198 100644
--- a/pomice/pool.py
+++ b/pomice/pool.py
@@ -43,6 +43,14 @@ DISCORD_MP3_URL_REGEX = re.compile(
     r"(?P<message_id>[0-9]+)/(?P<file>[a-zA-Z0-9_.]+)+"
 )
 
+YOUTUBE_PLAYLIST_REGEX = re.compile(
+    r"(?P<video>^.*?v.*?)(?P<list>&list.*)"
+)
+
+YOUTUBE_TIMESTAMP_REGEX = re.compile(
+    r"(?P<video>^.*?)(\?t|&start)=(?P<time>\d+)?.*"
+)
+
 URL_REGEX = re.compile(
     r"https?://(?:www\.)?.+"
 )
@@ -153,6 +161,11 @@ class Node:
         """Property which returns the latency of the node"""
         return Ping(self._host, port=self._port).get_ping()
 
+    @property
+    def ping(self):
+        """Alias for `Node.latency`, returns the latency of the node"""
+        return self.latency
+
     async def _update_handler(self, data: dict):
         await self._bot.wait_until_ready()
 
@@ -302,6 +315,8 @@ class Node:
            to be applied to your track once it plays.
         """
 
+        timestamp = None
+
         if not URL_REGEX.match(query) and not re.match(r"(?:ytm?|sc)search:.", query):
             query = f"{search_type}:{query}"
 
@@ -400,6 +415,18 @@ class Node:
                 )
             ]
 
+        # If YouTube url contains a timestamp, capture it for use later.
+
+        if (match := YOUTUBE_TIMESTAMP_REGEX.match(query)):
+            timestamp = float(match.group("time"))
+
+        # If query is a video thats part of a playlist, get the video and queue that instead
+        # (I can't tell you how much i've wanted to implement this in here)
+
+        if (match := YOUTUBE_PLAYLIST_REGEX.match(query)):   
+            query = match.group("video")
+   
+
         else:
             async with self._session.get(
                 url=f"{self._rest_uri}/loadtracks?identifier={quote(query)}",
@@ -433,20 +460,19 @@ class Node:
                     track_id=track["track"],
                     info=track["info"],
                     ctx=ctx,
-                    filters=filters
+                    filters=filters,
+                    timestamp=timestamp
                 )
                 for track in data["tracks"]
             ]
 
 
-
-
 class NodePool:
     """The base class for the node pool.
        This holds all the nodes that are to be used by the bot.
     """
-
-    _nodes = {}
+  
+    _nodes: dict = {}
 
     def __repr__(self):
         return f"<Pomice.NodePool node_count={self.node_count}>"

From 0152b4eca0dca0db3fb04c7ec62f416389e084e7 Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sun, 11 Dec 2022 21:14:39 -0500
Subject: [PATCH 08/12] make queue.get() not explictly return anything

---
 pomice/queue.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pomice/queue.py b/pomice/queue.py
index 97d0cf7..bdeca1f 100644
--- a/pomice/queue.py
+++ b/pomice/queue.py
@@ -182,7 +182,7 @@ class Queue(Iterable[Track]):
         return self._queue
 
 
-    def get(self) -> Track:
+    def get(self):
         """Return next immediately available item in queue if any.
         Raises QueueEmpty if no items in queue.
         """

From b42b360cfe32084dedc1cc4585b12323eabbd395 Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sun, 11 Dec 2022 21:22:31 -0500
Subject: [PATCH 09/12] forgot i actually had to set the timestamp variable lol

---
 pomice/objects.py | 2 +-
 pomice/pool.py    | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/pomice/objects.py b/pomice/objects.py
index aac262e..726dcff 100644
--- a/pomice/objects.py
+++ b/pomice/objects.py
@@ -32,7 +32,7 @@ class Track:
         self.info = info
         self.spotify = spotify
         self.filters: List[Filter] = filters
-        self.timestamp: Optional[float] = None
+        self.timestamp: Optional[float] = timestamp
 
         self.original: Optional[Track] = None if spotify else self
         self._search_type = search_type
diff --git a/pomice/pool.py b/pomice/pool.py
index 1f39198..66f1ab5 100644
--- a/pomice/pool.py
+++ b/pomice/pool.py
@@ -419,6 +419,7 @@ class Node:
 
         if (match := YOUTUBE_TIMESTAMP_REGEX.match(query)):
             timestamp = float(match.group("time"))
+            print(f"timestamp: {timestamp}")
 
         # If query is a video thats part of a playlist, get the video and queue that instead
         # (I can't tell you how much i've wanted to implement this in here)

From 507a4b246bac4ddda2ad492be60e2eb2b8c92bb6 Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sun, 11 Dec 2022 21:22:55 -0500
Subject: [PATCH 10/12] remove debug print

---
 pomice/pool.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pomice/pool.py b/pomice/pool.py
index 66f1ab5..1f39198 100644
--- a/pomice/pool.py
+++ b/pomice/pool.py
@@ -419,7 +419,6 @@ class Node:
 
         if (match := YOUTUBE_TIMESTAMP_REGEX.match(query)):
             timestamp = float(match.group("time"))
-            print(f"timestamp: {timestamp}")
 
         # If query is a video thats part of a playlist, get the video and queue that instead
         # (I can't tell you how much i've wanted to implement this in here)

From 0d00fe9f36c4b4c5fa25a01b5781dea2ae6e6630 Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Sun, 11 Dec 2022 21:26:35 -0500
Subject: [PATCH 11/12] whoops had that in the wrong place

---
 pomice/pool.py | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/pomice/pool.py b/pomice/pool.py
index 1f39198..3721fea 100644
--- a/pomice/pool.py
+++ b/pomice/pool.py
@@ -414,20 +414,20 @@ class Node:
                     filters=filters
                 )
             ]
-
-        # If YouTube url contains a timestamp, capture it for use later.
-
-        if (match := YOUTUBE_TIMESTAMP_REGEX.match(query)):
-            timestamp = float(match.group("time"))
-
-        # If query is a video thats part of a playlist, get the video and queue that instead
-        # (I can't tell you how much i've wanted to implement this in here)
-
-        if (match := YOUTUBE_PLAYLIST_REGEX.match(query)):   
-            query = match.group("video")
    
 
         else:
+            # If YouTube url contains a timestamp, capture it for use later.
+
+            if (match := YOUTUBE_TIMESTAMP_REGEX.match(query)):
+                timestamp = float(match.group("time"))
+
+            # If query is a video thats part of a playlist, get the video and queue that instead
+            # (I can't tell you how much i've wanted to implement this in here)
+
+            if (match := YOUTUBE_PLAYLIST_REGEX.match(query)):   
+                query = match.group("video")
+                
             async with self._session.get(
                 url=f"{self._rest_uri}/loadtracks?identifier={quote(query)}",
                 headers={"Authorization": self._password}

From ad91a8e2aedfe75015c62e2f5fd897850d9dead5 Mon Sep 17 00:00:00 2001
From: cloudwithax <nickisme14@gmail.com>
Date: Tue, 27 Dec 2022 22:23:38 -0500
Subject: [PATCH 12/12] add spotify recommendations

---
 pomice/exceptions.py       | 10 ++++++++++
 pomice/objects.py          | 11 ++++++++---
 pomice/player.py           | 11 +++++++++++
 pomice/pool.py             | 36 ++++++++++++++++++++++++++++++++++--
 pomice/spotify/__init__.py |  1 -
 pomice/spotify/client.py   | 34 ++++++++++++++++++++++++++++++++--
 pomice/spotify/objects.py  |  6 +++---
 7 files changed, 98 insertions(+), 11 deletions(-)

diff --git a/pomice/exceptions.py b/pomice/exceptions.py
index f244191..77c42b5 100644
--- a/pomice/exceptions.py
+++ b/pomice/exceptions.py
@@ -71,6 +71,16 @@ class InvalidSpotifyClientAuthorization(PomiceException):
     """No Spotify client authorization was provided for track searching."""
     pass
 
+class SpotifyRequestException(PomiceException):
+    """An error occurred when making a request to the Spotify API"""
+    pass
+
+
+class InvalidSpotifyURL(PomiceException):
+    """An invalid Spotify URL was passed"""
+    pass
+
+
 class QueueException(Exception):
     """Base Pomice queue exception."""
     pass
diff --git a/pomice/objects.py b/pomice/objects.py
index 726dcff..191a282 100644
--- a/pomice/objects.py
+++ b/pomice/objects.py
@@ -1,5 +1,6 @@
 import re
-from typing import List, Optional
+from typing import List, Optional, Union
+from discord import Member, User
 
 from discord.ext import commands
 
@@ -26,7 +27,8 @@ class Track:
         search_type: SearchType = SearchType.ytsearch,
         spotify_track = None,
         filters: Optional[List[Filter]] = None,
-        timestamp: Optional[float] = None
+        timestamp: Optional[float] = None,
+        requester: Optional[Union[Member, User]] = None
     ):
         self.track_id = track_id
         self.info = info
@@ -56,7 +58,10 @@ class Track:
 
         self.length = info.get("length")
         self.ctx = ctx
-        self.requester = self.ctx.author if ctx else None
+        if requester:
+            self.requester = requester
+        else:
+            self.requester = self.ctx.author if ctx else None
         self.is_stream = info.get("isStream")
         self.is_seekable = info.get("isSeekable")
         self.position = info.get("position")
diff --git a/pomice/player.py b/pomice/player.py
index 47b4f0b..1d5a10a 100644
--- a/pomice/player.py
+++ b/pomice/player.py
@@ -274,6 +274,15 @@ class Player(VoiceProtocol):
         """
         return await self._node.get_tracks(query, ctx=ctx, search_type=search_type, filters=filters)
 
+    async def get_recommendations(self, *, query: str, ctx: Optional[commands.Context] = None):
+        """
+        Gets recommendations from Spotify. Query must be a valid Spotify Track URL.
+
+        You can pass in a discord.py Context object to get a
+        Context object on all tracks that get recommended.
+        """
+        return await self._node.get_recommendations(query=query, ctx=ctx)
+
     async def connect(self, *, timeout: float, reconnect: bool, self_deaf: bool = False, self_mute: bool = False):
         await self.guild.change_voice_state(channel=self.channel, self_deaf=self_deaf, self_mute=self_mute)
         self._node._players[self.guild.id] = self
@@ -450,6 +459,8 @@ class Player(VoiceProtocol):
 
         if fast_apply:
             await self.seek(self.position)
+
+    
         
 
 
diff --git a/pomice/pool.py b/pomice/pool.py
index 3721fea..63fe7e8 100644
--- a/pomice/pool.py
+++ b/pomice/pool.py
@@ -22,10 +22,10 @@ from .exceptions import (
     InvalidSpotifyClientAuthorization,
     NodeConnectionFailure,
     NodeCreationError,
-    NodeException,
     NodeNotAvailable,
     NoNodesAvailable,
-    TrackLoadError
+    TrackLoadError,
+    SpotifyTrackLoadFailed
 )
 from .filters import Filter
 from .objects import Playlist, Track
@@ -466,6 +466,38 @@ class Node:
                 for track in data["tracks"]
             ]
 
+    async def get_recommendations(self, *, query: str, ctx: Optional[commands.Context] = None):
+        """
+        Gets recommendations from Spotify. Query must be a valid Spotify Track URL.
+
+        You can pass in a discord.py Context object to get a
+        Context object on all tracks that get recommended.
+        """
+        results = await self._spotify_client.get_recommendations(query=query)
+        tracks = [
+                Track(
+                    track_id=track.id,
+                    ctx=ctx,
+                    spotify=True,
+                    spotify_track=track,
+                    info={
+                        "title": track.name,
+                        "author": track.artists,
+                        "length": track.length,
+                        "identifier": track.id,
+                        "uri": track.uri,
+                        "isStream": False,
+                        "isSeekable": True,
+                        "position": 0,
+                        "thumbnail": track.image,
+                        "isrc": track.isrc
+                    },
+                    requester=self.bot.user
+                ) for track in results
+            ]
+
+        return tracks
+             
 
 class NodePool:
     """The base class for the node pool.
diff --git a/pomice/spotify/__init__.py b/pomice/spotify/__init__.py
index 3f012c5..4afb1c1 100644
--- a/pomice/spotify/__init__.py
+++ b/pomice/spotify/__init__.py
@@ -1,5 +1,4 @@
 """Spotify module for Pomice, made possible by cloudwithax 2021"""
 
-from .exceptions import *
 from .objects import *
 from .client import Client
diff --git a/pomice/spotify/client.py b/pomice/spotify/client.py
index 9b4ecae..9872715 100644
--- a/pomice/spotify/client.py
+++ b/pomice/spotify/client.py
@@ -6,7 +6,7 @@ import aiohttp
 import orjson as json
 
 
-from .exceptions import InvalidSpotifyURL, SpotifyRequestException
+from ..exceptions import InvalidSpotifyURL, SpotifyRequestException
 from .objects import * 
 
 GRANT_URL = "https://accounts.spotify.com/api/token"
@@ -16,6 +16,7 @@ SPOTIFY_URL_REGEX = re.compile(
 )
 
 
+
 class Client:
     """The base client for the Spotify module of Pomice.
        This class will do all the heavy lifting of getting all the metadata 
@@ -110,4 +111,33 @@ class Client:
                 ]
                 next_page_url = next_data["next"]
 
-            return Playlist(data, tracks)
\ No newline at end of file
+            return Playlist(data, tracks)
+
+    async def get_recommendations(self, *, query: str):
+        if not self._bearer_token or time.time() >= self._expiry:
+            await self._fetch_bearer_token()
+
+        result = SPOTIFY_URL_REGEX.match(query)
+        spotify_type = result.group("type")
+        spotify_id = result.group("id")
+
+        if not result:
+            raise InvalidSpotifyURL("The Spotify link provided is not valid.")
+
+        if not spotify_type == "track":
+            raise InvalidSpotifyURL("The provided query is not a Spotify track.")
+
+        request_url = REQUEST_URL.format(type="recommendation", id=f"?seed_tracks={spotify_id}")
+
+        async with self.session.get(request_url, headers=self._bearer_headers) as resp:
+            if resp.status != 200:
+                raise SpotifyRequestException(
+                    f"Error while fetching results: {resp.status} {resp.reason}"
+                )
+
+            data: dict = await resp.json(loads=json.loads)
+
+        tracks = [Track(track) for track in data["tracks"]]
+
+        return tracks
+
diff --git a/pomice/spotify/objects.py b/pomice/spotify/objects.py
index b52b4d5..f46bb69 100644
--- a/pomice/spotify/objects.py
+++ b/pomice/spotify/objects.py
@@ -5,10 +5,10 @@ class Track:
     """The base class for a Spotify Track"""
 
     def __init__(self, data: dict, image = None) -> None:
-        self.name = data["name"]
+        self.name: str = data["name"]
         self.artists = ", ".join(artist["name"] for artist in data["artists"])
-        self.length = data["duration_ms"]
-        self.id = data["id"]
+        self.length: float = data["duration_ms"]
+        self.id: str = data["id"]
 
         if data.get("external_ids"):
             self.isrc = data["external_ids"]["isrc"]