{"ok":true,"site":"radio-browser","host":"radio-browser.info","about":"radio-browser.info is a free, community-maintained directory of about 62,000 internet radio stations. This CLI searches stations, shows station details, check results, clicks and edit history, lists countries, tags, languages and codecs, reads global stats, and can get a stream URL (which counts a click) or vote for a station.","commands":[{"command":"search-stations","summary":"Search radio stations by name, tag, country code, language or codec, with sorting and offset pagination","params":[{"name":"name","type":"string","description":"Substring match on the station name"},{"name":"tagList","type":"string","description":"Comma-separated tags. A station must have all of them, e.g. 'jazz' or 'jazz,smooth jazz'"},{"name":"countrycode","type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. FR, US, DE"},{"name":"language","type":"string","description":"Language name in lowercase English, e.g. german, english"},{"name":"codec","type":"string","description":"Stream codec, e.g. MP3, AAC, AAC+, OGG"},{"name":"order","type":"string","description":"Sort field","oneOf":["clickcount","votes","clicktimestamp","clicktrend","name","bitrate","random"],"default":"clickcount"},{"name":"reverse","type":"string","description":"'true' sorts descending, 'false' ascending","oneOf":["true","false"],"default":"true"},{"name":"hidebroken","type":"string","description":"'true' leaves out stations whose last check failed","oneOf":["true","false"],"default":"true"},{"name":"offset","type":"number","description":"Number of results to skip, for pagination","default":0},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/search-stations"},{"command":"get-station","summary":"Get full details of one station by its stationuuid","params":[{"name":"uuid","type":"string","required":true,"description":"Station UUID (stationuuid from search-stations)"}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/get-station"},{"command":"get-station-checks","summary":"List recent stream health checks for a station (ok flag, codec, bitrate, timing, metadata)","params":[{"name":"uuid","type":"string","required":true,"description":"Station UUID"}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/get-station-checks"},{"command":"get-check-steps","summary":"Get the individual check steps (URLs tried, URL type, errors) for one or more stations","params":[{"name":"uuids","type":"string","required":true,"description":"Comma-separated station UUIDs"}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/get-check-steps?uuids=2ce23ee2-95c5-407d-9df8-54c3cdde2825"},{"command":"get-station-clicks","summary":"List click (play) events for a station within a recent time window","params":[{"name":"uuid","type":"string","required":true,"description":"Station UUID"},{"name":"seconds","type":"number","description":"Look-back window in seconds (86400 = last 24h)","default":86400}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/get-station-clicks"},{"command":"get-station-history","summary":"Get the edit history (all recorded versions) of a station","params":[{"name":"uuid","type":"string","required":true,"description":"Station UUID"}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/get-station-history"},{"command":"list-countries","summary":"List country codes with station counts, optionally filtered by a substring","params":[{"name":"filter","type":"string","description":"Optional substring of the country code, e.g. 'DE'. Empty lists all"},{"name":"order","type":"string","description":"Sort field","oneOf":["stationcount","name"],"default":"stationcount"},{"name":"reverse","type":"boolean","description":"true sorts descending","default":true},{"name":"hidebroken","type":"boolean","description":"Leave broken stations out of the counts","default":true},{"name":"api_limit","type":"number","description":"Maximum entries returned (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":100}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/list-countries"},{"command":"list-tags","summary":"List station tags with station counts. Pass a filter for tag suggestions matching a substring","params":[{"name":"filter","type":"string","description":"Optional substring to match tag names, e.g. 'rock'. Empty lists all"},{"name":"order","type":"string","description":"Sort field","oneOf":["stationcount","name"],"default":"stationcount"},{"name":"reverse","type":"boolean","description":"true sorts descending","default":true},{"name":"hidebroken","type":"boolean","description":"Leave broken stations out of the counts","default":true},{"name":"api_limit","type":"number","description":"Maximum entries returned (the tags page uses 1000, suggestions use 5) (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":100}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/list-tags"},{"command":"list-languages","summary":"List languages (with ISO 639 code) and station counts, optionally filtered by a substring","params":[{"name":"filter","type":"string","description":"Optional substring of the language name, e.g. 'germ'. Empty lists all"},{"name":"order","type":"string","description":"Sort field","oneOf":["stationcount","name"],"default":"stationcount"},{"name":"reverse","type":"boolean","description":"true sorts descending","default":true},{"name":"hidebroken","type":"boolean","description":"Leave broken stations out of the counts","default":true},{"name":"api_limit","type":"number","description":"Maximum entries returned (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":100}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/list-languages"},{"command":"list-codecs","summary":"List stream codecs (MP3, AAC+, OGG, …) with station counts, optionally filtered by a substring","params":[{"name":"filter","type":"string","description":"Optional substring of the codec name, e.g. 'AAC'. Empty lists all"},{"name":"order","type":"string","description":"Sort field","oneOf":["stationcount","name"],"default":"stationcount"},{"name":"reverse","type":"boolean","description":"true sorts descending","default":true},{"name":"hidebroken","type":"boolean","description":"Leave broken stations out of the counts","default":true},{"name":"api_limit","type":"number","description":"Maximum entries returned (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":100}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/list-codecs"},{"command":"get-stats","summary":"Get global directory stats: station, broken-station, tag, language and country counts, plus recent clicks","params":[],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/get-stats"},{"command":"play-station","summary":"Get a station's playable stream URL. This registers one click (play) for the station on radio-browser","params":[{"name":"uuid","type":"string","required":true,"description":"Station UUID"}],"exampleUrl":"https://clify-dev.netlify.app/radio-browser/play-station"}]}