{"id":20391108,"url":"https://github.com/aditya76-git/spotiscrape-spotify-api","last_synced_at":"2025-10-16T07:07:46.704Z","repository":{"id":181433568,"uuid":"666778140","full_name":"aditya76-git/spotiscrape-spotify-api","owner":"aditya76-git","description":"SpotiScrape - Unofficial Spotify API - Access Account Information, User Details, Search Content, Manipulate Playlists, Control Player, Get Track and Playlist Information all with SpotiScrape","archived":false,"fork":false,"pushed_at":"2023-08-28T16:33:51.000Z","size":87,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-24T01:33:05.770Z","etag":null,"topics":["api","python","python3","spotify","spotify-api","spotify-playlist","spotify-unofficial-api","spotify-web-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aditya76-git.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-15T14:45:46.000Z","updated_at":"2025-03-17T22:58:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"c719ca6a-6750-49f2-a9d7-26f72274fd26","html_url":"https://github.com/aditya76-git/spotiscrape-spotify-api","commit_stats":null,"previous_names":["aditya76-git/spotiscrape-spotify-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aditya76-git/spotiscrape-spotify-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya76-git%2Fspotiscrape-spotify-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya76-git%2Fspotiscrape-spotify-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya76-git%2Fspotiscrape-spotify-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya76-git%2Fspotiscrape-spotify-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aditya76-git","download_url":"https://codeload.github.com/aditya76-git/spotiscrape-spotify-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya76-git%2Fspotiscrape-spotify-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279164409,"owners_count":26117692,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-16T02:00:06.019Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","python","python3","spotify","spotify-api","spotify-playlist","spotify-unofficial-api","spotify-web-api"],"created_at":"2024-11-15T03:28:52.879Z","updated_at":"2025-10-16T07:07:46.672Z","avatar_url":"https://github.com/aditya76-git.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\r\n\r\n![Logo](https://i.imgur.com/qtyX2iLh.png)\r\n\u003cdiv style=\"text-align:center;\"\u003e\r\n  \u003ca href=\"https://github.com/aditya76-git\"\u003eaditya76-git\u003c/a\u003e /\r\n  \u003ca href=\"https://github.com/aditya76-git/spotiscrape-spotify-api\"\u003espotiscrape-spotify-api\u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\n\u003cbr /\u003e\r\n\r\n\u003c!-- \u003cimg src=\"https://i.imgur.com/y3L6XfN.png\" align=\"right\" /\u003e --\u003e\r\n\r\n# SpotiScrape - SPOTIFY API\r\nUnlock Spotify Music Database and seamlessly access and extract music data from Spotify’s vast catalog with SpotiScrape, the ultimate API for developers and music enthusiasts.\r\n\r\nAccess Account Information, User Details, Search Content, Manipulate Playlists, Control Player, Get Track and Playlist Information all with SpotiScrape\r\n\r\n\r\n\r\n## 📋Details\r\n\r\n- 👤 ACCOUNT INFORMATION\r\n  - [Get Account Data](#get-account-data)\r\n- 🏠 USER LIBRARY\r\n  - [Get Home Page Data](#get-home-page-data)\r\n  - [Get Library Data](#get-library-data)\r\n- 🧑 USER\r\n  - [Get User Profile Details](#get-user-profile-details)\r\n  - [Get Top Artists](#get-top-artists)\r\n  - [Get Top Tracks](#get-top-tracks)\r\n  - [Get Connections (Followings or Followers)](#get-connections)\r\n  - [Check if artist(s) are in the user's library](#check-artists)\r\n  - [Check if track(s) are in the user's library](#check-tracks)\r\n- 🎵 TRACK\r\n  - [Get Track Info](#get-track-info)\r\n  - [Get Poster URL](#get-poster-url)\r\n  - [Get Recommended Tracks](#get-recommended-tracks)\r\n  - [Get Track Metadata](#get-track-metadata)\r\n  - [Get Streaming URL, PSSH, fileID of Track](#get-streaming-data)\r\n  - [Get Track Credits](#get-track-credits)\r\n- 🔍 SEARCH\r\n  - [Get Search Info](#get-search-info)\r\n- 🎶 LYRICS\r\n  - [Get Lyrics Info](#get-lyrics-info)\r\n- 🎤 ARTIST\r\n  - [Get Artist Info](#get-artist-info)\r\n  - [Get Artist Discography](#get-artist-discography)\r\n  - [Follow Artist](#follow-artist)\r\n  - [UnFollow Artist](#unfollow-artist)\r\n- 🎧 PLAYER\r\n  - [Get Recently Played](#get-recently-played)\r\n  - [Get Liked Songs](#get-liked-songs)\r\n  - [Add to Queue](#add-to-queue)\r\n  - [Like Song](#like-song)\r\n  - [UnLike Song](#unlike-song)\r\n  - [Play Song](#play-song)\r\n  - [Pause Song](#pause-song)\r\n  - [Enable Repeat On Player](#enable-repeat)\r\n  - [Enable Repeat of Current Track On Player](#enable-repeat-one)\r\n  - [Disable Repeat On Player](#disable-repeat)\r\n  - [Enable Shuffle on Player](#enable-shuffle)\r\n  - [Disable Shuffle on Player](#disable-shuffle)\r\n  - [Get Devices Info](#get-device-info)\r\n- 📃 PLAYLIST\r\n  - [Get Playlist Info](#get-playlist-info)\r\n  - [Move Items in Playlist](#move-items-in-playlist)\r\n  - [Re-Order Items in Playlist](#reorder-items-in-playlist)\r\n  - [Add Track to Playlist](#add-track-to-playlist)\r\n  - [Remove Track from Playlist](#remove-track-from-playlist)\r\n  - [Pin Playlist](#pin-playlist)\r\n  - [UnPin Playlist](#unpin-playlist)\r\n  - [List Public Playlists of a User](#list-public-playlist)\r\n  - [Edit Playlist Details](#edit-playlist-details)\r\n\r\n\r\n## ⚠️ Disclaimer\r\n\r\nPlease note that the `spotiscrape` package is provided as-is and is not officially endorsed or supported by `Spotify`. While we have taken care to ensure that the package interacts with the Spotify API in a secure and compliant manner, we cannot guarantee the safety of your Spotify account.\r\n\r\nBy using the `spotiscrape` package, you acknowledge and agree that you are responsible for any actions taken with your Spotify account, and you use the package at your own risk. We recommend using the package responsibly\r\n\r\nWe are not liable for any potential consequences that may arise from using the `spotiscrape` package, including but not limited to `account suspension`, `data loss`, or any other `issues` related to your `Spotify` account.\r\n\r\nIt's important to exercise `caution` and ensure that you keep your `sensitive information`, such as the `sp_dc` cookie, `private` and `secure`. If you have any concerns or questions, please refer to the documentation or seek assistance from the community.\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n## ⚙️Installation\r\n\r\nOpen your terminal or command prompt and enter the following command:\r\n\r\n\r\n\r\n```bash\r\npip install git+https://github.com/aditya76-git/spotiscrape-spotify-api@main\r\n```\r\n\u003e **Note:** To use spotiscrape you need to have a Active Spotify Account \r\n\r\n## 🚀Initialization\r\n\r\nTo get started, you need to initialize an instance of the `SpotiScrape` class by passing your Spotify DC Cookie as an argument. Make sure to replace `\"YOUR_SPOTIFY_DC_COOKIE\"` with your actual `Spotify DC Cookie`.\r\n\r\n\r\n```python3\r\nfrom spotiscrape import SpotiScrape\r\nspotify = SpotiScrape(\"YOUR_SPOTIFY_DC_COOKIE\")\r\n```\r\n\r\n## 🔍 How to Find sp_dc cookie?\r\n\r\n- `sp_dc` cookie is required to authenticate against `Spotify` in order to have access to the required services.\r\n- Using any extensions like `Cookie-Editor` can easily help you find it\r\n- [Extension Link - Chrome WEB Store](https://chrome.google.com/webstore/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm)\r\n\r\n![Finding the sp_dc Cookie Value](https://camo.githubusercontent.com/d71ac89c29072c5e913e78900892a918030cfe9d1fe7bc1c1f9a00d59a0d39ae/68747470733a2f2f696b2e696d6167656b69742e696f2f67797a766c6177647a2f50726f6a656374732f7379726963732f6f734e587537373537485f4c70654830726650512e706e67 \"Finding the sp_dc Cookie Value\")\r\n\r\n\r\n\u003e **Note:** While cookies can contain sensitive information, the sp_dc cookie value is required for authentication and direct communication with the Spotify API within the scope of this open-source project. Rest assured that your sp_dc cookie will not be sent to any external server; it is solely used for interacting with Spotify's services through the project's codebase. However, caution is advised when sharing this cookie value outside the context of this project, as it could potentially lead to unauthorized access to your Spotify account.\r\n\r\n\r\n## 👤ACCOUNT INFORMATION\r\n#### \u003ca id=\"get-account-data\"\u003e\u003c/a\u003e➡️ Get Account Data\r\n\r\n```python3\r\nspotify.get_account_info()\r\n```\r\n\r\n\r\nGet Account Information of the authenticated User\r\n\r\n## 🏠USER LIBRARY\r\n#### \u003ca id=\"get-home-page-data\"\u003e\u003c/a\u003e➡️ Get Home Page Data\r\n\r\n```python3\r\nspotify.get_home_page_info()\r\n```\r\n\r\nRetrieves information about the user's home page.\r\n\r\n#### \u003ca id=\"get-library-data\"\u003e\u003c/a\u003e➡️ Get Library Data\r\n\r\n```python3\r\nspotify.get_library(offset=0, limit=20)\r\n```\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `offset` | `int` | **Optional**. The offset for pagination. Default is 0. |0  |\r\n| `limit` | `int` | **Optional**. The number of tracks to retrieve. Default is 50. |20  |\r\n\r\nGet Libraray Data of the autheticated user's account.\r\n\r\n## 🧑USER\r\n\r\n\r\n#### \u003ca id=\"get-user-profile-details\"\u003e\u003c/a\u003e➡️ Get User Profile Details\r\n\r\n```python3\r\nspotify.get_user_profile_details(userURL=\"https://open.spotify.com/user/31m4en72cpcracygwoxaiitbr2ba\", limit=10)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `userURL` | `string` | **Optional**. URL of the user's profile. Default is None (authenticated user). |  https://open.spotify.com/user/31m4en72cpcracygwoxaiitbr2ba or None|\r\n| `limit` | `int` | **Optional**. The maximum number of playlists, artists, and episodes to retrieve. Default is 10. | 5 |\r\n\r\nRetrieves profile details for the given user URL or authenticated user.\r\n\r\n#### \u003ca id=\"get-top-artists\"\u003e\u003c/a\u003e➡️ Get Top Artists\r\n\r\n```python3\r\nspotify.get_top_artists(offset=0, limit=10)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `offset` | `int` | **Optional**. The offset for pagination. Default is 0. |0  |\r\n| `limit` | `int` | **Optional**. The number of tracks to retrieve. Default is 10. |5  |\r\n\r\nRetrieves the authenticated user's top Artists.\r\n\r\n#### \u003ca id=\"get-top-tracks\"\u003e\u003c/a\u003e➡️ Get Top Tracks\r\n\r\n```python3\r\nspotify.get_top_tracks(offset=0, limit=10)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `offset` | `int` | **Optional**. The offset for pagination. Default is 0. |0  |\r\n| `limit` | `int` | **Optional**. The number of tracks to retrieve. Default is 10. |5  |\r\n\r\nRetrieves the authenticated user's top Tracks.\r\n\r\n#### \u003ca id=\"get-connections\"\u003e\u003c/a\u003e➡️ Get Connections (Followings or Followers)\r\n\r\n```python3\r\nspotify.get_connections(userURL=\"https://open.spotify.com/user/31m4en72cpcracygwoxaiitbr2ba\" , type=\"following\")\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `userURL` | `str` | **Optional**. URL of the user's profile. If not provided, uses the authenticated user's profile. | https://open.spotify.com/user/31m4en72cpcracygwoxaiitbr2ba  |\r\n| `type` | `str` | **Optional**. Type of connections to retrieve. Can be 'following' or 'followers'. Default is 'following'. |followers  |\r\n\r\nRetrieves user's connections (followings or followers).\r\n\r\n#### \u003ca id=\"check-artists\"\u003e\u003c/a\u003e➡️ Check if artist(s) are in the user's library.\r\nCheck if you are following the artists or not\r\n\r\n```python3\r\nspotify.are_artists_in_library(artistURLs)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `artistURLs` | `str` | **Required**. The URLs of the artists to check. If str provided then split by a + for the urls or else provide a list of artistURLs | https://link1.com/1+https://link1.com/2  |\r\n\r\nCheck if artists are in the user's library.\r\n\r\n#### \u003ca id=\"check-tracks\"\u003e\u003c/a\u003e➡️ Check if track(s) are in the user's library.\r\nCheck if you liked the songs or not\r\n\r\n```python3\r\nspotify.are_tracks_in_library(trackURLs)\r\n```\r\n\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURLs` | `str` | **Required**. The URLs of the tracks to check. If str provided then split by a + for the urls or else provide a list of artistURLs | https://link1.com/1+https://link1.com/2  |\r\n\r\n\r\nCheck if tracks are in the user's library.\r\n## 🎵TRACK\r\n#### \u003ca id=\"get-track-info\"\u003e\u003c/a\u003e➡️ Get Track Info\r\n\r\n```python3\r\nspotify.get_track_info(trackURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. Spotify Track URL | https://open.spotify.com/track/3taCbWWTilb7eNMsAzOBq4\r\n\r\nRetrieves information about a track from its URL.\r\n\r\n#### \u003ca id=\"get-poster-url\"\u003e\u003c/a\u003e➡️ Get Poster URL\r\n\r\n```python3\r\nspotify.get_poster_url(trackURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify song | https://open.spotify.com/track/3taCbWWTilb7eNMsAzOBq4 |\r\n\r\nRetrieves the poster URL for a track.\r\n\r\n#### \u003ca id=\"get-recommended-tracks\"\u003e\u003c/a\u003e➡️ Get Recommended Tracks\r\n\r\n```python3\r\nspotify.get_recommended_tracks(trackURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify song. | https://open.spotify.com/track/3taCbWWTilb7eNMsAzOBq4 |\r\n\r\nRetrieves recommended tracks based on the given track URL.\r\n\r\n#### \u003ca id=\"get-track-metadata\"\u003e\u003c/a\u003e➡️ Get Track Metadata\r\n\r\n```python3\r\nspotify.get_track_metadata(trackURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify song. | https://open.spotify.com/track/3taCbWWTilb7eNMsAzOBq4 |\r\n\r\nRetrieve metadata for a specific track.\r\n\r\n#### \u003ca id=\"get-streaming-data\"\u003e\u003c/a\u003e➡️ Get Streaming URL, PSSH, fileID of Track\r\n\r\n```python3\r\nspotify.get_streams(trackURL, format=\"MP4_128\").fileID\r\n```\r\n```python3\r\nspotify.get_streams(trackURL, format=\"MP4_128\").cdnURL\r\n```\r\n```python3\r\nspotify.get_streams(trackURL, format=\"MP4_128\").fileID\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify song. | https://open.spotify.com/track/3taCbWWTilb7eNMsAzOBq4 |\r\n| `format` | `str` | **Optional**. Default is MP4_128 (128Kbps Audio)| MP4_128 |\r\n\r\nRetrieve Streaming URL, PSSH, fileID of Track\r\n\r\n#### \u003ca id=\"get-track-credits\"\u003e\u003c/a\u003e➡️ Get Track Credits\r\n\r\n```python3\r\nspotify.get_track_credits(trackURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify song. | https://open.spotify.com/track/3taCbWWTilb7eNMsAzOBq4 |\r\n\r\nRetrieves credits information for a track.\r\n\r\n## 🔍SEARCH\r\n#### \u003ca id=\"get-search-info\"\u003e\u003c/a\u003e➡️ Search\r\n\r\n```python3\r\nspotify.search(query, filter=\"artists\")\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `query` | `str` | **Required**. Query to search for | Ed Sheeran |\r\n| `filter` | `str` | **Optional**. The type of filter to apply to the search results. Default is None. Can be topResults, albums, artists, episodes, genres, playlists, podcasts, audiobooks, users | artists |\r\n\r\nSearches for content on Spotify based on the provided query.\r\n## 🎶LYRICS\r\n#### \u003ca id=\"get-lyrics-info\"\u003e\u003c/a\u003e➡️ Get Lyrics\r\n\r\n```python3\r\nspotify.get_lyrics(trackURL, format=\"lrc\")\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify song | https://open.spotify.com/track/3taCbWWTilb7eNMsAzOBq4 |\r\n| `format` | `str` or `None` | **Optional**. format to get lyrics timestamp in | None or lrc |\r\n\r\nRetrieves lyrics for a track.\r\n\r\n\r\n## 🎤ARTIST\r\n#### \u003ca id=\"get-artist-info\"\u003e\u003c/a\u003e➡️ Get Artist Info\r\n\r\n```python3\r\nspotify.get_artist_info(artistURL, filter=\"profile\")\r\nspotify.get_artist_info(artistURL, topTracks=True)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `artistURL` | `str` | **Required**. artistURL of a Spotify Artist |https://open.spotify.com/artist/00FQb4jTyendYWaN8pK0wa  |\r\n| `filter` | `str` | **Optional**. Filter to narrow down the artist information. |discography, goods, profile, relatedContent, sharingInfo, stats, visuals  |\r\n| `topTracks` | `bool` | **Optional**. Whether to retrieve the artist's top tracks. Default is None.  |True|\r\n\r\nNote: filter and topTracks can't be applied at the same time\r\nRetrieves artist information for the given artist URL.\r\n\r\n#### \u003ca id=\"get-artist-discography\"\u003e\u003c/a\u003e➡️ Get Artist Discography\r\n\r\n```python3\r\nspotify.get_artist_discography_all(artistURL, limit=0, offset=50)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `artistURL` | `str` | **Required**. artistURL of a Spotify Artist |https://open.spotify.com/artist/00FQb4jTyendYWaN8pK0wa  |\r\n| `offset` | `int` | **Optional**. The offset for pagination. Default is 0. |0  |\r\n| `limit` | `int` | **Optional**. The number of tracks to retrieve. Default is 50. |20  |\r\n\r\n\r\n\r\nRetrieves the complete discography of an artist.\r\n\r\n#### \u003ca id=\"follow-artist\"\u003e\u003c/a\u003e➡️ Follow Artist\r\n\r\n```python3\r\nspotify.follow_artist(artistURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `artistURL` | `str` | **Required**. artistURL of a spotify Artist | https://open.spotify.com/artist/00FQb4jTyendYWaN8pK0wa  |\r\n\r\nFollow an artist.\r\n\r\n#### \u003ca id=\"unfollow-artist\"\u003e\u003c/a\u003e➡️ UnFollow Artist\r\n\r\n```python3\r\nspotify.unfollow_artist(artistURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `artistURL` | `str` | **Required**. artistURL of a spotify Artist | https://open.spotify.com/artist/00FQb4jTyendYWaN8pK0wa  |\r\n\r\nUnFollow an artist.\r\n\r\n## 🎧PLAYER\r\n#### \u003ca id=\"get-recently-played\"\u003e\u003c/a\u003e➡️ Get Recently Played\r\n\r\n```python3\r\nspotify.get_recently_played(offset=0, limit=50)\r\n```\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `offset` | `int` | **Optional**. The offset for pagination. Default is 0. |0  |\r\n| `limit` | `int` | **Optional**. The number of tracks to retrieve. Default is 50. |20  |\r\n\r\nRetrieves recently played tracks for the authenticated user.\r\n\r\n#### \u003ca id=\"get-liked-songs\"\u003e\u003c/a\u003e➡️ Get Liked Songs\r\n\r\n```python3\r\nspotify.get_liked_songs(offset=0, limit=50)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `offset` | `int` | **Optional**. The offset for pagination. Default is 0. |0  |\r\n| `limit` | `int` | **Optional**. The number of tracks to retrieve. Default is 50. |20  |\r\n\r\nRetrieves liked songs for the authenticated user.\r\n\r\n\r\n#### \u003ca id=\"add-to-queue\"\u003e\u003c/a\u003e➡️ Add to Queue\r\n\r\n```python3\r\nspotify.add_to_queue(trackURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `artistURL` | `str` | **Required**. trackURL of a spotify Track | https://open.spotify.com/track/3taCbWWTilb7eNMsAzOBq4  |\r\n\r\nAdd a track to the queue.\r\n\r\n#### \u003ca id=\"like-song\"\u003e\u003c/a\u003e➡️ Like Song\r\n\r\n```python3\r\nspotify.like_song(trackURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify Track | https://open.spotify.com/track/6MlIIJwO4FxnOlrpOrS4hU  |\r\n\r\nLike a Song\r\n\r\n#### \u003ca id=\"unlike-song\"\u003e\u003c/a\u003e➡️ UnLike Song\r\n\r\n```python3\r\nspotify.unlike_song(trackURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify Track | https://open.spotify.com/track/6MlIIJwO4FxnOlrpOrS4hU  |\r\n\r\nUnLike a Song\r\n\r\n#### \u003ca id=\"play-song\"\u003e\u003c/a\u003e➡️ Play Song\r\n\r\n```python3\r\nspotify.play_song()\r\n```\r\n\r\nPlay/Resume currently playing song on the player.\r\n\r\n#### \u003ca id=\"pause-song\"\u003e\u003c/a\u003e➡️ Pause Song\r\n\r\n```python3\r\nspotify.pause_song()\r\n```\r\n\r\nPause currently playing song on the player.\r\n\r\n#### \u003ca id=\"enable-repeat\"\u003e\u003c/a\u003e➡️ Enable Repeat On Player\r\n\r\n```python3\r\nspotify.enable_repeat()\r\n```\r\n\r\n\r\nEnable repeating of the current context\r\n\r\n#### \u003ca id=\"enable-repeat-one\"\u003e\u003c/a\u003e➡️ Enable Repeat of Current Track On Player\r\n\r\n```python3\r\nspotify.enable_repeat_one()\r\n```\r\n\r\nEnable repeating of the current track.\r\n\r\n#### \u003ca id=\"disable-repeat\"\u003e\u003c/a\u003e➡️ Disable Repeat On Player\r\n\r\n```python3\r\nspotify.disable_repeat()\r\n```\r\n\r\nDisable repeating.\r\n\r\n#### \u003ca id=\"enable-shuffle\"\u003e\u003c/a\u003e➡️ Enable Shuffle on Player\r\n\r\n```python3\r\nspotify.enable_shuffle()\r\n```\r\n\r\nEnable shuffling of the current context.\r\n\r\n#### \u003ca id=\"disable-shuffle\"\u003e\u003c/a\u003e➡️ Disable Shuffle on Player\r\n\r\n```python3\r\nspotify.disable_shuffle()\r\n```\r\n\r\nDisable shuffling of the current context.\r\n\r\n\r\n#### \u003ca id=\"get-device-info\"\u003e\u003c/a\u003e➡️ Devices\r\n\r\n```python3\r\nspotify.devices().prev_tracks\r\n```\r\n```python3\r\nspotify.devices().next_tracks\r\n```\r\n```python3\r\nspotify.devices().playback_speed\r\n```\r\n```python3\r\nspotify.devices().playback_quality\r\n```\r\n\r\nGet Devices Connected with the Authenticated Account and other Information like `list`, `prev_tracks`, `next_tracks`, `playback_speed`, `playback_quality`, `SMARTPHONE_DEVICE_ID`, `COMPUTER_DEVICE_ID`, `ALL_DATA`, `PRIMARY_DEVICE_ID`, `ACTIVE_DEVICE_ID`\r\n\r\n## 📃PLAYLIST\r\n\r\n#### \u003ca id=\"get-playlist-info\"\u003e\u003c/a\u003e➡️ Get Playlist Info\r\n\r\n```python3\r\nspotify.get_playlist_info(playlistURL, offset=0, limit=20)\r\n```\r\n\r\n| Parameter | Type | Description | Help |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `playlistURL` | `string` | **Required**. playlistURL of a spotify Playlist | https://open.spotify.com/playlist/33P0GdndkqEel2IgwNwb9F |\r\n| `offset` | `int` | **Optional**. The offset for pagination. Default is 0. |0  |\r\n| `limit` | `int` | **Optional**. The number of tracks to retrieve. Default is 25. |20  |\r\n\r\nRetrieves playlist information for the given playlist URL.\r\n\r\n#### \u003ca id=\"move-items-in-playlist\"\u003e\u003c/a\u003e➡️ Move Items in Playlist\r\n\r\n```python3\r\nspotify.move_items_in_playlist(playlistURL, trackURL, 5)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `playlistURL` | `str` | **Required**. playlistURL of a spotify Playlist | https://open.spotify.com/playlist/33P0GdndkqEel2IgwNwb9F  |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify track to be moved | https://open.spotify.com/track/6MlIIJwO4FxnOlrpOrS4hU  |\r\n| `newPosition` | `int` | **Required**. The new position for the track | https://open.spotify.com/track/6MlIIJwO4FxnOlrpOrS4hU  |\r\n\r\nMove a track within a playlist to a new position.\r\n\r\n#### \u003ca id=\"reorder-items-in-playlist\"\u003e\u003c/a\u003e➡️ Re-Order Items in Playlist\r\n\r\n```python3\r\nspotify.reorder_items_in_playlist(playlistURL, 1, 5)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `playlistURL` | `str` | **Required**. playlistURL of a spotify Playlist | https://open.spotify.com/playlist/33P0GdndkqEel2IgwNwb9F  |\r\n| `oldPosition` | `int` | **Required**. The current position of the track | 1  |\r\n| `newPosition` | `int` | **Required**. The new position for the track | 5  |\r\n\r\nReorder tracks within a playlist.\r\n\r\n\r\n#### \u003ca id=\"add-track-to-playlist\"\u003e\u003c/a\u003e➡️ Add Track to Playlist\r\n\r\n```python3\r\nspotify.add_track_to_playlist(trackURL, playlistURL, position=\"TOP\")\r\n```\r\n\r\n```python3\r\nspotify.add_track_to_playlist(trackURL, playlistURL, position=\"BOTTOM\")\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify Track  to be added | https://open.spotify.com/track/6MlIIJwO4FxnOlrpOrS4hU  |\r\n| `playlistURL` | `str` | **Required**. playlistURL of a spotify Track | https://open.spotify.com/playlist/33P0GdndkqEel2IgwNwb9F  |\r\n| `position` | `str` | **Required**. The position to add the track (TOP, BOTTOM, or None) Defaults to TOP | BOTTOM  |\r\n\r\nAdd a track to a playlist. (TOP or BOTTOM - Defaults to TOP)\r\n\r\n\r\n#### \u003ca id=\"remove-track-from-playlist\"\u003e\u003c/a\u003e➡️ Remove Track from Playlist\r\n\r\n```python3\r\nspotify.remove_track_from_playlist(trackURL, playlistURL)\r\n```\r\n\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `trackURL` | `str` | **Required**. trackURL of a spotify Track to be removed | https://open.spotify.com/track/6MlIIJwO4FxnOlrpOrS4hU  |\r\n| `playlistURL` | `str` | **Required**. playlistURL of a spotify Track | https://open.spotify.com/playlist/33P0GdndkqEel2IgwNwb9F  |\r\n\r\nRemove a track from a playlist.\r\n\r\n#### \u003ca id=\"pin-playlist\"\u003e\u003c/a\u003e➡️ Pin Playlist\r\n\r\n```python3\r\nspotify.pin_playlist(playlistURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `playlistURL` | `str` | **Required**. playlistURL of a spotify Track | https://open.spotify.com/playlist/33P0GdndkqEel2IgwNwb9F  |\r\n\r\nPin a playlist to your library.\r\n\r\n#### \u003ca id=\"unpin-playlist\"\u003e\u003c/a\u003e➡️ UnPin Playlist\r\n\r\n```python3\r\nspotify.unpin_playlist(playlistURL)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `playlistURL` | `str` | **Required**. playlistURL of a spotify Track | https://open.spotify.com/playlist/33P0GdndkqEel2IgwNwb9F  |\r\n\r\nUnpin a playlist from your library.\r\n\r\n#### \u003ca id=\"list-public-playlist\"\u003e\u003c/a\u003e➡️ List Public Playlists of a User\r\n\r\n```python3\r\nspotify.get_public_playlists(userURL=\"https://open.spotify.com/user/31m4en72cpcracygwoxaiitbr2ba\" , offset=0, limit=10)\r\n```\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `userURL` | `str` | **Required**. The URL of the user's profile. If None, gets authenticated User Public Playlists | https://open.spotify.com/user/31m4en72cpcracygwoxaiitbr2ba or None  |\r\n| `offset` | `int` | **Optional**. The offset for pagination. Default is 0. |0  |\r\n| `limit` | `int` | **Optional**. The maximum number of playlists to retrieve. Default is 200 |20  |\r\n\r\nGet public playlists of a user.\r\n\r\n#### \u003ca id=\"edit-playlist-details\"\u003e\u003c/a\u003e➡️ Edit Playlist Details\r\n\r\n```python3\r\nspotify.edit_playlist_details(playlistURL, newTitle, newDescription=\"New Description Edited Using Spotiscrape\")\r\n```\r\n\r\n```python3\r\nspotify.edit_playlist_details(playlistURL, newTitle)\r\n```\r\n\r\n\r\n| Parameter | Type | Description | Example |\r\n| :-------- | :--- | :---------- | :--- |\r\n| `playlistURL` | `str` | **Required**. playlistURL of a spotify Track | https://open.spotify.com/playlist/33P0GdndkqEel2IgwNwb9F  |\r\n| `newTitle` | `str` | **Required**. The new title for the playlist. | PHONK  |\r\n| `newDescription` | `str` or `None` | **Optional**. The new description for the playlist. | New Description Edited Using Spotiscrape Default to Blank  |\r\n\r\nEdit playlist details.\r\n\r\n## 🌟 Show Your Support\r\n\r\n- If you find this project useful or interesting, please consider giving it a star on GitHub. It's a simple way to show your support and help others discover the project.\r\n\r\n\r\n![Github Stars](https://img.shields.io/github/stars/aditya76-git/spotiscrape-spotify-api?style=social \"Github Stars\")\r\n\r\n## 👨‍💻Developement\r\n\r\nThank you for your interest in contributing to this project! There are several ways you can get involved:\r\n\r\n- **Opening Issues**: If you encounter a bug, have a feature request, or want to suggest an improvement, please open an issue. We appreciate your feedback!\r\n- **Cloning the Project**: To work on the project locally, you can clone the repository by running:\r\n```bash\r\ngit clone https://github.com/aditya76-git/spotiscrape-spotify-api.git\r\n```\r\n- **Sending Pull Requests**: If you'd like to contribute directly to the codebase, you can fork the repository, make your changes, and then send a pull request. We welcome your contributions!\r\n\r\n\r\n\r\n\r\n## 💻Authors\r\n\r\n- Copyright © 2023 - [aditya76-git](https://github.com/aditya76-git) / [spotiscrape-spotify-api](https://github.com/aditya76-git/spotiscrape-spotify-api)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faditya76-git%2Fspotiscrape-spotify-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faditya76-git%2Fspotiscrape-spotify-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faditya76-git%2Fspotiscrape-spotify-api/lists"}