Search Tracks

GET 
/tracks/search

Search for a track or tracks

Request

Query Parameters

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

dataobject[]

Array [

artworkobjectrequired

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

remix_ofobject

tracks

object[]

Array [

parent_track_id stringrequired

]

repost_count integerrequired

favorite_count integerrequired

comment_count integerrequired

tags string

title stringrequired

userobjectrequired

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_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

]

Example

{
  "data": [
    {
      "artwork": {
        "150x150": "https://audius-content-16.cultur3stake.com/content/QmedxLH1wmNP932CnnQH8yQqyy9Z45Y3m1WV41cTMNSfbC/150x150.jpg",
        "480x480": "https://audius-content-16.cultur3stake.com/content/QmedxLH1wmNP932CnnQH8yQqyy9Z45Y3m1WV41cTMNSfbC/480x480.jpg",
        "1000x1000": "https://audius-content-16.cultur3stake.com/content/QmedxLH1wmNP932CnnQH8yQqyy9Z45Y3m1WV41cTMNSfbC/1000x1000.jpg"
      },
      "description": "The Sun \n\nWritten By: PCG Boots  \nProduced By: TK Does Work, Graham Squad & Gibby\nMGMT & Creative Direction: 1144 MGMT \n\nLyrics: \n\nHook \nI Could’ve Been A Real Nigga & Kept It Real With You\nLet You Close Inside My Head Now I Can’t Deal With You\n& I Feel The Sorrow Knowing I Can’t Heal From It\nBut Baby You We’re The Sun Yeah\nMy Life’s Dark But Baby You Were The Sun Yeah\nYou Were The Sun\nYou Were The Sun\n\nVerse\nI Knew You Were The One \nI Know You Are My Sun \nI Know You Give Me Luv\n& You Keep Saying I Hate \nYou But You Know I Can’t Replace You\nYour Love Is Very Dangerous \nDriving To Your Heart On A Fast Lane \nYour The Only One That’s What They All Say\nYou Ain’t Got No Time For The Dawg Games \nYou Ain’t Got No Time For The Dawg Games \n\nDriving To Heart Onna Jetski\nCause Girl I Knew What It Was When You Text Me\nGot My Heart Racing Like A Jet Speed No\nGot My Heart Racing Like A Jet Speed No",
      "genre": "Hip-Hop/Rap",
      "id": "lW65w",
      "track_cid": "QmdVYjmMczB5o1wJR4BCNwYz9nec3rUMwHKJwKz9EZnHyq",
      "preview_cid": null,
      "orig_file_cid": "QmdVYjmMczB5o1wJR4BCNwYz9nec3rUMwHKJwKz9EZnHyq",
      "orig_filename": "The Sun - [PCG BOOTS ].mp3",
      "is_original_available": false,
      "mood": "Sentimental",
      "release_date": "2022-06-29T14:02:00.000Z",
      "remix_of": {
        "tracks": null
      },
      "repost_count": 27,
      "favorite_count": 55,
      "tags": "drake,lildurk,sad,heartbreak",
      "title": "The Sun",
      "user": {
        "album_count": 0,
        "artist_pick_track_id": null,
        "bio": null,
        "cover_photo": null,
        "followee_count": 13,
        "follower_count": 21,
        "handle": "pcgboots",
        "id": "558oX",
        "is_verified": false,
        "twitter_handle": null,
        "instagram_handle": null,
        "tiktok_handle": null,
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": null,
        "donation": null,
        "location": null,
        "name": "PCG BOOTS ",
        "playlist_count": 0,
        "profile_picture": {
          "150x150": "https://blockdaemon-audius-content-05.bdnodes.net/content/QmQ7qLgG2Ghn61BQDQYGQ6z9bxtGRXjumD8P2kxP3SUnLV/150x150.jpg",
          "480x480": "https://blockdaemon-audius-content-05.bdnodes.net/content/QmQ7qLgG2Ghn61BQDQYGQ6z9bxtGRXjumD8P2kxP3SUnLV/480x480.jpg",
          "1000x1000": "https://blockdaemon-audius-content-05.bdnodes.net/content/QmQ7qLgG2Ghn61BQDQYGQ6z9bxtGRXjumD8P2kxP3SUnLV/1000x1000.jpg"
        },
        "repost_count": 0,
        "track_count": 1,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0x079c1a9c9c741b85aa4299eb424b85dbc1ce0686",
        "spl_wallet": "6Tq7p4iGMvkknk5Bme4Tckd9bU2yPByk74Ge7GjMoFBK",
        "supporter_count": 1,
        "supporting_count": 0,
        "total_audio_balance": null,
        "wallet": "0x079c1a9c9c741b85aa4299eb424b85dbc1ce0686"
      },
      "duration": 136,
      "is_downloadable": false,
      "play_count": 7068,
      "permalink": "/pcgboots/the-sun",
      "is_streamable": true,
      "ddex_app": null,
      "playlists_containing_track": [127352, 128856, 127483]
    },
    {
      "artwork": {
        "150x150": "https://audius-creator-1.theblueprint.xyz/content/Qmcc48EcTFkJw5RPXhB9oawnRJJyWUL4CuQDA1dRQc1QV9/150x150.jpg",
        "480x480": "https://audius-creator-1.theblueprint.xyz/content/Qmcc48EcTFkJw5RPXhB9oawnRJJyWUL4CuQDA1dRQc1QV9/480x480.jpg",
        "1000x1000": "https://audius-creator-1.theblueprint.xyz/content/Qmcc48EcTFkJw5RPXhB9oawnRJJyWUL4CuQDA1dRQc1QV9/1000x1000.jpg"
      },
      "description": null,
      "genre": "Experimental",
      "id": "OgNqv",
      "track_cid": "QmU4X3vvsZDDRYrMJRyNinhETxPWSYY3V41uBjVhcJPZM3",
      "preview_cid": null,
      "orig_file_cid": "QmU4X3vvsZDDRYrMJRyNinhETxPWSYY3V41uBjVhcJPZM3",
      "orig_filename": "Jaunty Boots - [Aptic].mp3",
      "is_original_available": false,
      "mood": "Rowdy",
      "release_date": "2020-08-30T16:04:00.000Z",
      "remix_of": {
        "tracks": null
      },
      "repost_count": 8,
      "favorite_count": 13,
      "tags": "nuero,bass,donks,experimental",
      "title": "Jaunty Boots",
      "user": {
        "album_count": 0,
        "artist_pick_track_id": null,
        "bio": "",
        "cover_photo": {
          "640x": "https://audius-content-7.figment.io/content/QmZCeT8ZdJkHZPrTk8cezyJg8E3HkuN58o9XLDLwtB3WTN/640x.jpg",
          "2000x": "https://audius-content-7.figment.io/content/QmZCeT8ZdJkHZPrTk8cezyJg8E3HkuN58o9XLDLwtB3WTN/2000x.jpg"
        },
        "followee_count": 45,
        "follower_count": 204,
        "handle": "apticbass",
        "id": "LR2Kz",
        "is_verified": false,
        "twitter_handle": "aptic_",
        "instagram_handle": "apticbass",
        "tiktok_handle": null,
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": null,
        "donation": null,
        "location": "Atlanta, GA",
        "name": "Aptic",
        "playlist_count": 0,
        "profile_picture": {
          "150x150": "https://audius-content-4.cultur3stake.com/content/QmcrPCfJJXqW9dN31cUe5DcjYLxRbxULSdskgdnF1rwvJN/150x150.jpg",
          "480x480": "https://audius-content-4.cultur3stake.com/content/QmcrPCfJJXqW9dN31cUe5DcjYLxRbxULSdskgdnF1rwvJN/480x480.jpg",
          "1000x1000": "https://audius-content-4.cultur3stake.com/content/QmcrPCfJJXqW9dN31cUe5DcjYLxRbxULSdskgdnF1rwvJN/1000x1000.jpg"
        },
        "repost_count": 0,
        "track_count": 5,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0x30caf99c7803fe84c9bf5d40ca9dc3a6d596dc1d",
        "spl_wallet": "2EpAPSzBhm4Lej7Ud3xpx5LuEjTfe5DPP5eVzaGZ8AQs",
        "supporter_count": 0,
        "supporting_count": 0,
        "total_audio_balance": null,
        "wallet": "0x30caf99c7803fe84c9bf5d40ca9dc3a6d596dc1d"
      },
      "duration": 216,
      "is_downloadable": true,
      "play_count": 158,
      "permalink": "/apticbass/jaunty-boots-87081",
      "is_streamable": true,
      "ddex_app": null,
      "playlists_containing_track": []
    },
    {
      "artwork": {
        "150x150": "https://blockdaemon-audius-content-04.bdnodes.net/content/QmX2V9LAYY4bnfeqB4aQDitMGKqRnZfx1aDWoxaVAEvBDN/150x150.jpg",
        "480x480": "https://blockdaemon-audius-content-04.bdnodes.net/content/QmX2V9LAYY4bnfeqB4aQDitMGKqRnZfx1aDWoxaVAEvBDN/480x480.jpg",
        "1000x1000": "https://blockdaemon-audius-content-04.bdnodes.net/content/QmX2V9LAYY4bnfeqB4aQDitMGKqRnZfx1aDWoxaVAEvBDN/1000x1000.jpg"
      },
      "description": null,
      "genre": "Hip-Hop/Rap",
      "id": "l5ooQ",
      "track_cid": "QmVsijqx7B5fzLBDyMnBcnTNxuigQdyFpz59LBoYpyVUY9",
      "preview_cid": null,
      "orig_file_cid": "QmVsijqx7B5fzLBDyMnBcnTNxuigQdyFpz59LBoYpyVUY9",
      "orig_filename": "BOOTS - [FirstPlace Market Media Group].mp3",
      "is_original_available": false,
      "mood": null,
      "release_date": "2022-04-27T20:46:20.000Z",
      "remix_of": {
        "tracks": null
      },
      "repost_count": 2,
      "favorite_count": 0,
      "tags": null,
      "title": "BOOTS",
      "user": {
        "album_count": 12,
        "artist_pick_track_id": null,
        "bio": "HOTTEST PLATFORM FOR INDEPENDENT ARTIST",
        "cover_photo": {
          "640x": "https://usermetadata.audius.co/content/QmPQT9KJp6UTWsDWYQZnf8uuCsXNoKyfqGvSwvaagsBib2/640x.jpg",
          "2000x": "https://usermetadata.audius.co/content/QmPQT9KJp6UTWsDWYQZnf8uuCsXNoKyfqGvSwvaagsBib2/2000x.jpg"
        },
        "followee_count": 6,
        "follower_count": 19,
        "handle": "FPMMG",
        "id": "jY4jG",
        "is_verified": false,
        "twitter_handle": null,
        "instagram_handle": null,
        "tiktok_handle": null,
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": null,
        "donation": null,
        "location": "LAS VEGAS, NEVADA",
        "name": "FirstPlace Market Media Group",
        "playlist_count": 0,
        "profile_picture": {
          "150x150": "https://creatornode.audius8.prod-eks-ap-northeast-1.staked.cloud/content/QmZUd2LETYdFCSzCWwMVzQCehQojBmbGbvZth3u1QwHeej/150x150.jpg",
          "480x480": "https://creatornode.audius8.prod-eks-ap-northeast-1.staked.cloud/content/QmZUd2LETYdFCSzCWwMVzQCehQojBmbGbvZth3u1QwHeej/480x480.jpg",
          "1000x1000": "https://creatornode.audius8.prod-eks-ap-northeast-1.staked.cloud/content/QmZUd2LETYdFCSzCWwMVzQCehQojBmbGbvZth3u1QwHeej/1000x1000.jpg"
        },
        "repost_count": 3,
        "track_count": 101,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0x231fb1eedcee0926ded07d04657934ac50d8b4e5",
        "spl_wallet": "J5uXUguGnaqfVtb9E5NDXPcpeLnxrwydv7hDrT8uAt4u",
        "supporter_count": 0,
        "supporting_count": 0,
        "total_audio_balance": null,
        "wallet": "0x231fb1eedcee0926ded07d04657934ac50d8b4e5"
      },
      "duration": 125,
      "is_downloadable": false,
      "play_count": 16,
      "permalink": "/FPMMG/boots",
      "is_streamable": true,
      "ddex_app": null,
      "playlists_containing_track": [121320, 123402, 123357, 123357]
    },
    {
      "artwork": {
        "150x150": "https://audius-content-18.cultur3stake.com/content/QmT8z4jENUf9nXgT9gGRAU8u15FxeNnUtGkekb2STm4HTW/150x150.jpg",
        "480x480": "https://audius-content-18.cultur3stake.com/content/QmT8z4jENUf9nXgT9gGRAU8u15FxeNnUtGkekb2STm4HTW/480x480.jpg",
        "1000x1000": "https://audius-content-18.cultur3stake.com/content/QmT8z4jENUf9nXgT9gGRAU8u15FxeNnUtGkekb2STm4HTW/1000x1000.jpg"
      },
      "description": "We spend so much time propping up celebrities and athletes but completely forget the people working their ass off behind the scenes to make life easier for us in one way or another. This is an ode to the working-class men and women everywhere.",
      "genre": "Folk",
      "id": "zZB6j",
      "track_cid": "Qmc2ZcyCLmgCi5vaTWu5oPAn8ckVJqupqERfLJ7JrJstz1",
      "preview_cid": null,
      "orig_file_cid": "Qmc2ZcyCLmgCi5vaTWu5oPAn8ckVJqupqERfLJ7JrJstz1",
      "orig_filename": "Brown Boots - [COREY KOEHLER].mp3",
      "is_original_available": false,
      "mood": "Empowering",
      "release_date": "2013-04-01T12:00:00.000Z",
      "remix_of": {
        "tracks": null
      },
      "repost_count": 4,
      "favorite_count": 6,
      "tags": "folktronic,americana,altcountry,minnesota,acoustic",
      "title": "Brown Boots",
      "user": {
        "album_count": 0,
        "artist_pick_track_id": "NRoaZ",
        "bio": "Creator of music for fans of acoustic-based music that is colored with Americana, Folk, Country, and Rock.\n\nOh and artists and creators, check this out. Simplify your crypto addresses with NFT domains - https://planetcorey.com/nft-domains (affiliate link)",
        "cover_photo": {
          "640x": "https://audius-creator-6.theblueprint.xyz/content/QmQFvBUzXL3dxLvgHkLN8eBpDxU1Yu6ud8YchdnxhAAw6h/640x.jpg",
          "2000x": "https://audius-creator-6.theblueprint.xyz/content/QmQFvBUzXL3dxLvgHkLN8eBpDxU1Yu6ud8YchdnxhAAw6h/2000x.jpg"
        },
        "followee_count": 57,
        "follower_count": 101,
        "handle": "planetcorey",
        "id": "Ogzag",
        "is_verified": false,
        "twitter_handle": "planetcorey",
        "instagram_handle": null,
        "tiktok_handle": "planetcorey",
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": "https://planetcorey.com/links",
        "donation": "https://cash.app/$coreykmusic",
        "location": "Winona, MN",
        "name": "COREY KOEHLER",
        "playlist_count": 0,
        "profile_picture": {
          "150x150": "https://usermetadata.audius.co/content/QmVaqNtmz1C8BnFZPSjavwCNNZT2UiQpZADWA8bKZepRC2/150x150.jpg",
          "480x480": "https://usermetadata.audius.co/content/QmVaqNtmz1C8BnFZPSjavwCNNZT2UiQpZADWA8bKZepRC2/480x480.jpg",
          "1000x1000": "https://usermetadata.audius.co/content/QmVaqNtmz1C8BnFZPSjavwCNNZT2UiQpZADWA8bKZepRC2/1000x1000.jpg"
        },
        "repost_count": 8,
        "track_count": 5,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0xaf48e5d772b3e501ab7179e9b675cf4f5832feee",
        "spl_wallet": "6axeV6XH79gv1bJQinyTs5N1oGDWqEjUHZXXqkUXMrj",
        "supporter_count": 0,
        "supporting_count": 0,
        "total_audio_balance": null,
        "wallet": "0xaf48e5d772b3e501ab7179e9b675cf4f5832feee"
      },
      "duration": 191,
      "is_downloadable": false,
      "play_count": 288,
      "permalink": "/planetcorey/brown-boots-312163",
      "is_streamable": true,
      "ddex_app": null,
      "playlists_containing_track": [757224142]
    },
    {
      "artwork": {
        "150x150": "https://audius-content-3.cultur3stake.com/content/QmSawMpFQDWZ2MhPNwgcGZgtodvDcoepi2WBKFDFUFJw9T/150x150.jpg",
        "480x480": "https://audius-content-3.cultur3stake.com/content/QmSawMpFQDWZ2MhPNwgcGZgtodvDcoepi2WBKFDFUFJw9T/480x480.jpg",
        "1000x1000": "https://audius-content-3.cultur3stake.com/content/QmSawMpFQDWZ2MhPNwgcGZgtodvDcoepi2WBKFDFUFJw9T/1000x1000.jpg"
      },
      "description": "YOUTUBE : https://youtu.be/YzaJRObh0iM",
      "genre": "House",
      "id": "b69wP",
      "track_cid": "QmYvK8uK7FkxY88dUFnpMv9tkAeRfuvy6WgXW54Y7BspkB",
      "preview_cid": null,
      "orig_file_cid": "QmYvK8uK7FkxY88dUFnpMv9tkAeRfuvy6WgXW54Y7BspkB",
      "orig_filename": "MOON BOOTS - [Niko Ondaboardz ].mp3",
      "is_original_available": false,
      "mood": "Energizing",
      "release_date": "2022-10-19T21:01:00.000Z",
      "remix_of": {
        "tracks": null
      },
      "repost_count": 4,
      "favorite_count": 4,
      "tags": "soca,house",
      "title": "MOON BOOTS",
      "user": {
        "album_count": 0,
        "artist_pick_track_id": null,
        "bio": "Audio Engineer | Music Producer\nDancehall • Soca • HipHop \nPremier Studio TT 🎙",
        "cover_photo": {
          "640x": "https://blockchange-audius-content-02.bdnodes.net/content/Qmb5k2gwnmVvUe7BtwoterL19BT2vJHJFkFfxhNh7psvra/640x.jpg",
          "2000x": "https://blockchange-audius-content-02.bdnodes.net/content/Qmb5k2gwnmVvUe7BtwoterL19BT2vJHJFkFfxhNh7psvra/2000x.jpg"
        },
        "followee_count": 96,
        "follower_count": 143,
        "handle": "nikoondaboardz",
        "id": "AN2OK",
        "is_verified": false,
        "twitter_handle": null,
        "instagram_handle": "niko.ondaboardz",
        "tiktok_handle": "ondaboardz",
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": "https://linktr.ee/Nikoondaboardz",
        "donation": null,
        "location": "Port of Spain, POS",
        "name": "Niko Ondaboardz ",
        "playlist_count": 0,
        "profile_picture": {
          "150x150": "https://blockdaemon-audius-content-03.bdnodes.net/content/01HF9M8ZD54YE4CDHQ7NY5K1XA/150x150.jpg",
          "480x480": "https://blockdaemon-audius-content-03.bdnodes.net/content/01HF9M8ZD54YE4CDHQ7NY5K1XA/480x480.jpg",
          "1000x1000": "https://blockdaemon-audius-content-03.bdnodes.net/content/01HF9M8ZD54YE4CDHQ7NY5K1XA/1000x1000.jpg"
        },
        "repost_count": 10,
        "track_count": 64,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0xaa0291b832183af67af316cb970fa3810529c0a8",
        "spl_wallet": "HwWMNsArW7zxAHmZiB1pyGnuSnN6gEcHg5yq8cEkcYNu",
        "supporter_count": 0,
        "supporting_count": 0,
        "total_audio_balance": null,
        "wallet": "0xaa0291b832183af67af316cb970fa3810529c0a8"
      },
      "duration": 257,
      "is_downloadable": false,
      "play_count": 84,
      "permalink": "/nikoondaboardz/moon-boots",
      "is_streamable": true,
      "ddex_app": null,
      "playlists_containing_track": []
    }
  ]
}

400

Bad request

500

Server error

Loading...