api
Radio

Documentation

1. Get List of Radio Stations

Endpoint:

GET https://api.i-as.dev/api/radio

Response:

This endpoint returns a list of radio stations with details like their ID, name, genres, current track, number of listeners, and stream URL.

[
  {
    "radioId": "string",
    "logo": "url",
    "name": "string",
    "genres": ["string"],
    "currentTrack": "string",
    "listeners": "string",
    "like": "string",
    "streamUrl": "url"
  }
  // More data
]

Fields:

  • radioId: The unique identifier for the radio station.
  • logo: The URL of the radio station's logo.
  • name: The name of the radio station.
  • genres: An array of genres associated with the radio station.
  • currentTrack: The current track being played on the radio station.
  • listeners: The current number of listeners.
  • like: The number of likes or ratings the radio station has.
  • streamUrl: The URL to stream the radio station.

2. Get List of Radio Cities

Endpoint:

GET https://api.i-as.dev/api/radio/city

Response:

This endpoint returns a list of cities with available radio stations.

[
  {
    "name": "string",
    "url": "url"
  }
  // More data
]

Fields:

  • name: The name of the city.
  • url: The URL to access radio stations from this city.

3. Get Details of Radio Stations by City

Endpoint:

GET https://api.i-as.dev/api/radio/city/{city-slug}

Response:

This endpoint returns the list of radio stations available in a specific city, identified by {city-slug}.

[
  {
    "radioId": "string",
    "logo": "url",
    "name": "string",
    "genres": ["string"],
    "currentTrack": "string",
    "listeners": "string",
    "like": "string",
    "streamUrl": "url"
  }
  // More data
]

Fields:

  • radioId: The unique identifier for the radio station.
  • logo: The URL of the radio station's logo.
  • name: The name of the radio station.
  • genres: An array of genres associated with the radio station.
  • currentTrack: The current track being played on the radio station.
  • listeners: The current number of listeners.
  • like: The number of likes or ratings the radio station has.
  • streamUrl: The URL to stream the radio station.

4. Search Radio Stations by Query

Endpoint:

GET https://api.i-as.dev/api/radio/search/{query}

Response:

This endpoint allows searching for radio stations by a query term (e.g., radio station name or genre).

[
  {
    "radioId": "string",
    "logo": "url",
    "name": "string",
    "genres": ["string"],
    "currentTrack": "string",
    "listeners": "string",
    "like": "string",
    "streamUrl": "url"
  }
  // More data
]

Fields:

  • radioId: The unique identifier for the radio station.
  • logo: The URL of the radio station's logo.
  • name: The name of the radio station.
  • genres: An array of genres associated with the radio station.
  • currentTrack: The current track being played on the radio station.
  • listeners: The current number of listeners.
  • like: The number of likes or ratings the radio station has.
  • streamUrl: The URL to stream the radio station.

Notes:

  • Replace {city-slug} and {query} with the actual city identifier or search term when calling the respective endpoints.
  • The response may contain multiple radio stations or cities, depending on the available data.