| Name | spotipy JSON |
| Version |
2.23.0
JSON |
| download |
| home_page | https://spotipy.readthedocs.org/ |
| Summary | A light weight Python library for the Spotify Web API |
| upload_time | 2023-04-07 17:38:39 |
| maintainer | |
| docs_url | None |
| author | @plamere |
| requires_python | |
| license | MIT |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Spotipy
##### A light weight Python library for the Spotify Web API
 [](https://spotipy.readthedocs.io/en/latest/?badge=latest)
## Documentation
Spotipy's full documentation is online at [Spotipy Documentation](http://spotipy.readthedocs.org/).
## Installation
```bash
pip install spotipy
```
alternatively, for Windows users
```bash
py -m pip install spotipy
```
or upgrade
```bash
pip install spotipy --upgrade
```
## Quick Start
A full set of examples can be found in the [online documentation](http://spotipy.readthedocs.org/) and in the [Spotipy examples directory](https://github.com/plamere/spotipy/tree/master/examples).
To get started, install spotipy and create an app on https://developers.spotify.com/.
Add your new ID and SECRET to your environment:
### Without user authentication
```python
import spotipy
from spotipy.oauth2 import SpotifyClientCredentials
sp = spotipy.Spotify(auth_manager=SpotifyClientCredentials(client_id="YOUR_APP_CLIENT_ID",
client_secret="YOUR_APP_CLIENT_SECRET"))
results = sp.search(q='weezer', limit=20)
for idx, track in enumerate(results['tracks']['items']):
print(idx, track['name'])
```
### With user authentication
A redirect URI must be added to your application at [My Dashboard](https://developer.spotify.com/dashboard/applications) to access user authenticated features.
```python
import spotipy
from spotipy.oauth2 import SpotifyOAuth
sp = spotipy.Spotify(auth_manager=SpotifyOAuth(client_id="YOUR_APP_CLIENT_ID",
client_secret="YOUR_APP_CLIENT_SECRET",
redirect_uri="YOUR_APP_REDIRECT_URI",
scope="user-library-read"))
results = sp.current_user_saved_tracks()
for idx, item in enumerate(results['items']):
track = item['track']
print(idx, track['artists'][0]['name'], " – ", track['name'])
```
## Reporting Issues
For common questions please check our [FAQ](FAQ.md).
You can ask questions about Spotipy on
[Stack Overflow](http://stackoverflow.com/questions/ask).
Don’t forget to add the *Spotipy* tag, and any other relevant tags as well, before posting.
If you have suggestions, bugs or other issues specific to this library,
file them [here](https://github.com/plamere/spotipy/issues).
Or just send a pull request.
Raw data
{
"_id": null,
"home_page": "https://spotipy.readthedocs.org/",
"name": "spotipy",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "@plamere",
"author_email": "paul@echonest.com",
"download_url": "https://files.pythonhosted.org/packages/eb/64/3be93b08e95c4e9fd8270d7ef750efc6d454b6479adb91f36f316770f53e/spotipy-2.23.0.tar.gz",
"platform": null,
"description": "# Spotipy\n\n##### A light weight Python library for the Spotify Web API\n\n [](https://spotipy.readthedocs.io/en/latest/?badge=latest)\n\n## Documentation\n\nSpotipy's full documentation is online at [Spotipy Documentation](http://spotipy.readthedocs.org/).\n\n## Installation\n\n```bash\npip install spotipy\n```\n\nalternatively, for Windows users \n\n```bash\npy -m pip install spotipy\n```\n\nor upgrade\n\n```bash\npip install spotipy --upgrade\n```\n\n## Quick Start\n\nA full set of examples can be found in the [online documentation](http://spotipy.readthedocs.org/) and in the [Spotipy examples directory](https://github.com/plamere/spotipy/tree/master/examples).\n\nTo get started, install spotipy and create an app on https://developers.spotify.com/.\nAdd your new ID and SECRET to your environment:\n\n### Without user authentication\n\n```python\nimport spotipy\nfrom spotipy.oauth2 import SpotifyClientCredentials\n\nsp = spotipy.Spotify(auth_manager=SpotifyClientCredentials(client_id=\"YOUR_APP_CLIENT_ID\",\n client_secret=\"YOUR_APP_CLIENT_SECRET\"))\n\nresults = sp.search(q='weezer', limit=20)\nfor idx, track in enumerate(results['tracks']['items']):\n print(idx, track['name'])\n```\n\n### With user authentication\n\nA redirect URI must be added to your application at [My Dashboard](https://developer.spotify.com/dashboard/applications) to access user authenticated features.\n\n```python\nimport spotipy\nfrom spotipy.oauth2 import SpotifyOAuth\n\nsp = spotipy.Spotify(auth_manager=SpotifyOAuth(client_id=\"YOUR_APP_CLIENT_ID\",\n client_secret=\"YOUR_APP_CLIENT_SECRET\",\n redirect_uri=\"YOUR_APP_REDIRECT_URI\",\n scope=\"user-library-read\"))\n\nresults = sp.current_user_saved_tracks()\nfor idx, item in enumerate(results['items']):\n track = item['track']\n print(idx, track['artists'][0]['name'], \" \u2013 \", track['name'])\n```\n\n## Reporting Issues\n\nFor common questions please check our [FAQ](FAQ.md).\n\nYou can ask questions about Spotipy on\n[Stack Overflow](http://stackoverflow.com/questions/ask).\nDon\u2019t forget to add the *Spotipy* tag, and any other relevant tags as well, before posting.\n\nIf you have suggestions, bugs or other issues specific to this library,\nfile them [here](https://github.com/plamere/spotipy/issues).\nOr just send a pull request.\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A light weight Python library for the Spotify Web API",
"version": "2.23.0",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2eaf0cec225516021689d0e12d615f4d9da8277ad97d032ea5ecdb556a501d32",
"md5": "7afc80a1f4661ef14fb86fb57a9b3ad0",
"sha256": "da850fbf62faaa05912132d2886c293a5fbbe8350d0821e7208a6a2fdd6a0079"
},
"downloads": -1,
"filename": "spotipy-2.23.0-py2-none-any.whl",
"has_sig": false,
"md5_digest": "7afc80a1f4661ef14fb86fb57a9b3ad0",
"packagetype": "bdist_wheel",
"python_version": "py2",
"requires_python": null,
"size": 29069,
"upload_time": "2023-04-07T17:38:36",
"upload_time_iso_8601": "2023-04-07T17:38:36.295273Z",
"url": "https://files.pythonhosted.org/packages/2e/af/0cec225516021689d0e12d615f4d9da8277ad97d032ea5ecdb556a501d32/spotipy-2.23.0-py2-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b8e84c099f9431ec9a86f576b344702cd4446d1ff7df09b172dc1951f25d58b1",
"md5": "d60401c31519500bcfe69d90cfddccdd",
"sha256": "6bf8b963c10d0a3e51037e4baf92e29732dee36b2a1f1b7dcc8cd5771e662a5b"
},
"downloads": -1,
"filename": "spotipy-2.23.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d60401c31519500bcfe69d90cfddccdd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 29068,
"upload_time": "2023-04-07T17:38:38",
"upload_time_iso_8601": "2023-04-07T17:38:38.177383Z",
"url": "https://files.pythonhosted.org/packages/b8/e8/4c099f9431ec9a86f576b344702cd4446d1ff7df09b172dc1951f25d58b1/spotipy-2.23.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "eb643be93b08e95c4e9fd8270d7ef750efc6d454b6479adb91f36f316770f53e",
"md5": "18195faca386f743e12ad03a4ee06d88",
"sha256": "0dfafe08239daae6c16faa68f60b5775d40c4110725e1a7c545ad4c7fb66d4e8"
},
"downloads": -1,
"filename": "spotipy-2.23.0.tar.gz",
"has_sig": false,
"md5_digest": "18195faca386f743e12ad03a4ee06d88",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 38541,
"upload_time": "2023-04-07T17:38:39",
"upload_time_iso_8601": "2023-04-07T17:38:39.760032Z",
"url": "https://files.pythonhosted.org/packages/eb/64/3be93b08e95c4e9fd8270d7ef750efc6d454b6479adb91f36f316770f53e/spotipy-2.23.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-07 17:38:39",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "spotipy"
}
