pybuzzsprout 0.2.0

Python client library and CLI for the Buzzsprout podcast API

pybuzzsprout

A Python client library and CLI for the Buzzsprout podcast hosting API.

Install

pip install pybuzzsprout

Quick Start

Python Library

from pybuzzsprout import BuzzsproutClient

client = BuzzsproutClient(api_key="your-token")

# List your podcasts
podcasts = client.podcasts.list()
for p in podcasts:
    print(f"{p.id}: {p.title}")

# List episodes for a podcast
episodes = client.episodes.list(podcast_id=140447)

# Create an episode
episode = client.episodes.create(
    podcast_id=140447,
    title="My New Episode",
    audio_url="https://example.com/episode.mp3",
    private=True,
)

# Update an episode
client.episodes.update(
    podcast_id=140447,
    episode_id=episode.id,
    title="Better Title",
    private=False,
)

CLI

export BUZZSPROUT_API_KEY=your-token

# Discover your podcasts
buzzsprout podcasts list

# List episodes
buzzsprout episodes list --podcast-id 140447

# Get episode details
buzzsprout episodes get --podcast-id 140447 --episode-id 788881

# Create an episode
buzzsprout episodes create --podcast-id 140447 --title "My Episode" --audio-url https://example.com/audio.mp3 --private

# Update an episode
buzzsprout episodes update --podcast-id 140447 --episode-id 788881 --title "New Title" --public

# JSON output for scripting / agents
buzzsprout episodes list --podcast-id 140447 --json

Authentication

Get your API token from your Buzzsprout account settings.

Pass it directly:

client = BuzzsproutClient(api_key="your-token")

Or set the environment variable:

export BUZZSPROUT_API_KEY=your-token

License

MIT — Embersilk LLC