API Documentation

Music

It provides free api to discover millions song, artist, albums, covers, tempo (bpm) and lyrics

GET All Artists

All Artists

Retrive all artist

GET https://api.happi.dev/v1/music/artists

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

page * integer
ℹ️ Page
Headers
JSON Response

Response Definition

{
  "success": boolean,
  "next": text,
  "previous": boolean,
  "pages": integer,
  "total": integer,
  "length": integer,
  "result": [
    {
      "id_artist": integer,
      "artist": text,
      "api_artist": text,
      "api_albums": text    
    }
 ]
}

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
GET Search

Search

Search Track

GET https://api.happi.dev/v1/music

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

q * string
ℹ️ Text to search
limit integer
ℹ️ Limit (Max 50)
lyricsboolean
ℹ️ Return only tracks with lyrics
type text
ℹ️ Possible values= track,artist
Headers
JSON Response

Response Definition

Type Track: 
{
  "success": boolean,
  "length": integer,
  "result": [
    {
      "track": text,
      "id_track": integer,
      "artist": text,
      "haslyrics": boolean,
      "id_artist": integer,
      "album": text,
      "bpm": integer,
      "id_album": integer,
      "cover": text,
      "lang": text /* ISO 639-1 */,
      "api_artist": text,
      "api_albums": text,
      "api_album": text,
      "api_tracks": text,
      "api_track": text,
      "api_lyrics": text
    }
  ]
}

Type Artist:

{
  "success": boolean,
  "length": integer,
  "result": [
    {
      "artist": text,
      "id_artist": integer,
      "cover": text,
      "api_artist": text
    }
  ]
}

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
GET Artist

Artist

Get artist info

GET https://api.happi.dev/v1/music/artists/:id_artist

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

id_artist * integer
ℹ️ ID Artist
Headers
JSON Response

Response Definition

{
  "success": boolean,
  "length": integer,
  "result": {
    "id_artist": integer,
    "artist": text,
    "mbid": text,
    "gender": text (female|male),
    "country": text (iso 2 letters),
    "youtube": text,
    "instagram": text,
    "twitter": text,
    "facebook": text,
    "website": text,
    "spotify": text (Spotify ID),
    "api_albums": text
  }
}

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
GET Albums

Albums

Get all albums from a artist

GET https://api.happi.dev/v1/music/artists/:id_artist/albums

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

id_artist * integer
ℹ️ ID Artist
Headers
JSON Response

Response Definition

{
  "success": boolean,
  "length": integer,
  "result": {
    "artist": text,
    "id_artist": integer,
    "length": integer,
    "albums": [{
        "album": text,
        "id_album": integer,
        "cover": text,
        "api_album": text,
        "api_tracks": text
      }]
  }
}

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
GET Album

Album

Get album information from artists

GET https://api.happi.dev/v1/music/artists/:id_artist/albums/:id_album

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

id_artist * integer
ℹ️ ID Artist
id_album * integer
ℹ️ ID Album
Headers
JSON Response

Response Definition

{
  "success": boolean,
  "length": integer,
  "result": {
    "album": text,
    "id_album": integer,
    "id_artist": integer,
    "artist": text,
    "cover": text,
    "upc": text,
    "asin": text,
    "mbid": text,
    "genres": [],
    "realease": text,
    "label": text,
    "explicit": boolean,
    "api_artist": text,
    "api_albums": text,
    "api_album": text,
    "api_tracks": text
  }
}

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
GET Tracks

Tracks

Get all tracks from a album artist

GET https://api.happi.dev/v1/music/artists/:id_artist/albums/:id_album/tracks

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

id_artist * integer
ℹ️ ID Artist
id_album * integer
ℹ️ ID Album
Headers
JSON Response

Response Definition

{
  "success": bolean,
  "length": integer,
  "result": {
    "album": text,
    "id_album": integer,
    "id_artist": integer,
    "artist": text,
    "cover": text,
    "label": text,
    "explicit": bolean,
    "api_artist": text,
    "api_albums": text,
    "api_album": text,
    "api_tracks": text,
    "length": integer,
    "tracks": [
      {
        "id_track": integer,
        "track": text,
        "bpm": integer, // Tempo
        "api_track": text,
        "api_lyrics": text      
      }
    ]
  }
}

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
GET Track

Track

Get track information (Artist, Album, Tempo or BPM)

GET https://api.happi.dev/v1/music/artists/:id_artist/albums/:id_album/tracks/:id_track

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

id_artist * integer
ℹ️ ID Artist
id_album * integer
ℹ️ ID Album
id_track * integer
ℹ️ ID Track
Headers
JSON Response

Response Definition

{
    "success": boolean,
    "length": integer,
    "result": {
      "id_track": integer,
      "track": text,
      "artist": text,
      "album": text,
      "bpm": integer /* false (Boolean: if not found) */,
      "lang": text /* ISO 639-1 */,
      "haslyrics": boolean,
      "api_track": text,
      "api_lyrics": text
    }
  }

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
GET Smart Playlist

Smart Playlist

Generate a smart playlist using a seed artist

GET https://api.happi.dev/v1/music/artists/:id_artist/smart-playlist

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

id_artist * integer
ℹ️ ID Artist (Seed artist)
Headers
JSON Response

Response Definition

{
    "success": boolean,
    "length": integer,
    "result": [
        {
            "id_track": integer,
            "track": text,
            "id_artist": integer,
            "artist":  text,
            "id_album": integer,
            "album":  text,
            "cover":  text,
            "haslyrics": boolean,
            "lang": text /* ISO 639-1 */,
            "api_artist":  text,
            "api_albums":  text,
            "api_album":  text,
            "api_tracks":  text,
            "api_lyrics":  text,
        }
    ]
}

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
GET Acrostic Playlist

Acrostic Playlist

Create a playlist with a secret message hidden as an acrostic in track name (first letter)

GET https://api.happi.dev/v1/music/artists/:id_artist/smart-playlist/acrostic

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

id_artist * integer
ℹ️ ID Artist (Seed artist)
message * text
ℹ️ Message Max 100 Characters
Headers
JSON Response

Response Definition

{
    "success": boolean,
    "message": text,
    "length": integer,
    "result": [
        {
            "lang": text /* ISO 639-1 */,
            "letter": char(1),
            "track": text,
            "id_track": integer,
            "artist": text,
            "id_artist": integer,
            "id_album": integer,
            "album": text,
            "haslyrics": boolean,
            "cover": text,
            "api_artist": text,
            "api_albums": text,
            "api_album": text,
            "api_tracks": text,
            "api_track": text,
            "api_lyrics": text
        }
    ]
}

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
GET Tempo (BPM) Playlist

Tempo (BPM) Playlist

Create playlist based on BPM (Tempo)

GET https://api.happi.dev/v1/music/bpm/playlist/:tempo

Parameters

API Key * Text
You can also send your API key using the header x-happi-key.

Get your free API key here

tempo * string
ℹ️ Use format from-to BPM
limit integer
ℹ️ Max 100
Headers
JSON Response

Response Definition

{
    "success": boolean,
    "bpm": text,
    "length": integer,
    "result": [
        {
            "bmp": integer,
            "track": text,
            "id_track": integer,
            "artist": text,
            "id_artist": integer,
            "id_album": integer,
            "album": text,
            "haslyrics": boolean,
            "lang": text /* ISO 639-1 */,
            "cover": text,
            "api_artist": text,
            "api_albums": text,
            "api_album": text,
            "api_tracks": text,
            "api_track": text,
            "api_lyrics": text
        }
    ]
}

Error Response

Check http response code
{
  "success": boolean,
  "error": text
}
Title Messsage