Spotify Connector

This is a simple library for connecting to the inofficial Spotify podcast API.
It can be used to export data from your dashboard at https://podcasters.spotify.com/home.

Supported Data

• List of episodes
• Starts and streams
• Listeners
• Followers
• Gender
• Age
• Country
• Episode performance

Usage as a library

from spotifyconnector import SpotifyConnector

connector = SpotifyConnector(
    client_id="your_client_id",
    client_secret="your_client_secret",
    redirect_uri="your_redirect_uri",
    refresh_token="your_refresh_token",
)

# Get podcast metadata
connector.metadata()

# Get the list of episodes
episodes = connector.episodes()

# Get the list of listeners
listeners = connector.listeners()

# Get the list of followers
followers = connector.aggregate()

# Get the performance of an episode
performance = connector.performance("episode_id")

# ...

Development

We are using Pipenv for virtualenv and dev dependency management. With Pipenv installed:

1. Install your locally checked out code in editable mode, including its dependencies, and all dev dependencies into a virtual environment:

pipenv sync --dev

2. Create an environment file and fill in the required values:

cp .env.example .env

3. Run the script in the virtual environment, which will automatically load your .env:

pipenv run spotifyconnector

To add a new dependency for use during the development of this library:

pipenv install --dev $package

To add a new dependency necessary for the correct operation of this library, add the package to the install_requires section of ./setup.py, then:

pipenv install

To publish the package:

python setup.py sdist bdist_wheel
twine upload dist/*