Spotify Connector

This is a simple library for connecting to the inofficial Spotify podcast API. It can be used to export data from the dashboard.

Supported Data

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

Usage as a library

from spotify_importer import SpotifyImporter

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

1. Create a virtual environment:

python -m venv venv

2. Activate the virtual environment:

source venv/bin/activate

3. Install the dependencies:

pip install -r requirements.txt

4. Create an environment file and fill in the required values. Run source .env to load the environment variables.

cp .env.example .env
source .env

5. Run the script:

python -m spotifyconnector

6. Publish the package:

python setup.py sdist bdist_wheel
twine upload dist/*