Search Tracks

GET 
/tracks/search

Search for a track or tracks

Request

Query Parameters

offset integer

The number of items to skip. Useful for pagination (page number * limit)

limit integer

The number of items to fetch

query string

The search query

genre string[]

The genres to filter by

sort_method string

Possible values: [relevant, popular, recent]

The sort method

mood string[]

The moods to filter by

only_downloadable string

Default value: false

Return only downloadable tracks

includePurchaseable string

Whether or not to include purchaseable content

is_purchaseable string

Only include purchaseable tracks and albums in the track and album results

has_downloads string

Only include tracks that have downloads in the track results

key string[]

Only include tracks that match the musical key

bpm_min string

Only include tracks that have a bpm greater than or equal to

bpm_max string

Only include tracks that have a bpm less than or equal to

Responses

200

Success

application/json

Schema

Schema

data

object[]

Array [

artwork

object

required

150x150 string

480x480 string

1000x1000 string

description string

genre stringrequired

id stringrequired

track_cid string

preview_cid string

orig_file_cid string

orig_filename string

is_original_available booleanrequired

mood string

release_date string

isrc string

remix_of

object

tracks

object[]

Array [

parent_track_id stringrequired

]

repost_count integerrequired

favorite_count integerrequired

comment_count integerrequired

tags string

title stringrequired

user

object

required

album_count integerrequired

artist_pick_track_id string

bio string

cover_photo

object

640x string

2000x string

followee_count integerrequired

follower_count integerrequired

handle stringrequired

id stringrequired

is_verified booleanrequired

twitter_handle string

instagram_handle string

tiktok_handle string

verified_with_twitter booleanrequired

verified_with_instagram booleanrequired

verified_with_tiktok booleanrequired

website string

donation string

location string

name stringrequired

playlist_count integerrequired

profile_picture

object

150x150 string

480x480 string

1000x1000 string

repost_count integerrequired

track_count integerrequired

is_deactivated booleanrequired

is_available booleanrequired

erc_wallet stringrequired

spl_wallet stringrequired

spl_usdc_wallet stringrequired

spl_usdc_payout_wallet string

supporter_count integerrequired

supporting_count integerrequired

total_audio_balance integerrequired

wallet stringrequired

The user's Ethereum wallet address for their account

duration integerrequired

is_downloadable booleanrequired

play_count integerrequired

permalink stringrequired

is_streamable boolean

ddex_app string

playlists_containing_track integer[]

pinned_comment_id integer

album_backlink

object

playlist_id integerrequired

playlist_name stringrequired

permalink stringrequired

]

Example (from schema)

{
  "data": [
    {
      "artwork": {
        "150x150": "string",
        "480x480": "string",
        "1000x1000": "string"
      },
      "description": "string",
      "genre": "string",
      "id": "string",
      "track_cid": "string",
      "preview_cid": "string",
      "orig_file_cid": "string",
      "orig_filename": "string",
      "is_original_available": true,
      "mood": "string",
      "release_date": "string",
      "isrc": "string",
      "remix_of": {
        "tracks": [
          {
            "parent_track_id": "string"
          }
        ]
      },
      "repost_count": 0,
      "favorite_count": 0,
      "comment_count": 0,
      "tags": "string",
      "title": "string",
      "user": {
        "album_count": 0,
        "artist_pick_track_id": "string",
        "bio": "string",
        "cover_photo": {
          "640x": "string",
          "2000x": "string"
        },
        "followee_count": 0,
        "follower_count": 0,
        "handle": "string",
        "id": "string",
        "is_verified": true,
        "twitter_handle": "string",
        "instagram_handle": "string",
        "tiktok_handle": "string",
        "verified_with_twitter": true,
        "verified_with_instagram": true,
        "verified_with_tiktok": true,
        "website": "string",
        "donation": "string",
        "location": "string",
        "name": "string",
        "playlist_count": 0,
        "profile_picture": {
          "150x150": "string",
          "480x480": "string",
          "1000x1000": "string"
        },
        "repost_count": 0,
        "track_count": 0,
        "is_deactivated": true,
        "is_available": true,
        "erc_wallet": "string",
        "spl_wallet": "string",
        "spl_usdc_wallet": "string",
        "spl_usdc_payout_wallet": "string",
        "supporter_count": 0,
        "supporting_count": 0,
        "total_audio_balance": 0,
        "wallet": "string"
      },
      "duration": 0,
      "is_downloadable": true,
      "play_count": 0,
      "permalink": "string",
      "is_streamable": true,
      "ddex_app": "string",
      "playlists_containing_track": [
        0
      ],
      "pinned_comment_id": 0,
      "album_backlink": {
        "playlist_id": 0,
        "playlist_name": "string",
        "permalink": "string"
      }
    }
  ]
}

400

Bad request

500

Server error

Loading...