podcast-api 1.0.10

Python bindings for the Listen Notes Podcast API

Podcast API Python Library

The Podcast API Python library provides convenient access to the Listen Notes Podcast API from applications written in the Python language.

Simple and no-nonsense podcast search & directory API. Search the meta data of all podcasts and episodes by people, places, or topics.

Documentation

See the Listen Notes Podcast API docs.

Installation

You don't need this source code unless you want to modify the package. If you just want to use the package, please run:

pip install --upgrade podcast-api

Install from source with:

make && source venv/bin/activate

Requirements

• Python 3.5+

Usage

The library needs to be configured with your account's API key which is available in your Listen API Dashboard. Set api_key to its value:

from listennotes import podcast_api

api_key = 'a6a1f7ae6a4a4cf7a208e5ba********'

client = podcast_api.Client(api_key=api_key)

response = client.search(q='star wars')

print(response.json())

If api_key is None, then we'll connect to a mock server that returns fake data for testing purposes.

You can see all available API endpoints and parameters on the API Docs page at listennotes.com/api/docs/.

Handling exceptions

Unsuccessful requests raise exceptions. The class of the exception will reflect the sort of error that occurred.

All exception classes can be found in this file.

And you can see some sample code here.