• Internet radio
• Mobile Applications
• Maintenance
• API Description
• Getting started
• Authentication
• What's on air
• Playlists
• Podcasts

The history of tracks on the radio, the last track in the output of this API is the track that is playing right now on the radio.

Example

import requests

response = requests.get("https://demoaccount.s02.radio-tochka.com:8080/api/v2/history/?limit=1&offset=0&server=1")
print(response.json())

Example Output

{
   "count":500,
   "next":"https://demoaccount.s02.radio-tochka.com:8080/api/v2/history/?limit=1&offset=1&server=1",
   "previous":"None",
   "results":[
      {
         "album":"Ozzmosis (Expanded Edition)",
         "all_music_id":1190,
         "author":"Ozzy Osbourne",
         "author_other":"None",
         "comment":"None",
         "composer":"None",
         "dj_name":"AutoDJ",
         "genre":"None",
         "id":11552,
         "img_fetched":true,
         "img_large_url":"https://demoaccount.s02.radio-tochka.com:8080/media/tracks/trackImage1190_large.jpg",
         "img_medium_url":"https://demoaccount.s02.radio-tochka.com:8080/media/tracks/trackImage1190_medium.jpg",
         "img_url":"https://demoaccount.s02.radio-tochka.com:8080/media/tracks/trackImage1190.jpg",
         "isrc":"None",
         "jingle_id":"None",
         "label":"None",
         "length":296347,
         "lyricist":"",
         "metadata":"Ozzy Osbourne - I Just Want You",
         "n_listeners":0,
         "performance_type":"None",
         "playlist_title":"All music",
         "publisher":"None",
         "title":"I Just Want You",
         "ts":1733763534000,
         "year":"None"
      }
   ]
}

Description

• album: track album
• all_music_id: the ID of the track in the server’s music library. If the track is a jingle, this parameter is null. If the track was played live and not from the Auto DJ’s music library, this parameter is null.
• author: track artist
• author_other: co-author
• comment: track comments
• composer: composer
• dj_name: the name of the DJ who played this track.
• genre: genre of composition
• id: track history record ID (unique value)
• img_fetched: the system attempted to download the track cover from music services (Apple Music, Spotify, MusicBrainz) if it is missing in the mp3 tags of the file
• img_large_url: - the URL of the track cover image in the maximum resolution for this track with no compression
• img_medium_url: - a medium-sized version of the image that the system obtained by compressing the original image to 500x500 pixels
• img_url: a mini track cover, usually in a resolution of 100x100 pixels
• isrc: ISRC track code (used in royalty reports)
• jingle_id: if the track is a jingle, this parameter contains the jingle ID in the Auto-DJ content database
• label: label
• length: track duration in milliseconds
• lyricist: the author of the lyrics
• metadata: the final metadata with which the track was aired is usually the “Artist - Name”, but the metadata may also contain other data, depending on the format of the meta data, which is specified in the “Settings” section of the radio panel: for example, the name of the DJ
• n_listeners: the number of listeners on the radio at the time the track started playing
• performance_type: type of performance: vocal, instrumental, reading, etc.
• playlist_title: the name of the playlist that was on the air can be null for jingles and for tracks played during live streams
• publisher: publisher
• title: track name
• ts: the broadcasting time (integer) in milliseconds, timezone: UTC
• year: track year