Rocksky
  1. search
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 User's Scrobbles
      • Save 'Now Playing' Song
      • Get 'Now Playing' Song
    • users
      • Find User Profile
    • tracks
      • Get User's Tracks
      • Get Track
      • Get Several Tracks
    • search
      • Search for Item
        GET
    • likes
      • Get User's Liked Songs
  1. search

Search for Item

GET
/search
Get Rocksky catalog information about albums, artists, tracks or users that match a keyword string.

Request

Query Params
q
string 
required
Example:
daft punk

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 GET 'https://api.rocksky.app/search?q=daft punk'

Responses

🟢200OK
application/json
Body
totalCount
integer 
required
records
array [object {2}] 
required
table
string 
required
record
object 
required
Example
{
  "totalCount": 49,
  "records": [
    {
      "table": "artists",
      "record": {
        "name": "Daft Punk",
        "picture": "https://i.scdn.co/image/ab6761610000e5eba7bfd7835b5c1eee0c95fa6e",
        "sha256": "7a2ad6b68d51963bf2b27b491f38d7941fe2d21784f92ab1a79c8944dcdeaed3",
        "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlkzyo5ms2k",
        "xata_createdat": "2025-02-04T22:24:50.918Z",
        "xata_highlight": {
          "name": [
            "<em>Daft</em> <em>Punk</em>"
          ]
        },
        "xata_id": "rec_cuh97cn27jc7uetrla90",
        "xata_score": 22.092201,
        "xata_table": "artists",
        "xata_updatedat": "2025-03-03T12:15:32.442Z",
        "xata_version": 188,
        "apple_music_link": null,
        "biography": null,
        "born": null,
        "born_in": null,
        "died": null,
        "spotify_link": null,
        "tidal_link": null,
        "youtube_link": null
      }
    },
    {
      "table": "tracks",
      "record": {
        "album": "Gorillaz",
        "album_art": "https://i.scdn.co/image/ab67616d0000b273f6c46838e4425ea96e2562fe",
        "album_artist": "Gorillaz",
        "artist": "Gorillaz",
        "disc_number": 1,
        "duration": 98533,
        "label": "Parlophone UK",
        "sha256": "4c7935cf79314cc897c6e7bbb8f145a5a0bc65e70c744e927bd315a05b7ae2ce",
        "spotify_link": "https://open.spotify.com/track/6PuDxX1F5lw3jp6t8FsWvF",
        "title": "Punk",
        "track_number": 7,
        "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.song/3lj5cylhhuk2l",
        "xata_createdat": "2025-02-27T07:00:03.609Z",
        "xata_highlight": {
          "title": [
            "<em>Punk</em>"
          ]
        },
        "xata_id": "rec_cv00qsqb05cnm2fs5pi0",
        "xata_score": 10.607586,
        "xata_table": "tracks",
        "xata_updatedat": "2025-02-27T07:00:03.609Z",
        "xata_version": 0,
        "album_uri": null,
        "apple_music_link": null,
        "artist_uri": null,
        "composer": null,
        "copyright_message": null,
        "genre": null,
        "lyrics": null,
        "mb_id": null,
        "tidal_link": null,
        "youtube_link": null
      }
    },
    {
      "table": "tracks",
      "record": {
        "album": "Vampire Weekend",
        "album_art": "https://i.scdn.co/image/ab67616d0000b2737749a08ddab9edbe427e9876",
        "album_artist": "Vampire Weekend",
        "album_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3ljaiz73pdk2l",
        "artist": "Vampire Weekend",
        "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3ljaiz54qos2l",
        "disc_number": 1,
        "duration": 137760,
        "label": "XL Recordings",
        "sha256": "03d6e52a24834fab8c0caa49f53aa0653bf2511303bc8c7338f7e185c88518d1",
        "spotify_link": "https://open.spotify.com/track/2DrGEaqoruCSn0FffWCf5O",
        "title": "A-Punk",
        "track_number": 3,
        "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.song/3ljaiz266d22l",
        "xata_createdat": "2025-02-28T13:25:40.535Z",
        "xata_highlight": {
          "title": [
            "A-<em>Punk</em>"
          ]
        },
        "xata_id": "rec_cv0ril7u3busimrpkbrg",
        "xata_score": 9.048642,
        "xata_table": "tracks",
        "xata_updatedat": "2025-02-28T13:26:12.187Z",
        "xata_version": 2,
        "apple_music_link": null,
        "composer": null,
        "copyright_message": null,
        "genre": null,
        "lyrics": null,
        "mb_id": null,
        "tidal_link": null,
        "youtube_link": null
      }
    },
    {
      "table": "tracks",
      "record": {
        "album": "The Best Of - Volume One",
        "album_art": "https://i.scdn.co/image/ab67616d0000b273b034d912628fb636eedbf7c2",
        "album_artist": "Silverchair",
        "artist": "Silverchair",
        "disc_number": 2,
        "duration": 165373,
        "label": "Murmur Records",
        "sha256": "29d29b77dddbb2723d0cb6828c36a7c679a0e3dcd1f272d73e638be7ef96df9d",
        "spotify_link": "https://open.spotify.com/track/2duy4ye54wYZ3vN9C7GZmC",
        "title": "Punk Song 2",
        "track_number": 7,
        "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.song/3liyxbu6mx22l",
        "xata_createdat": "2025-02-25T13:19:49.213Z",
        "xata_highlight": {
          "title": [
            "<em>Punk</em> Song 2"
          ]
        },
        "xata_id": "rec_cuus6tab05cnm2frug20",
        "xata_score": 7.889206,
        "xata_table": "tracks",
        "xata_updatedat": "2025-02-25T13:19:49.213Z",
        "xata_version": 0,
        "album_uri": null,
        "apple_music_link": null,
        "artist_uri": null,
        "composer": null,
        "copyright_message": null,
        "genre": null,
        "lyrics": null,
        "mb_id": null,
        "tidal_link": null,
        "youtube_link": null
      }
    },
    {
      "table": "tracks",
      "record": {
        "album": "Homework",
        "album_art": "https://cdn.rocksky.app/covers/5ec325c9726994dcd027d36d7929bf9b.jpg",
        "album_artist": "Daft Punk",
        "artist": "Daft Punk",
        "composer": "Guy-Manuel de Homem-Christo, Thomas Bangalter",
        "copyright_message": "Distributed exclusively by Warner Music France / ADA France, ℗ 1996 Daft Life Ltd.",
        "disc_number": 1,
        "duration": 328726,
        "sha256": "2f752ddffd59ef2fedb67b4d28f58d087a035bc2ab66c05a467b00e53453efa7",
        "title": "Da Funk",
        "track_number": 4,
        "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.song/3lhtyxpwgtc2h",
        "xata_createdat": "2025-02-10T20:15:20.080Z",
        "xata_highlight": {
          "copyright_message": [
            "Distributed exclusively by Warner Music France &#x2F; ADA France, ℗ 1996 <em>Daft</em> Life Ltd."
          ],
          "title": [
            "Da <em>Funk</em>"
          ]
        },
        "xata_id": "rec_cul5sm365asp6a7qlggg",
        "xata_score": 6.7864823,
        "xata_table": "tracks",
        "xata_updatedat": "2025-02-10T20:41:26.980Z",
        "xata_version": 1,
        "album_uri": null,
        "apple_music_link": null,
        "artist_uri": null,
        "genre": null,
        "label": null,
        "lyrics": null,
        "mb_id": null,
        "spotify_link": null,
        "tidal_link": null,
        "youtube_link": null
      }
    },
    {
      "table": "tracks",
      "record": {
        "album": "Homework",
        "album_art": "https://cdn.rocksky.app/covers/5ec325c9726994dcd027d36d7929bf9b.jpg",
        "album_artist": "Daft Punk",
        "artist": "Daft Punk",
        "composer": "",
        "copyright_message": "Distributed exclusively by Warner Music France / ADA France, ℗ 1996 Daft Life Ltd.",
        "disc_number": 1,
        "duration": 51446,
        "sha256": "ee2cb8876cee167e120ce569ffc3f6c71b6b7dd5dd64a12056069d0893aa23e3",
        "title": "Funk Ad",
        "track_number": 16,
        "xata_createdat": "2025-02-10T20:19:09.399Z",
        "xata_highlight": {
          "copyright_message": [
            "Distributed exclusively by Warner Music France &#x2F; ADA France, ℗ 1996 <em>Daft</em> Life Ltd."
          ],
          "title": [
            "<em>Funk</em> Ad"
          ]
        },
        "xata_id": "rec_cul5uf98pmj2vqvcr5i0",
        "xata_score": 6.7864823,
        "xata_table": "tracks",
        "xata_updatedat": "2025-02-10T20:19:09.399Z",
        "xata_version": 0,
        "album_uri": null,
        "apple_music_link": null,
        "artist_uri": null,
        "genre": null,
        "label": null,
        "lyrics": null,
        "mb_id": null,
        "spotify_link": null,
        "tidal_link": null,
        "uri": null,
        "youtube_link": null
      }
    },
    {
      "table": "tracks",
      "record": {
        "album": "White Pony",
        "album_art": "https://i.scdn.co/image/ab67616d0000b2735c53799f473fa3e1a48c00ed",
        "album_artist": "Deftones",
        "artist": "Deftones",
        "disc_number": 1,
        "duration": 453226,
        "label": "Rhino",
        "sha256": "731b852c288e76d750a3e0bb09762e1edf095b715ffcaaa67b6954496431b93e",
        "spotify_link": "https://open.spotify.com/track/0FrT8a39eo6siL1yIxVGTP",
        "title": "Pink Maggit",
        "track_number": 12,
        "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.song/3ljaeep72vs2l",
        "xata_createdat": "2025-02-28T12:02:41.240Z",
        "xata_highlight": {
          "title": [
            "<em>Pink</em> Maggit"
          ]
        },
        "xata_id": "rec_cv0qbofu3busimrpk6c0",
        "xata_score": 6.7864823,
        "xata_table": "tracks",
        "xata_updatedat": "2025-02-28T12:02:41.240Z",
        "xata_version": 0,
        "album_uri": null,
        "apple_music_link": null,
        "artist_uri": null,
        "composer": null,
        "copyright_message": null,
        "genre": null,
        "lyrics": null,
        "mb_id": null,
        "tidal_link": null,
        "youtube_link": null
      }
    },
    {
      "table": "tracks",
      "record": {
        "album": "Survival Of The Fittest",
        "album_art": "https://cdn.rocksky.app/covers/5183f32dc0e09cc6646395dd6b26bef8.jpg",
        "album_artist": "Trill Family, Boosie Badazz, Webbie",
        "artist": "Trill Family, Boosie Badazz, Webbie, Foxx",
        "composer": "",
        "copyright_message": "2007 Trill Entertainment exclusively licensed to Santa Anna Label Group",
        "disc_number": 1,
        "duration": 246193,
        "sha256": "4cfac2c587922fd0a8fc9360dd14de7d034d3ff2aef04fd5a414889c88aea98c",
        "title": "Bout Dat",
        "track_number": 11,
        "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.song/3lhtyted7ns2h",
        "xata_createdat": "2025-02-10T20:12:52.690Z",
        "xata_highlight": {
          "title": [
            "Bout <em>Dat</em>"
          ]
        },
        "xata_id": "rec_cul5rh1qrq3dt0q8vq5g",
        "xata_score": 5.6723804,
        "xata_table": "tracks",
        "xata_updatedat": "2025-02-10T20:39:00.584Z",
        "xata_version": 1,
        "album_uri": null,
        "apple_music_link": null,
        "artist_uri": null,
        "genre": null,
        "label": null,
        "lyrics": null,
        "mb_id": null,
        "spotify_link": null,
        "tidal_link": null,
        "youtube_link": null
      }
    },
    {
      "table": "tracks",
      "record": {
        "album": "The Recession",
        "album_art": "https://i.scdn.co/image/ab67616d0000b273fb03f374f2e6bb50b48af91a",
        "album_artist": "Jeezy",
        "artist": "Jeezy",
        "disc_number": 1,
        "duration": 229213,
        "label": "Def Jam Recordings",
        "sha256": "4b597f915103c170e4564bf8fa1743f6d547061c3cdec7902d43e3b237a45a04",
        "spotify_link": "https://open.spotify.com/track/6tEPgra9Cfs1xb6g56NP3U",
        "title": "Who Dat",
        "track_number": 8,
        "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.song/3livs2uhmcc2l",
        "xata_createdat": "2025-02-24T07:08:27.455Z",
        "xata_highlight": {
          "title": [
            "Who <em>Dat</em>"
          ]
        },
        "xata_id": "rec_cuu1lqqojig7sjj8djk0",
        "xata_score": 5.6723804,
        "xata_table": "tracks",
        "xata_updatedat": "2025-02-24T07:08:27.455Z",
        "xata_version": 0,
        "album_uri": null,
        "apple_music_link": null,
        "artist_uri": null,
        "composer": null,
        "copyright_message": null,
        "genre": null,
        "lyrics": null,
        "mb_id": null,
        "tidal_link": null,
        "youtube_link": null
      }
    },
    {
      "table": "tracks",
      "record": {
        "album": "Discovery",
        "album_art": "https://cdn.rocksky.app/covers/a1c4eb450799cb3f30c400d0201414e7.jpg",
        "album_artist": "Daft Punk",
        "album_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.album/3lhlttyitus2k",
        "artist": "Daft Punk",
        "artist_uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.artist/3lhlkzyo5ms2k",
        "composer": "",
        "copyright_message": "2001 Daft Life Ltd.",
        "disc_number": 1,
        "duration": 212593,
        "sha256": "10778d13e7e8ad6d7948f9f7cd8a81299583ff2ffaf2552cf505329cf906d5ba",
        "title": "Aerodynamic",
        "track_number": 2,
        "uri": "at://did:plc:7vdlgi2bflelz7mmuxoqjfcr/app.rocksky.song/3lhpraqi7ec2d",
        "xata_createdat": "2025-02-06T08:27:10.999Z",
        "xata_highlight": {
          "copyright_message": [
            "2001 <em>Daft</em> Life Ltd."
          ]
        },
        "xata_id": "rec_cui74nho74fi003aft5g",
        "xata_score": 5.51169,
        "xata_table": "tracks",
        "xata_updatedat": "2025-03-03T12:15:40.628Z",
        "xata_version": 18,
        "apple_music_link": null,
        "genre": null,
        "label": null,
        "lyrics": null,
        "mb_id": null,
        "spotify_link": null,
        "tidal_link": null,
        "youtube_link": null
      }
    }
  ]
}
Previous
Get Several Tracks
Next
Get User's Liked Songs
Built with