Skip to main content

Shoutcast Radio Directory API

Project description

Shoutcast Radio Directory API

Actions Status

A Python module for interacting with the shoutcast radio directory api. For Python >= 3.

Getting started

Installation via pip:

$ pip install shoutcast-api

Manual installation:

$ git clone https://github.com/eadwinCode/shoutcast_api
$ cd shoutcast_api
$ python setup.py install

The module consists of the following sub-modules:

Usage:

from shoutcast_api import get_stations_by_now_playing
response = stations.get_stations_by_now_playing(api_key, ct='john legend', limit=100, br=128)

Error handling

All functions may raise exceptions if incorrect parameters are passed or other problems. If it is server-error APIException exception will be raised.

SHOUTcast API Usage Restrictions

By using our API, you agree to the following restrictions which are in place to protect the SHOUTcast brand and ServiceMark.

  • Please do not hammer the servers. We request reasonable usage and recommend that you utilize local caching.
  • Do not copy the shoutcast.com design, make your design as original as possible.
  • We reserve the right to revoke access for DevIDs which abuse the system.
  • We have included official logos for your usage below (with more to follow later).

API License Terms

For License Terms, here

Project details


Download files

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

Source Distribution

shoutcast-api-1.0.8.tar.gz (8.2 kB view hashes)

Uploaded Source

Built Distribution

shoutcast_api-1.0.8-py3-none-any.whl (10.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page