Search Playlists
GET/playlists/search
Search for a playlist
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
includePurchaseable string
Whether or not to include purchaseable content
has_downloads string
Only include tracks that have downloads in the track results
Responses
- 200
- 400
- 500
Success
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
data
object[]
artwork
object
150x150 string
480x480 string
1000x1000 string
description string
permalink stringrequired
id stringrequired
is_album booleanrequired
is_image_autogenerated booleanrequired
playlist_name stringrequired
playlist_contents
object[]
required
metadata_timestamp integerrequired
timestamp integerrequired
track_id stringrequired
repost_count integerrequired
favorite_count integerrequired
total_play_count integerrequired
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
ddex_app string
access
object
required
stream booleanrequired
download booleanrequired
upc string
track_count integerrequired
{
"data": [
{
"artwork": {
"150x150": "string",
"480x480": "string",
"1000x1000": "string"
},
"description": "string",
"permalink": "string",
"id": "string",
"is_album": true,
"is_image_autogenerated": true,
"playlist_name": "string",
"playlist_contents": [
{
"metadata_timestamp": 0,
"timestamp": 0,
"track_id": "string"
}
],
"repost_count": 0,
"favorite_count": 0,
"total_play_count": 0,
"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"
},
"ddex_app": "string",
"access": {
"stream": true,
"download": true
},
"upc": "string",
"track_count": 0
}
]
}
Bad request
Server error
Loading...