🎵 RadioDJ Now Playing API

Real-time track information for your radio stations

API Health Check
Submit Endpoint
Now Playing Endpoint

Overview

This API allows RadioDJ automation software to submit now playing information and enables websites to retrieve current and recently played tracks for display.

Base URL: https://api.ventraradio.com/api/

Endpoints

POST GET Submit Now Playing

/submit.php or /?action=submit

Parameters:

station_id (required)

Your unique station identifier

api_key (required)

Station API key for authentication

title (required)

Track title

artist (required)

Artist name

album (optional)

Album name

duration (optional)

Track duration in seconds

Example Request:

curl -X POST https://api.ventraradio.com/api/submit.php \
  -d "station_id=station1" \
  -d "api_key=your-api-key" \
  -d "title=Livin' On A Prayer" \
  -d "artist=Bon Jovi" \
  -d "album=Slippery When Wet"

Example Response:

{
  "success": true,
  "message": "Now playing information recorded successfully",
  "id": 12345
}

GET Get Now Playing

/nowplaying.php or /?action=nowplaying

Parameters:

station_id (required)

Station to retrieve tracks from

limit (optional)

Number of tracks to return (default: 5, max: 50)

artwork (optional)

Include artwork URLs (default: true)

Example Request:

curl "https://api.ventraradio.com/api/nowplaying.php?station_id=station1&limit=5"

Example Response:

{
  "success": true,
  "station": "Ventra Radio Main",
  "station_id": "station1",
  "tracks": [
    {
      "title": "Livin' On A Prayer",
      "artist": "Bon Jovi",
      "album": "Slippery When Wet",
      "image": "https://api.ventraradio.com/artwork/abc123.jpg",
      "time": "Just now",
      "played_at": "2025-10-12 15:30:45",
      "duration": 249
    }
  ],
  "count": 1
}

Authentication

The submit endpoint requires station authentication using station_id and api_key parameters. Contact your system administrator to obtain these credentials.

The now playing endpoint is public and does not require authentication, but requires a valid station_id.

Rate Limiting

There are no strict rate limits, but duplicate track submissions within 10 seconds are automatically filtered to prevent flooding.

Error Responses

All errors return a JSON response with the following format:

{
  "error": "Error message description",
  "success": false
}

Common HTTP Status Codes:

RadioDJ Configuration

To configure RadioDJ to submit now playing information:

  1. Open RadioDJ and go to Options → Now Playing
  2. Select the Web tab
  3. Enter URL: https://api.ventraradio.com/api/submit.php
  4. Select Method: POST (or GET if POST doesn't work)
  5. Add these parameters:
    • station_id = your station ID
    • api_key = your API key
    • title = $songname$
    • artist = $artist$
    • album = $album$
    • duration = $duration$

Support

For RadioDJ software support, visit: radiodj.ro

For API issues, contact your system administrator or check the server logs.