Icons8 Developers

Fugue API v1.0.0

This is a public version of the Fugue API.

#

Security definitions

You can authenticate using one of the following methods:

  • An Api-Key header. For example, Api-Key: YOUR_API_KEY.
  • A token query parameter. For example, if you want to make a request to a resource with URL /endpoint, you can specify your key as /endpoint?token=YOUR_API_KEY

Make sure that each request you perform includes your API key in one of the specified formats. Otherwise, the request will fail.

#

List tracks


GET https://api-music.icons8.com/api/v2/tracks?token=YOUR_API_KEY

Get list of tracks

#

Parameters

search optional string

Text search query


artist optional string

Artist


genres optional array of string

Coma separated genre


instruments optional array of string

Coma separated instrument


moods optional array of string

Coma separated mood


tags optional array of string

Coma separated tag


tempos optional array of string

Coma separated tempo


themes optional array of string

Coma separated theme


contentId optional boolean

Content ID registered


pro optional boolean

Performing Rights Organization (P.R.O.) registered


orderBy optional string default latest one of latest​oldest​rating​


page optional integer default 1

Page number


perPage optional integer default 10

Number of results per page. Max: 100


fields optional string default id,artist,name,preview(url)

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


#

Responses

200 - List tracks
#

Body

tracks optional array of object


id optional string


name optional string


artist optional string


preview optional object

Get a link to a high resolution asset of track


mediaFormat optional string one of wav​mp3​


name optional string


channels optional integer


size optional integer


sampleRate optional integer


bitrate optional integer


url optional string



waveform optional object


height optional integer


width optional integer


url optional string



pro optional boolean


contentId optional boolean


bpm optional string


duration optional string


rating optional object


sound optional integer


melody optional integer


curatorScore optional integer


total optional integer



genres optional array of string


moods optional array of string


instruments optional array of string


tempos optional array of string


tags optional array of string


themes optional array of string


cover optional object


thumbUrl optional string


originalUrl optional string



createdAt optional integer



total optional integer


#

High-resolution track


GET https://api-music.icons8.com/api/v2/tracks/{id}/hi-res?token=YOUR_API_KEY

Get a link to a high resolution asset of track

#

Parameters

id required string

ID


mediaFormat optional string default mp3 one of wav​mp3​


#

Responses

200 - High-resolution track
#

Body

mediaFormat optional string one of wav​mp3​


name optional string


channels optional integer


size optional integer


sampleRate optional integer


bitrate optional integer


url optional string


#

List genres


GET https://api-music.icons8.com/api/v2/genres?token=YOUR_API_KEY

Get list of genres

#

Responses

200 - List genres
#

Body

genres optional array of string


#

List instruments


GET https://api-music.icons8.com/api/v2/instruments?token=YOUR_API_KEY

Get list of instruments

#

Responses

200 - List instruments
#

Body

instruments optional array of string


#

List moods


GET https://api-music.icons8.com/api/v2/moods?token=YOUR_API_KEY

Get list of moods

#

Responses

200 - List moods
#

Body

moods optional array of string


#

List tags


GET https://api-music.icons8.com/api/v2/tags?token=YOUR_API_KEY

Get list of tags

#

Responses

200 - List tags
#

Body

tags optional array of string


#

List tempos


GET https://api-music.icons8.com/api/v2/tempos?token=YOUR_API_KEY

Get list of tempos

#

Responses

200 - List tempos
#

Body

tempos optional array of string


#

List themes


GET https://api-music.icons8.com/api/v2/themes?token=YOUR_API_KEY

Get list of themes

#

Responses

200 - List themes
#

Body

themes optional array of string