About
This is an unofficial wrapper for the Radio Garden API. It allows you to search for radio stations and retrieve their live MP3 stream URLs. Please note that this API is not officially supported by Radio Garden, and usage may be subject to their terms of service.
Disclaimer: This tool is for educational and personal use only. Respect copyright laws and the rights of content creators.
API Documentation
Search for Stations
Endpoint: GET /api/search?q={query}
Description: Searches for radio stations matching the provided query.
Parameters:
q(required): Search query string (e.g., "BBC", "Jazz")
Example Request:
GET /api/search?q=BBC
Example Response:
{
"hits": {
"hits": [
{
"_source": {
"page": {
"url": "/listen/bbc-world-service/FXyhz9Xk",
"title": "BBC World Service",
"subtitle": "London, United Kingdom"
}
}
}
]
}
}Get Stream URL
Endpoint: GET /api/stream/{channelId}
Description: Retrieves the MP3 stream URL for a specific channel.
Parameters:
channelId(required): The channel ID extracted from search results
Example Request:
GET /api/stream/FXyhz9Xk
Example Response:
{
"streamUrl": "http://stream.live.vc.bbcmedia.co.uk/bbc_world_service"
}