Music API

This is a public version of the Fugue API.

Server

https://api-music.icons8.com/api

Client Libraries

Node.js undici

Tracks

Operations about Tracks

Tracks Operations

get/v2/tracks
get/v2/tracks/{id}/hi-res

List tracks

Get list of tracks

Query Parameters

search
Type: string

Text search query
artist
Type: string

Artist
genres
Type: array of string

Coma separated genre
instruments
Type: array of string

Coma separated instrument
moods
Type: array of string

Coma separated mood
tags
Type: array of string

Coma separated tag
tempos
Type: array of string

Coma separated tempo
themes
Type: array of string

Coma separated theme
contentId
Type: boolean

Content ID registered
pro
Type: boolean

Performing Rights Organization (P.R.O.) registered
orderBy
Type: "latest" or "oldest" or "rating"enum
page
Type: integerFormat: int32

Page number
perPage
Type: integerFormat: int32
min:
1
max:
100

Number of results per page. Max: 100
fields
Type: string

Return only specified fields. Example: "id,preview(url)". Please request only needed fields.

Responses

application/json

get/v2/tracks

import { request } from 'undici'

const { statusCode, body } = await request('https://api-music.icons8.com/api/v2/tracks?orderBy=latest&page=1&perPage=10&fields=id%2Cartist%2Cname%2Cpreview(url)', {
  headers: {
    api_key: 'YOUR_SECRET_TOKEN'
  }
})

Show Schema

{
  "total": 1362,
  "tracks": [
    {
      "id": "5a3ae4560b7a6a2c983a2499",
      "name": "Axanometric",
      "artist": "Dural",
      "preview": {
        "mediaFormat": "mp3",
        "name": "Axanometric.mp3",
        "size": 2566104,
        "bitrate": 64000,
        "url": "https://music-cdn.icons8.com/preview_low/676/569d78da-827b-492d-9597-e3718130553b.mp3"
      },
      "waveform": {
        "height": 400,
        "width": 1280,
        "url": "https://music-cdn.icons8.com/waveform/721/7a02a642-61a6-4e1d-9a84-28a2539f4b25.png"
      },
      "pro": false,
      "contentId": false,
      "bpm": 130,
      "duration": 320.7034013605442,
      "rating": {
        "sound": 83,
        "melody": 79,
        "curatorScore": 0,
        "total": 162
      },
      "genres": [
        "Ambient",
        "Electronic"
      ],
      "moods": [
        "Dark",
        "Hypnotic",
        "Mystical",
        "Scary",
        "Suspense"
      ],
      "instruments": [
        "Ambient Sounds",
        "Electronic Drums",
        "Percussion",
        "Synth",
        "Pads"
      ],
      "tempos": [
        "BPM: Medium"
      ],
      "tags": [
        "Abstract",
        "Atmospheric",
        "Glitchy",
        "Industrial",
        "Minimal",
        "Mysterious",
        "Raw",
        "Spiritual"
      ],
      "themes": [
        "Documentary",
        "Drama",
        "Fashion",
        "Film",
        "Industrial",
        "Sci-Fi",
        "Science",
        "Technology"
      ],
      "cover": {
        "thumbUrl": "https://music-cdn.icons8.com/cover_preview/564/79c8e020-287f-478c-8133-90c3084d3cc5.jpg",
        "originalUrl": "https://music-cdn.icons8.com/cover/167/cf4dd984-f1d7-41e3-bc91-bd32adccab49.jpg"
      },
      "createdAt": 1513808982428
    }
  ]
}

List tracks

High-resolution track

Get a link to a high resolution asset of track

Path Parameters

id
Type: string
required

ID

Query Parameters

mediaFormat
Type: "wav" or "mp3"enum

Responses

application/json
application/json

get/v2/tracks/{id}/hi-res

import { request } from 'undici'

const { statusCode, body } = await request('https://api-music.icons8.com/api/v2/tracks/5a26a7d177840430d1af749e/hi-res?mediaFormat=mp3', {
  headers: {
    api_key: 'YOUR_SECRET_TOKEN'
  }
})

Show Schema

{
  "mediaFormat": "wav",
  "name": "Olympus Triumph.wav",
  "channels": 2,
  "size": 19716526,
  "sampleRate": 44100,
  "bitrate": null,
  "url": "https://music-cdn.icons8.com/original/337/cc8eb72c-e8b2-432c-97cd-21d8ae8dce2f.wav"
}