Get Tracks by User

GET 
/users/:id/tracks

Gets the tracks created by a user using their user ID

Request

Path Parameters

id stringrequired

A User ID

Query Parameters

offset integer

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

limit integer

The number of items to fetch

user_id string

The user ID of the user making the request

sort string

Possible values: [date, plays]

Default value: date

[Deprecated] Field to sort by

query string

The filter query

sort_method string

Possible values: [title, artist_name, release_date, last_listen_date, added_date, plays, reposts, saves, most_listens_by_user]

The sort method

sort_direction string

Possible values: [asc, desc]

The sort direction

filter_tracks string

Possible values: [all, public]

Default value: all

Filter by public tracks

gate_condition string[]

Possible values: [ungated, usdc_purchase, follow, tip, nft, token]

Filter tracks by gate condition type. Multiple values can be provided to filter by multiple gate types (OR logic)

Header Parameters

Encoded-Data-Message string

The data that was signed by the user for signature recovery

Encoded-Data-Signature string

The signature of data, used for signature recovery

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