SHOUTcast Radio Directory API - Revision history

DrO: Add missing supported parameters from some of the legacy methods

2014-12-03T14:29:13Z

Add missing supported parameters from some of the legacy methods

DrO at 22:56, 28 October 2014

2014-10-28T22:56:34Z

DrO: devid not needed on tunein

2012-03-20T12:48:18Z

devid not needed on tunein

Shashikreddy: /* Get Stations by Bitrate or Codec Type or Genre ID */

2011-10-13T15:51:19Z

‎Get Stations by Bitrate or Codec Type or Genre ID

Shashikreddy: /* Get Stations by Bitrate or Codec Type */

2011-10-13T15:49:58Z

‎Get Stations by Bitrate or Codec Type

Shashikreddy: /* Get Stations Based on Now Playing Info */

2011-10-13T15:46:21Z

‎Get Stations Based on Now Playing Info

Shashikreddy: /* Get Stations Based on Now Playing Info */

2011-10-13T15:45:40Z

‎Get Stations Based on Now Playing Info

Shashikreddy: /* Get Stations Based on Now Playing Info */

2011-10-13T15:27:12Z

‎Get Stations Based on Now Playing Info

DrO: Protected "SHOUTcast Radio Directory API" [edit=sysop:move=sysop]

2011-08-22T22:44:15Z

Protected "SHOUTcast Radio Directory API" [edit=sysop:move=sysop]

DrO: Tweaked display of examples and error codes to better match with the other docs provided. Removed invalid error messages

2011-05-11T12:32:45Z

Tweaked display of examples and error codes to better match with the other docs provided. Removed invalid error messages

Show changes

@@ Line 15: / Line 15: @@
 * limit - Limit the number of stations to return by passing the limit parameter.
 :'''Ex:''' <nowiki>http://api.shoutcast.com/legacy/Top500?k=[Your Dev ID]&limit=5</nowiki>
 '''<span style="color:#FF6600;">Sample XML Response:</span>''' (with limits)
@@ Line 57: / Line 65: @@
 :* Y is the number of results to return and X is the offset.
-* Filter by Codec type - Get stations which match the codec type requested.
+* br - Filter the stations based on bitrate specified.
 :'''Ex:''' <nowiki>http://api.shoutcast.com/legacy/stationsearch?k=[Your Dev ID]&search=ambient+beats&mt=audio/mpeg</nowiki>
 :MP3 = audio/mpeg and AAC+ = audio/aacp
 '''<span style="color:#FF6600;">Sample XML Response:</span>'''
 <source lang="xml">
 <stationlist>
-  <tunein base="/sbin/tunein-station.pls"></tunein>
+  <tunein base="/sbin/tunein-station.pls"/>
   <station name="Groove Salad: a nicely chilled plate of ambient beats and grooves. [SomaFM]-[SHOUTcast.com]"
    mt="audio/mpeg" id="6687" br="128" genre="Ambient Chill" ct="Audiomontage - Abyss" lc="241">
@@ Line 96: / Line 108: @@
 :* Y is the number of results to return and X is the offset.
-* Filter by Codec type - Get stations which match the codec type requested.
+* br - Filter the stations based on bitrate specified.
-:'''Ex:''' <nowiki>http://api.shoutcast.com/legacy/genresearch?k=[Your Dev ID]&genre=classic&&mt=audio/aacp</nowiki>
+:'''Ex:''' <nowiki>http://api.shoutcast.com/legacy/genresearch?k=[Your Dev ID]&genre=classic&br=64</nowiki>
-:MP3 = audio/mpeg and AAC+ = audio/aacp.
 '''<span style="color:#FF6600;">Sample XML Response:</span>'''
@@ Line 133: / Line 149: @@
 * c - The callback function to invoke in the response (appropriate for JSON responses only).
 * limit - Limits the no of results to be returned in output.
 '''<span style="color:#FF6600;">Sample XML Response:</span>'''
@@ Line 210: / Line 230: @@
+)
 </source>
 ==Get Stations by Bitrate or Codec Type or Genre ID==
@@ Line 274: / Line 295: @@
 * Stations based on genre id
 :<nowiki>http://api.shoutcast.com/station/advancedsearch?genre_id=1&limit=3&f=json&k=[Your Dev ID]</nowiki>
 '''<span style="color:#FF6600;">Sample JSON Response:</span>'''
@@ Line 338: / Line 360: @@
+)
 </source>
 ==Get Random Stations==
@@ Line 362: / Line 385: @@
 * genre - Genre to filter the station result.
 * limit - This API by default returns one station. To get more random stations, set the number of stations to return by passing the limit parameter.
 '''<span style="color:#FF6600;">Sample XML Response:</span>'''(Parameter Limit)
@@ Line 794: / Line 818: @@
 ==How To Tune Into A Station==
-To tune into a station, find the "id" of the station from the API results & make a call to <nowiki>http://yp.shoutcast.com/sbin/tunein-station.pls?id=[Station_id]</nowiki> by appending the station id.
+To tune into a station, find the "id" of the station from the API results & make a call to <nowiki>http://yp.shoutcast.com<base>?id=[Station_id]</nowiki> by appending the station id.
-'''Ex:''' If the station id is 1025, Call => <nowiki>http://yp.shoutcast.com/sbin/tunein-station.pls?id=1025</nowiki>
+'''Ex:''' If the station id is 1025, Call => <nowiki>http://yp.shoutcast.com/<base>?id=1025</nowiki>

← Older revision		Revision as of 22:56, 28 October 2014
Line 1:		Line 1:
		+	{{Template:NavBarSC}}
		+
		+
	=Get Stations on SHOUTcast Radio Directory=		=Get Stations on SHOUTcast Radio Directory=

← Older revision		Revision as of 12:48, 20 March 2012
Line 793:		Line 793:
	To tune into a station, find the "id" of the station from the API results & make a call to <nowiki>http://yp.shoutcast.com/sbin/tunein-station.pls?id=[Station_id]</nowiki> by appending the station id.		To tune into a station, find the "id" of the station from the API results & make a call to <nowiki>http://yp.shoutcast.com/sbin/tunein-station.pls?id=[Station_id]</nowiki> by appending the station id.

−	'''Ex:''' If the station id is 1025, Call => <nowiki>http://yp.shoutcast.com/sbin/tunein-station.pls?id=1025~~&k=[Your Dev ID]~~</nowiki>	+	'''Ex:''' If the station id is 1025, Call => <nowiki>http://yp.shoutcast.com/sbin/tunein-station.pls?id=1025</nowiki>

@@ Line 268: / Line 268: @@
 * Stations based on media type
 :<nowiki>http://api.shoutcast.com/station/advancedsearch?mt=mpeg&limit=3&f=json&k=[Your Dev ID]</nowiki>
 '''<span style="color:#FF6600;">Sample JSON Response:</span>'''

@@ Line 208: / Line 208: @@
 </source>
-==Get Stations by Bitrate or Codec Type==
+==Get Stations by Bitrate or Codec Type or Genre ID==
 '''<span style="color:#FF6600;">Description:</span>''' Get stations which match a particular bitrate or codec type.
@@ Line 217: / Line 217: @@
 :* Stations filtered by media type
 ::<nowiki>http://api.shoutcast.com/station/advancedsearch?mt=audio/mpeg&limit=10&f=xml&k=[Your Dev ID]</nowiki>
 :* Stations filtered by bitrate, media type & genre
@@ Line 227: / Line 230: @@
 * br - Filter the stations based on bitrate specified.
 * mt - Filter the stations based on media type specified.
 '''<span style="color:#FF6600;">Optional Parameters:</span>'''
@@ Line 247: / Line 251: @@
     <station name="TechnoBase.FM - 24h Techno, Dance, Trance, House and More - 128k MP3-[SHOUTcast.com]"
      mt="audio/mpeg"id="7429" br="128"genre="Techno Trance  Dance House"
-     ct="We aRe oNe" lc="8308" ml="8500" nsc="No"/>
+     ct="We aRe oNe" lc="8308" ml="8500" nsc="No" cst=""/>
     <station name="Absolutely Smooth Jazz - S K Y . F M - the world's smoothest
      jazz 24 hours a day-[SHOUTcast.com]" mt="audio/mpeg" id="948"br="96" genre="Soft Smooth Jazz"
-     ct="Jonathan Butler/Kirk Whalum - Dancing on the Shore" lc="6801" ml="10023" nsc="No"/>
+     ct="Jonathan Butler/Kirk Whalum - Dancing on the Shore" lc="6801" ml="10023" nsc="No" cst=""/>
+    .
+    .
@@ Line 278: / Line 282: @@
+     }
      {"nsc":"No","genre":"Pop Rock Top 40","id":"9907",mt":"audio/mpeg","name":".977 The
-      HitzChannel-[SHOUTcast.com]","lc":"11576","ml":"8500","br":"128","ct":"Chingy - Balla Baby"},
+      HitzChannel-[SHOUTcast.com]","cst":"","lc":"11576","ml":"8500","br":"128","ct":"Chingy - Balla Baby"},
       {"nsc":"No","genre":"Techno Trance
        DanceHouse","id":"7429","mt":"audio/mpeg",
@@ Line 286: / Line 290: @@
        {"nsc":"No","genre":"Soft Smooth Jazz","id":"948","mt":"audio/mpeg",
         "name":"Absolutely Smooth Jazz - S K Y . F M - the world's
-        smoothest jazz 24hours a day-[SHOUTcast.com]","lc":"6801","ml":"18600","br":"96",
+        smoothest jazz 24hours a day-[SHOUTcast.com]","cst":"","lc":"6801","ml":"18600","br":"96",
         "ct":"Jonathan Butler/Kirk Whalum - Dancing on the Shore"},
+     .
@@ Line 310: / Line 314: @@
+      }
       {"nsc":"No","genre":"Pop Rock Top 40","id":"9907",mt":"audio/mpeg","name":".977 The
-       HitzChannel-[SHOUTcast.com]","lc":"11576","ml":"8500","br":"128","ct":"Chingy - Balla Baby"},
+       HitzChannel-[SHOUTcast.com]","cst":"","lc":"11576","ml":"8500","br":"128","ct":"Chingy - Balla Baby"},
        {"sc":"No","genre":"Techno Trance
         DanceHouse","id":"7429","mt":"audio/mpeg",
@@ Line 318: / Line 322: @@
         {"nsc":"No","genre":"Soft Smooth Jazz","id":"948","mt":"audio/mpeg",
          "name":"Absolutely Smooth Jazz - S K Y . F M - the world's
-         smoothest jazz 24hours a day-[SHOUTcast.com]","lc":"6801","ml":"18600","br":"96",
+         smoothest jazz 24hours a day-[SHOUTcast.com]","cst":"","lc":"6801","ml":"18600","br":"96",
          "ct":"Jonathan Butler/Kirk Whalum - Dancing on the Shore"},
+      .
@@ Line 328: / Line 332: @@
+)
 </source>
 ==Get Random Stations==

@@ Line 194: / Line 194: @@
+      }
       {"nsc":"No","genre":"Various","id":"139549","mt":"audio/mpeg","name":"Dj Wouner-
-       RadioFusion-A novidadecome?a Aqui!-[SHOUTcast.com]","lc":"614","ml":"2100","br":"64",
+       RadioFusion-A novidadecome?a Aqui!-[SHOUTcast.com]","cst":"","lc":"614","ml":"2100","br":"64",
        "ct":"Rihanna Feat. Chris Brown& Jay-Z - Umbrella"},
        {"nsc":"No","genre":"Pop  Top  Rock  Funk Str","id":"998783",
         "mt":"audio/mpeg","name":"R?dio Stronda[ Digital ] Servidor
--[SHOUTcast.com]","lc":"243","ml":"70","br":"64","ct":"T.I. feat Rihanna - Live Your ife"},
+-[SHOUTcast.com]","cst":"","lc":"243","ml":"70","br":"64","ct":"T.I. feat Rihanna - Live Your ife"},
+      .
+      .

@@ Line 123: / Line 123: @@
 '''<span style="color:#FF6600;">Required Parameters:</span>'''
-* ct - Query to search in Now Playing node.
+* ct - Query to search in Now Playing node. This parameter also supports querying multiple artists in the same query by using "||". ex: ct=madonna||u2||beyonce up to 10 artists
 * f - the response format (xml, json, rss). You can choose xml,json or rss based results.
 * k - API Dev ID.
@@ Line 207: / Line 207: @@
+)
 </source>
 ==Get Stations by Bitrate or Codec Type==

← Older revision	Revision as of 22:44, 22 August 2011
(No difference)