Rocksky
  1. scrobbles
Rocksky
  • Overview
  • Introduction
  • FAQ
  • How-Tos
    • Migrating to Rocksky Scrobble API
    • Use Rocksky with Claude Desktop
  • CLI
    • Overview
    • Commands
      • login
      • mcp
      • whoami
      • nowplaying
      • scrobbles
      • search
      • stats
      • artists
      • albums
      • tracks
      • scrobble
      • create apikey
      • help
  • API Reference
    • albums
      • Get User's Albums
      • Get Album
      • Get Several Albums
    • artists
      • Get User's Artists
      • Get Artist
      • Get Several Artists
    • charts
      • Get Scrobbles Per Day
    • playlists
      • Get User's Playlists
      • Get Playlist
    • scrobbles
      • Get Scrobbles
        GET
      • Get User's Scrobbles
        GET
      • Save 'Now Playing' Song
        POST
      • Get 'Now Playing' Song
        GET
    • users
      • Find User Profile
    • tracks
      • Get User's Tracks
      • Get Track
      • Get Several Tracks
    • search
      • Search for Item
    • likes
      • Get User's Liked Songs
  1. scrobbles

Save 'Now Playing' Song

POST
/now-playing
Notify Rocksky that a user has started listening to a track

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
title
string 
required
album
string 
required
artist
string 
required
albumArtist
string 
required
duration
integer 
required
trackNumber
integer 
required
releaseDate
string 
required
year
integer 
required
discNumber
integer 
required
composer
string 
optional
albumArt
string 
optional
label
string 
optional
spotifyLink
string 
optional
copyrightMessage
string 
optional
artistPicture
string 
optional
Example
{
  "title": "Baby",
  "album": "Shadows",
  "artist": "Cannons",
  "albumArtist": "Cannons",
  "duration": 195837,
  "trackNumber": 1,
  "releaseDate": "2019-07-12",
  "year": 2019,
  "discNumber": 1,
  "composer": "Ryan Clapham, Paul Davis, Michelle Lewis",
  "albumArt": "https://cdn.rocksky.app/covers/dde98fa66ef8081029ffb8f24d643c89.jpg"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.rocksky.app/now-playing' \
--header 'Content-Type: application/json' \
--data-raw '{
  "title": "Baby",
  "album": "Shadows",
  "artist": "Cannons",
  "albumArtist": "Cannons",
  "duration": 195837,
  "trackNumber": 1,
  "releaseDate": "2019-07-12",
  "year": 2019,
  "discNumber": 1,
  "composer": "Ryan Clapham, Paul Davis, Michelle Lewis",
  "albumArt": "https://cdn.rocksky.app/covers/dde98fa66ef8081029ffb8f24d643c89.jpg"
}'

Responses

🟢200Success
application/json
Body
object {0}
Example
{}
🟠401Unauthorized
Previous
Get User's Scrobbles
Next
Get 'Now Playing' Song
Built with