https://github.com/eadwincode/shoutcast_api
Python SHOUTcast Radio Directory API
https://github.com/eadwincode/shoutcast_api
internet-radio internet-radio-stations python radio radio-api shoutcast-api
Last synced: 4 months ago
JSON representation
Python SHOUTcast Radio Directory API
- Host: GitHub
- URL: https://github.com/eadwincode/shoutcast_api
- Owner: eadwinCode
- License: mit
- Created: 2020-03-02T19:04:49.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T03:43:41.000Z (about 3 years ago)
- Last Synced: 2025-09-25T15:18:52.048Z (4 months ago)
- Topics: internet-radio, internet-radio-stations, python, radio, radio-api, shoutcast-api
- Language: Python
- Homepage:
- Size: 101 KB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Shoutcast Radio Directory API
[](https://github.com/eadwinCode/shoutcast_api/actions)
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:
* `stations` ([docs](docs/stations.md))
* `genres` ([docs](docs/genres.md))
Usage:
```python
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](https://shoutcast.com/Legal/LicenseAPI)