README

An unofficial library to retrieve radio stations from the internet-radio.com catalog.

Stations by genre

Use the ::getStationsByGenre($genre, $offset, $limit, $sortBy) method to retrieve stations labeled with a specific musical genre.

use AdinanCenci\InternetRadio\InternetRadio;

$internetRadio = new InternetRadio();
$stations = $internetRadio->getStationsByGenre('metal');

It will return an array as such:

[
    {
        "id": "idobihowl", 
        "name": "idobi Howl", 
        "description": "metal, hardcore", 
        "homepage": "http://idobiradio.com/", 
        "playlist": "http://69.46.88.26:80/listen.pls", 
        "currentlyPlaying": "SYLOSIS - Fear the World", 
        "listeners": "2527", 
        "bitRate": "128"
    }, 
    {
        "id": "knac.com", 
        "name": "KNAC.COM", 
        "description": "metal", 
        "homepage": "http://www.knac.com", 
        "playlist": "http://198.178.123.14:7346/listen.pls?sid=1", 
        "currentlyPlaying": "NAZARETH - HAIR OF THE DOG", 
        "listeners": "268", 
        "bitRate": "128"
    }, 
    {
        "id": "metalexpressradio", 
        "name": "Metal Express Radio", 
        "description": "heavy metal", 
        "homepage": "http://www.metalexpressradio.com", 
        "playlist": "http://5.135.154.69:11590/listen.pls?sid=1", 
        "currentlyPlaying": "David T. Chastain - Burning Passion", 
        "listeners": "199", 
        "bitRate": "192"
    }
    ...
    ...
    ...

Search stations

Use the ::searchStations($query, $offset, $limit, $sortBy) method to search stations based on their names.

Genres

The ::getGenres() returns an array of musical genres used to label radio stations. Use this values to search stations with the ::getStationsByGenre() method.

$genres = $internetRadio->getGenres();
/*
'50s', 
'60s', 
'Acid House', 
'Bass', 
'Jazz', 
'Metal',
...
...
...
*/

Notes

At the moment of this writing, internet-radio.com does not provide an API, the information provided by this library is being scraped from the official website and this library may stop working in the day they decide to update their page.

License

MIT