README
Authentication
<p>To use our API you must subscribe to one of our pricing plans on rapidapi.com</p>
<p>For all your requests you must send in headers the key provided.<br />
<code>X-RapidAPI-Key</code></p>
<pre><code> “header” => [
‘X-RapidAPI-Key: XXXXXXXXXXXXXXXXXXXXXXXXX’
]
</code></pre>
Radio Stations
<p>The Radio Stations are Updated Daily and new Stations are constantly added to the Database</p>
<p>The Country Code <code>{country}</code> are unique in the API and follow the usual two-characters country list (Ex : FR, GB, IT…)</p>
<table>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>country</td>
<td>string</td>
<td>true</td>
<td>2 characters | Fails if field has anything other than alphabetic characters | Ex : FR, GB, IT… </td>
</tr>
<tr>
<td>query</td>
<td>string</td>
<td>false</td>
<td>Word or Sentence | Filter all stations for the name that match the query | Ex : “Fox news”, “cadena”… </td>
</tr>
<tr>
<td>page</td>
<td>integer</td>
<td>false</td>
<td>Request the specific page regarding the pagination of the results | Default: 0 </td>
</tr>
</table>
<h3>Requests</h3>
<h4><code>GET</code><b>STATIONS</b> by name</h4>
<p>Allows to retrieve all the stations that matches the provided name query</p>
<pre><code>get(“https://radio-world-50-000-radios-stations.p.rapidapi.com/v1/radios/searchByName?query=fm”);
</code></pre>
<h4><code>GET</code><b>STATIONS</b> by country</h4>
<p>Allows to retrieve all the stations available for a specific country</p>
<p>You can find the available <code>{country_code}</code> by using the endpoint [country]</p>
<pre><code>get(“https://radio-world-50-000-radios-stations.p.rapidapi.com/v1/radios/searchByCountry?query=fr”);
</code></pre>
<h4><code>GET</code><b>TOP STATIONS</b> by country</h4>
<p>Allows to retrieve all the stations available for a specific country, ordered by popularity</p>
<p>You can find the available <code>{country_code}</code> by using the endpoint [country]</p>
<pre><code>get(“https://radio-world-50-000-radios-stations.p.rapidapi.com/v1/radios/getTopByCountry?query=fr”);
</code></pre>
<h4><code>GET</code><b>Countries</b> </h4>
<p>Get all countries available</p>
<pre><code>get(“https://radio-world-50-000-radios-stations.p.rapidapi.com/v1/countries/getAll”);
</code></pre>
<h4><code>GET</code><b>Genres</b> </h4>
<p>Get all genres available</p>
<pre><code>get(“https://radio-world-50-000-radios-stations.p.rapidapi.com/v1/genres/getAll”);
</code></pre>
<h4>Examples</h4>
<pre><code>get(“https://radio-world-50-000-radios-stations.p.rapidapi.com/v1/radios/trialSearch?query=cadena&page=6”);
</code></pre>
<h3>Response Model</h3>
<pre><code>{
{
“has_more”: false,
“page_count”: 6,
“radios”: [
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/12797.jpg”,
“name”: “Cadena COPE Oviedo”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.mp3”,
“genre”: “Talk,Variety”,
“countryCode”: “es”,
“channel_id”: 12797
},
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/12848.jpg”,
“name”: “Cadena COPE Ourense”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.m3u”,
“genre”: “Talk,Variety”,
“countryCode”: “es”,
“channel_id”: 12848
},
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/13338.jpg”,
“name”: “Cadena Sur 107.3 FM”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.m3u”,
“genre”: “”,
“countryCode”: “pe”,
“channel_id”: 13338
},
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/13374.jpg”,
“name”: “Cadena SER Palencia”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.m3u”,
“genre”: “Talk,Sports,News”,
“countryCode”: “es”,
“channel_id”: 13374
},
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/13614.jpg”,
“name”: “Cadena SER Cinco Villas”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.m3u”,
“genre”: “Talk,News”,
“countryCode”: “es”,
“channel_id”: 13614
},
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/13877.jpg”,
“name”: “Cadena SER Murcia”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.m3u”,
“genre”: “Talk,Sports,News”,
“countryCode”: “es”,
“channel_id”: 13877
},
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/14043.jpg”,
“name”: “Cadena COPE Cáceres”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.m3u”,
“genre”: “Talk,Variety”,
“countryCode”: “es”,
“channel_id”: 14043
},
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/14408.jpg”,
“name”: “Cadena SER”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.m3u”,
“genre”: “Talk,Sports,News”,
“countryCode”: “es”,
“channel_id”: 14408
},
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/14437.jpg”,
“name”: “Cadena COPE Almería”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.m3u”,
“genre”: “Talk,Variety”,
“countryCode”: “es”,
“channel_id”: 14437
},
{
“image_url”: “https://mypromotions.sfo2.cdn.digitaloceanspaces.com/radios/14538.jpg”,
“name”: “Cadena SER Axarquía”,
“uri”: “https://XXXXXXXXXXXXXXXXXXXXXXXXX.m3u”,
“genre”: “Talk,News”,
“countryCode”: “es”,
“channel_id”: 14538
}
]
}
</code></pre>
