Skip to main content

Buzzsprout Podcasts Python class

Project description

A Python Buzzsprout class.

Prerequisites

  • Python 3.7 and above
  • A Buzzsprout account (and your API token)

Summary

Provide an API Token and a Profile ID, to create a Buzzsprout object containing all episodes for that profile matching the given parameters.

Installation

pip install buzzsprout

Getting started

Instantiate the Buzzsprout class.

$ from buzzsprout import Buzzsprout
$ buzzsprout = Buzzsprout()

You then pass your profile id and token into the get method. By default, this will pull all episodes:

$ buzzsprout.get('profileid='PROFILEID', token='TOKEN')

Attributes

  • title
  • audio_url
  • episode_url
  • description
  • summary
  • artist
  • tags
  • published_at
  • episode_number
  • season_number

Filtering

You can currently filter by:

  • Date
  • Tag
  • Random

(and these can be used in combination).

To return only episodes newer than 2019-03-01

$ recent_episodes = buzzsprout.get(profileid='PROFILEID', token='TOKEN', datefilter='2019-03-01')

To return only episodes that contain the tag "Interviews"

$ interview_episodes = buzzsprout.get(profileid='PROFILEID', token='TOKEN', tagfilter='Interviews')

To return one random episode from the results, use the random switch

$ random_episode = buzzsprout.get(profileid='PROFILEID', token='TOKEN', random=True)

Things to note

Weirdly, Buzzsprout's API does not return an episode URL. I have therefore implemented a slightly hacky solution which modifies the audio URL. By default this URL will not use any custom URL's you have set. I have therefore implemented a workaround. If you pass in your custom URL, the episode_url property will be updated:

$ custom_url_episode = buzzsprout.get(profileid='PROFILEID', token='TOKEN', random=True, customurl='subdomain.example.com')

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for buzzsprout, version 0.22
Filename, size File type Python version Upload date Hashes
Filename, size buzzsprout-0.22.tar.gz (3.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page