---
title: "Get Users/Tracks/Playlists/Albums that best match the search query"
method: GET
path: "/search/autocomplete"
tags: ["search"]
---

# Get Users/Tracks/Playlists/Albums that best match the search query

`GET /search/autocomplete`

Same as search but optimized for quicker response at the cost of some entity information.

## Query parameters

- `offset` integer
- `limit` integer
- `user_id` string
- `query` string
- `kind` 'all' | 'users' | 'tracks' | 'playlists' | 'albums'
- `includePurchaseable` boolean
- `genre` string[]
- `mood` string[]
- `is_verified` boolean
- `has_downloads` boolean
- `is_purchaseable` boolean
- `key` string[]
- `bpm_min` number
- `bpm_max` number
- `sort_method` 'relevant' | 'popular' | 'recent'

## Response `200`

Success

- SearchAutocompleteResponse
  - `latest_chain_block` integer, required
  - `latest_indexed_block` integer, required
  - `latest_chain_slot_plays` integer, required
  - `latest_indexed_slot_plays` integer, required
  - `signature` string, required
  - `timestamp` string, required
  - `version` VersionMetadata, required
    - `service` string, required
    - `version` string, required
  - `data` SearchModel
    - `users` User[], required
      - `album_count` integer, required
      - `artist_pick_track_id` string
      - `artist_coin_badge` object, required
        - `mint` string
        - `logo_uri` string
        - `banner_image_url` string
        - `ticker` string — The coin symbol/ticker
      - `coin_flair_mint` string
      - `bio` string
      - `cover_photo` CoverPhoto
        - `640x` string
        - `2000x` string
        - `mirrors` string[]
      - `followee_count` integer, required
      - `follower_count` integer, required
      - `handle` string, required
      - `id` string, required
      - `is_verified` boolean, required
      - `twitter_handle` string
      - `instagram_handle` string
      - `tiktok_handle` string
      - `verified_with_twitter` boolean, required
      - `verified_with_instagram` boolean, required
      - `verified_with_tiktok` boolean, required
      - `website` string
      - `donation` string
      - `location` string
      - `name` string, required
      - `playlist_count` integer, required
      - `profile_picture` ProfilePicture
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `repost_count` integer, required
      - `track_count` integer, required
      - `is_deactivated` boolean, required
      - `is_available` boolean, required
      - `erc_wallet` string, required
      - `spl_wallet` string, required
      - `spl_usdc_wallet` string, required
      - `spl_usdc_payout_wallet` string
      - `supporter_count` integer, required
      - `supporting_count` integer, required
      - `total_audio_balance` integer, required
      - `wallet` string, required — The user's Ethereum wallet address for their account
      - `balance` string, required
      - `associated_wallets_balance` string, required
      - `total_balance` string, required
      - `waudio_balance` string, required
      - `associated_sol_wallets_balance` string, required
      - `blocknumber` integer, required
      - `created_at` string, required
      - `is_storage_v2` boolean, required
      - `creator_node_endpoint` string
      - `current_user_followee_follow_count` integer, required
      - `does_current_user_follow` boolean, required
      - `does_current_user_subscribe` boolean, required
      - `does_follow_current_user` boolean, required
      - `handle_lc` string, required
      - `updated_at` string, required
      - `cover_photo_sizes` string
      - `cover_photo_cids` CoverPhoto
        - `640x` string
        - `2000x` string
        - `mirrors` string[]
      - `cover_photo_legacy` string
      - `profile_picture_sizes` string
      - `profile_picture_cids` ProfilePicture
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `profile_picture_legacy` string
      - `has_collectibles` boolean, required
      - `playlist_library` PlaylistLibrary
        - `contents` object[]
      - `allow_ai_attribution` boolean, required
      - `profile_type` string
    - `followed_users` User[]
      - `album_count` integer, required
      - `artist_pick_track_id` string
      - `artist_coin_badge` object, required
        - `mint` string
        - `logo_uri` string
        - `banner_image_url` string
        - `ticker` string — The coin symbol/ticker
      - `coin_flair_mint` string
      - `bio` string
      - `cover_photo` CoverPhoto
        - `640x` string
        - `2000x` string
        - `mirrors` string[]
      - `followee_count` integer, required
      - `follower_count` integer, required
      - `handle` string, required
      - `id` string, required
      - `is_verified` boolean, required
      - `twitter_handle` string
      - `instagram_handle` string
      - `tiktok_handle` string
      - `verified_with_twitter` boolean, required
      - `verified_with_instagram` boolean, required
      - `verified_with_tiktok` boolean, required
      - `website` string
      - `donation` string
      - `location` string
      - `name` string, required
      - `playlist_count` integer, required
      - `profile_picture` ProfilePicture
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `repost_count` integer, required
      - `track_count` integer, required
      - `is_deactivated` boolean, required
      - `is_available` boolean, required
      - `erc_wallet` string, required
      - `spl_wallet` string, required
      - `spl_usdc_wallet` string, required
      - `spl_usdc_payout_wallet` string
      - `supporter_count` integer, required
      - `supporting_count` integer, required
      - `total_audio_balance` integer, required
      - `wallet` string, required — The user's Ethereum wallet address for their account
      - `balance` string, required
      - `associated_wallets_balance` string, required
      - `total_balance` string, required
      - `waudio_balance` string, required
      - `associated_sol_wallets_balance` string, required
      - `blocknumber` integer, required
      - `created_at` string, required
      - `is_storage_v2` boolean, required
      - `creator_node_endpoint` string
      - `current_user_followee_follow_count` integer, required
      - `does_current_user_follow` boolean, required
      - `does_current_user_subscribe` boolean, required
      - `does_follow_current_user` boolean, required
      - `handle_lc` string, required
      - `updated_at` string, required
      - `cover_photo_sizes` string
      - `cover_photo_cids` CoverPhoto
        - `640x` string
        - `2000x` string
        - `mirrors` string[]
      - `cover_photo_legacy` string
      - `profile_picture_sizes` string
      - `profile_picture_cids` ProfilePicture
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `profile_picture_legacy` string
      - `has_collectibles` boolean, required
      - `playlist_library` PlaylistLibrary
        - `contents` object[]
      - `allow_ai_attribution` boolean, required
      - `profile_type` string
    - `tracks` SearchTrack[], required
      - `artwork` TrackArtwork, required
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `description` string
      - `genre` string, required
      - `id` string, required
      - `track_cid` string
      - `preview_cid` string
      - `orig_file_cid` string
      - `orig_filename` string
      - `is_original_available` boolean, required
      - `mood` string
      - `release_date` string, date
      - `remix_of` RemixParent, required
        - `tracks` Remix[]
          - `parent_track_id` string, required
          - `user` User, required
            - `album_count` integer, required
            - `artist_pick_track_id` string
            - `artist_coin_badge` object, required
              - …
            - `coin_flair_mint` string
            - `bio` string
            - `cover_photo` CoverPhoto
              - …
            - `followee_count` integer, required
            - `follower_count` integer, required
            - `handle` string, required
            - `id` string, required
            - `is_verified` boolean, required
            - `twitter_handle` string
            - `instagram_handle` string
            - `tiktok_handle` string
            - `verified_with_twitter` boolean, required
            - `verified_with_instagram` boolean, required
            - `verified_with_tiktok` boolean, required
            - `website` string
            - `donation` string
            - `location` string
            - `name` string, required
            - `playlist_count` integer, required
            - `profile_picture` ProfilePicture
              - …
            - `repost_count` integer, required
            - `track_count` integer, required
            - `is_deactivated` boolean, required
            - `is_available` boolean, required
            - `erc_wallet` string, required
            - `spl_wallet` string, required
            - `spl_usdc_wallet` string, required
            - `spl_usdc_payout_wallet` string
            - `supporter_count` integer, required
            - `supporting_count` integer, required
            - `total_audio_balance` integer, required
            - `wallet` string, required — The user's Ethereum wallet address for their account
            - `balance` string, required
            - `associated_wallets_balance` string, required
            - `total_balance` string, required
            - `waudio_balance` string, required
            - `associated_sol_wallets_balance` string, required
            - `blocknumber` integer, required
            - `created_at` string, required
            - `is_storage_v2` boolean, required
            - `creator_node_endpoint` string
            - `current_user_followee_follow_count` integer, required
            - `does_current_user_follow` boolean, required
            - `does_current_user_subscribe` boolean, required
            - `does_follow_current_user` boolean, required
            - `handle_lc` string, required
            - `updated_at` string, required
            - `cover_photo_sizes` string
            - `cover_photo_cids` CoverPhoto
              - …
            - `cover_photo_legacy` string
            - `profile_picture_sizes` string
            - `profile_picture_cids` ProfilePicture
              - …
            - `profile_picture_legacy` string
            - `has_collectibles` boolean, required
            - `playlist_library` PlaylistLibrary
              - …
            - `allow_ai_attribution` boolean, required
            - `profile_type` string
          - `has_remix_author_reposted` boolean, required
          - `has_remix_author_saved` boolean, required
      - `repost_count` integer, required
      - `favorite_count` integer, required
      - `comment_count` integer, required
      - `tags` string
      - `title` string, required
      - `user` User, required
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `collaborators` User[] — Accepted collaborator artists on the track.
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `pending_collaborators` User[] — Pending collaborator invites; only present on the owner's own tracks.
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `duration` integer, required
      - `is_downloadable` boolean, required
      - `play_count` integer, required
      - `permalink` string, required
      - `is_streamable` boolean
      - `ddex_app` string
      - `playlists_containing_track` integer[]
      - `pinned_comment_id` integer
      - `album_backlink` AlbumBacklink
        - `playlist_id` integer, required
        - `playlist_name` string, required
        - `permalink` string, required
      - `access` Access, required
        - `stream` boolean, required
        - `download` boolean, required
      - `blocknumber` integer, required — The blocknumber this track was last updated
      - `create_date` string
      - `cover_art_sizes` string, required
      - `cover_art_cids` CoverArt
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `created_at` string, required
      - `credits_splits` string
      - `isrc` string
      - `license` string
      - `iswc` string
      - `field_visibility` FieldVisibility, required
        - `mood` boolean, required
        - `tags` boolean, required
        - `genre` boolean, required
        - `share` boolean, required
        - `play_count` boolean, required
        - `remixes` boolean, required
      - `followee_reposts` Repost[]
        - `repost_item_id` string, required
        - `repost_type` string, required
        - `user_id` string, required
      - `has_current_user_reposted` boolean, required
      - `is_scheduled_release` boolean, required
      - `is_unlisted` boolean, required
      - `has_current_user_saved` boolean, required
      - `followee_favorites` Favorite[]
        - `favorite_item_id` string, required
        - `favorite_type` string, required
        - `user_id` string, required
        - `created_at` string, required
      - `route_id` string, required
      - `stem_of` StemParent
        - `category` string, required
        - `parent_track_id` integer, required
      - `track_segments` TrackSegment[], required
        - `duration` number, required
        - `multihash` string, required
      - `updated_at` string, required
      - `user_id` string, required
      - `is_delete` boolean, required
      - `cover_art` string
      - `is_available` boolean, required
      - `ai_attribution_user_id` integer
      - `allowed_api_keys` string[]
      - `audio_upload_id` string
      - `preview_start_seconds` number
      - `bpm` number
      - `is_custom_bpm` boolean
      - `musical_key` string
      - `is_custom_musical_key` boolean
      - `audio_analysis_error_count` integer
      - `comments_disabled` boolean
      - `ddex_release_ids` object
      - `artists` object[]
      - `resource_contributors` DdexResourceContributor[], nullable
        - `name` string, required — Contributor name
        - `roles` string[], required — Contributor roles
        - `sequence_number` integer — Sequence number for ordering
      - `indirect_resource_contributors` DdexResourceContributor[], nullable
        - `name` string, required — Contributor name
        - `roles` string[], required — Contributor roles
        - `sequence_number` integer — Sequence number for ordering
      - `rights_controller` DdexRightsController — DDEX rights controller
        - `name` string, required
        - `roles` string[], required
        - `rights_share_unknown` string — Optional
      - `copyright_line` DdexCopyright
        - `year` string, required — Copyright year (4 characters)
        - `text` string, required — Copyright text
      - `producer_copyright_line` DdexCopyright
        - `year` string, required — Copyright year (4 characters)
        - `text` string, required — Copyright text
      - `parental_warning_type` string, nullable
      - `is_stream_gated` boolean, required — Whether or not the owner has restricted streaming behind an access gate
      - `stream_conditions` union
        - TipGate
          - `tip_user_id` integer, required — Must tip the given user ID to unlock
        - FollowGate
          - `follow_user_id` integer, required — Must follow the given user ID to unlock
        - PurchaseGate
          - `usdc_purchase` UsdcGate, required
            - `price` integer, required — The price in USDC needed to unlock
            - `splits` PaymentSplit[], required
              - …
        - TokenGate
          - `token_gate` ExtendedTokenGate, required
            - `token_mint` string, required — The mint of the token needed to unlock
            - `token_amount` integer, required — The amount of the token needed to unlock
      - `is_download_gated` boolean, required — Whether or not the owner has restricted downloading behind an access gate
      - `download_conditions` union
        - TipGate
          - `tip_user_id` integer, required — Must tip the given user ID to unlock
        - FollowGate
          - `follow_user_id` integer, required — Must follow the given user ID to unlock
        - PurchaseGate
          - `usdc_purchase` UsdcGate, required
            - `price` integer, required — The price in USDC needed to unlock
            - `splits` PaymentSplit[], required
              - …
        - TokenGate
          - `token_gate` ExtendedTokenGate, required
            - `token_mint` string, required — The mint of the token needed to unlock
            - `token_amount` integer, required — The amount of the token needed to unlock
      - `cover_original_song_title` string
      - `cover_original_artist` string
      - `is_owned_by_user` boolean, required — Indicates whether the track is owned by the user for MRI sake
      - `stream` UrlWithMirrors, required
        - `url` string
        - `mirrors` string[], required
      - `download` UrlWithMirrors, required
        - `url` string
        - `mirrors` string[], required
      - `preview` UrlWithMirrors, required
        - `url` string
        - `mirrors` string[], required
    - `saved_tracks` SearchTrack[]
      - `artwork` TrackArtwork, required
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `description` string
      - `genre` string, required
      - `id` string, required
      - `track_cid` string
      - `preview_cid` string
      - `orig_file_cid` string
      - `orig_filename` string
      - `is_original_available` boolean, required
      - `mood` string
      - `release_date` string, date
      - `remix_of` RemixParent, required
        - `tracks` Remix[]
          - `parent_track_id` string, required
          - `user` User, required
            - `album_count` integer, required
            - `artist_pick_track_id` string
            - `artist_coin_badge` object, required
              - …
            - `coin_flair_mint` string
            - `bio` string
            - `cover_photo` CoverPhoto
              - …
            - `followee_count` integer, required
            - `follower_count` integer, required
            - `handle` string, required
            - `id` string, required
            - `is_verified` boolean, required
            - `twitter_handle` string
            - `instagram_handle` string
            - `tiktok_handle` string
            - `verified_with_twitter` boolean, required
            - `verified_with_instagram` boolean, required
            - `verified_with_tiktok` boolean, required
            - `website` string
            - `donation` string
            - `location` string
            - `name` string, required
            - `playlist_count` integer, required
            - `profile_picture` ProfilePicture
              - …
            - `repost_count` integer, required
            - `track_count` integer, required
            - `is_deactivated` boolean, required
            - `is_available` boolean, required
            - `erc_wallet` string, required
            - `spl_wallet` string, required
            - `spl_usdc_wallet` string, required
            - `spl_usdc_payout_wallet` string
            - `supporter_count` integer, required
            - `supporting_count` integer, required
            - `total_audio_balance` integer, required
            - `wallet` string, required — The user's Ethereum wallet address for their account
            - `balance` string, required
            - `associated_wallets_balance` string, required
            - `total_balance` string, required
            - `waudio_balance` string, required
            - `associated_sol_wallets_balance` string, required
            - `blocknumber` integer, required
            - `created_at` string, required
            - `is_storage_v2` boolean, required
            - `creator_node_endpoint` string
            - `current_user_followee_follow_count` integer, required
            - `does_current_user_follow` boolean, required
            - `does_current_user_subscribe` boolean, required
            - `does_follow_current_user` boolean, required
            - `handle_lc` string, required
            - `updated_at` string, required
            - `cover_photo_sizes` string
            - `cover_photo_cids` CoverPhoto
              - …
            - `cover_photo_legacy` string
            - `profile_picture_sizes` string
            - `profile_picture_cids` ProfilePicture
              - …
            - `profile_picture_legacy` string
            - `has_collectibles` boolean, required
            - `playlist_library` PlaylistLibrary
              - …
            - `allow_ai_attribution` boolean, required
            - `profile_type` string
          - `has_remix_author_reposted` boolean, required
          - `has_remix_author_saved` boolean, required
      - `repost_count` integer, required
      - `favorite_count` integer, required
      - `comment_count` integer, required
      - `tags` string
      - `title` string, required
      - `user` User, required
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `collaborators` User[] — Accepted collaborator artists on the track.
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `pending_collaborators` User[] — Pending collaborator invites; only present on the owner's own tracks.
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `duration` integer, required
      - `is_downloadable` boolean, required
      - `play_count` integer, required
      - `permalink` string, required
      - `is_streamable` boolean
      - `ddex_app` string
      - `playlists_containing_track` integer[]
      - `pinned_comment_id` integer
      - `album_backlink` AlbumBacklink
        - `playlist_id` integer, required
        - `playlist_name` string, required
        - `permalink` string, required
      - `access` Access, required
        - `stream` boolean, required
        - `download` boolean, required
      - `blocknumber` integer, required — The blocknumber this track was last updated
      - `create_date` string
      - `cover_art_sizes` string, required
      - `cover_art_cids` CoverArt
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `created_at` string, required
      - `credits_splits` string
      - `isrc` string
      - `license` string
      - `iswc` string
      - `field_visibility` FieldVisibility, required
        - `mood` boolean, required
        - `tags` boolean, required
        - `genre` boolean, required
        - `share` boolean, required
        - `play_count` boolean, required
        - `remixes` boolean, required
      - `followee_reposts` Repost[]
        - `repost_item_id` string, required
        - `repost_type` string, required
        - `user_id` string, required
      - `has_current_user_reposted` boolean, required
      - `is_scheduled_release` boolean, required
      - `is_unlisted` boolean, required
      - `has_current_user_saved` boolean, required
      - `followee_favorites` Favorite[]
        - `favorite_item_id` string, required
        - `favorite_type` string, required
        - `user_id` string, required
        - `created_at` string, required
      - `route_id` string, required
      - `stem_of` StemParent
        - `category` string, required
        - `parent_track_id` integer, required
      - `track_segments` TrackSegment[], required
        - `duration` number, required
        - `multihash` string, required
      - `updated_at` string, required
      - `user_id` string, required
      - `is_delete` boolean, required
      - `cover_art` string
      - `is_available` boolean, required
      - `ai_attribution_user_id` integer
      - `allowed_api_keys` string[]
      - `audio_upload_id` string
      - `preview_start_seconds` number
      - `bpm` number
      - `is_custom_bpm` boolean
      - `musical_key` string
      - `is_custom_musical_key` boolean
      - `audio_analysis_error_count` integer
      - `comments_disabled` boolean
      - `ddex_release_ids` object
      - `artists` object[]
      - `resource_contributors` DdexResourceContributor[], nullable
        - `name` string, required — Contributor name
        - `roles` string[], required — Contributor roles
        - `sequence_number` integer — Sequence number for ordering
      - `indirect_resource_contributors` DdexResourceContributor[], nullable
        - `name` string, required — Contributor name
        - `roles` string[], required — Contributor roles
        - `sequence_number` integer — Sequence number for ordering
      - `rights_controller` DdexRightsController — DDEX rights controller
        - `name` string, required
        - `roles` string[], required
        - `rights_share_unknown` string — Optional
      - `copyright_line` DdexCopyright
        - `year` string, required — Copyright year (4 characters)
        - `text` string, required — Copyright text
      - `producer_copyright_line` DdexCopyright
        - `year` string, required — Copyright year (4 characters)
        - `text` string, required — Copyright text
      - `parental_warning_type` string, nullable
      - `is_stream_gated` boolean, required — Whether or not the owner has restricted streaming behind an access gate
      - `stream_conditions` union
        - TipGate
          - `tip_user_id` integer, required — Must tip the given user ID to unlock
        - FollowGate
          - `follow_user_id` integer, required — Must follow the given user ID to unlock
        - PurchaseGate
          - `usdc_purchase` UsdcGate, required
            - `price` integer, required — The price in USDC needed to unlock
            - `splits` PaymentSplit[], required
              - …
        - TokenGate
          - `token_gate` ExtendedTokenGate, required
            - `token_mint` string, required — The mint of the token needed to unlock
            - `token_amount` integer, required — The amount of the token needed to unlock
      - `is_download_gated` boolean, required — Whether or not the owner has restricted downloading behind an access gate
      - `download_conditions` union
        - TipGate
          - `tip_user_id` integer, required — Must tip the given user ID to unlock
        - FollowGate
          - `follow_user_id` integer, required — Must follow the given user ID to unlock
        - PurchaseGate
          - `usdc_purchase` UsdcGate, required
            - `price` integer, required — The price in USDC needed to unlock
            - `splits` PaymentSplit[], required
              - …
        - TokenGate
          - `token_gate` ExtendedTokenGate, required
            - `token_mint` string, required — The mint of the token needed to unlock
            - `token_amount` integer, required — The amount of the token needed to unlock
      - `cover_original_song_title` string
      - `cover_original_artist` string
      - `is_owned_by_user` boolean, required — Indicates whether the track is owned by the user for MRI sake
      - `stream` UrlWithMirrors, required
        - `url` string
        - `mirrors` string[], required
      - `download` UrlWithMirrors, required
        - `url` string
        - `mirrors` string[], required
      - `preview` UrlWithMirrors, required
        - `url` string
        - `mirrors` string[], required
    - `playlists` SearchPlaylist[], required
      - `artwork` PlaylistArtwork
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `description` string
      - `permalink` string, required
      - `id` string, required
      - `is_album` boolean, required
      - `is_image_autogenerated` boolean, required
      - `playlist_name` string, required
      - `playlist_contents` PlaylistAddedTimestamp[], required
        - `metadata_timestamp` integer — Optional. Metadata timestamp for when the track was added to the playlist.
        - `timestamp` integer, required
        - `track_id` string, required
      - `repost_count` integer, required
      - `favorite_count` integer, required
      - `total_play_count` integer, required
      - `user` User, required
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `ddex_app` string
      - `access` Access, required
        - `stream` boolean, required
        - `download` boolean, required
      - `upc` string
      - `track_count` integer, required
      - `blocknumber` integer, required
      - `created_at` string, required
      - `followee_reposts` Repost[]
        - `repost_item_id` string, required
        - `repost_type` string, required
        - `user_id` string, required
      - `followee_favorites` Favorite[]
        - `favorite_item_id` string, required
        - `favorite_type` string, required
        - `user_id` string, required
        - `created_at` string, required
      - `has_current_user_reposted` boolean, required
      - `has_current_user_saved` boolean, required
      - `is_delete` boolean, required
      - `is_private` boolean, required
      - `updated_at` string, required
      - `added_timestamps` PlaylistAddedTimestamp[], required — DEPRECATED. Use playlist_contents instead.
        - `metadata_timestamp` integer — Optional. Metadata timestamp for when the track was added to the playlist.
        - `timestamp` integer, required
        - `track_id` string, required
      - `user_id` string, required
      - `tracks` Track[]
        - `artwork` TrackArtwork, required
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `description` string
        - `genre` string, required
        - `id` string, required
        - `track_cid` string
        - `preview_cid` string
        - `orig_file_cid` string
        - `orig_filename` string
        - `is_original_available` boolean, required
        - `mood` string
        - `release_date` string, date
        - `remix_of` RemixParent, required
          - `tracks` Remix[]
            - `parent_track_id` string, required
            - `user` User, required
              - …
            - `has_remix_author_reposted` boolean, required
            - `has_remix_author_saved` boolean, required
        - `repost_count` integer, required
        - `favorite_count` integer, required
        - `comment_count` integer, required
        - `tags` string
        - `title` string, required
        - `user` User, required
          - `album_count` integer, required
          - `artist_pick_track_id` string
          - `artist_coin_badge` object, required
            - `mint` string
            - `logo_uri` string
            - `banner_image_url` string
            - `ticker` string — The coin symbol/ticker
          - `coin_flair_mint` string
          - `bio` string
          - `cover_photo` CoverPhoto
            - `640x` string
            - `2000x` string
            - `mirrors` string[]
          - `followee_count` integer, required
          - `follower_count` integer, required
          - `handle` string, required
          - `id` string, required
          - `is_verified` boolean, required
          - `twitter_handle` string
          - `instagram_handle` string
          - `tiktok_handle` string
          - `verified_with_twitter` boolean, required
          - `verified_with_instagram` boolean, required
          - `verified_with_tiktok` boolean, required
          - `website` string
          - `donation` string
          - `location` string
          - `name` string, required
          - `playlist_count` integer, required
          - `profile_picture` ProfilePicture
            - `150x150` string
            - `480x480` string
            - `1000x1000` string
            - `mirrors` string[]
          - `repost_count` integer, required
          - `track_count` integer, required
          - `is_deactivated` boolean, required
          - `is_available` boolean, required
          - `erc_wallet` string, required
          - `spl_wallet` string, required
          - `spl_usdc_wallet` string, required
          - `spl_usdc_payout_wallet` string
          - `supporter_count` integer, required
          - `supporting_count` integer, required
          - `total_audio_balance` integer, required
          - `wallet` string, required — The user's Ethereum wallet address for their account
          - `balance` string, required
          - `associated_wallets_balance` string, required
          - `total_balance` string, required
          - `waudio_balance` string, required
          - `associated_sol_wallets_balance` string, required
          - `blocknumber` integer, required
          - `created_at` string, required
          - `is_storage_v2` boolean, required
          - `creator_node_endpoint` string
          - `current_user_followee_follow_count` integer, required
          - `does_current_user_follow` boolean, required
          - `does_current_user_subscribe` boolean, required
          - `does_follow_current_user` boolean, required
          - `handle_lc` string, required
          - `updated_at` string, required
          - `cover_photo_sizes` string
          - `cover_photo_cids` CoverPhoto
            - `640x` string
            - `2000x` string
            - `mirrors` string[]
          - `cover_photo_legacy` string
          - `profile_picture_sizes` string
          - `profile_picture_cids` ProfilePicture
            - `150x150` string
            - `480x480` string
            - `1000x1000` string
            - `mirrors` string[]
          - `profile_picture_legacy` string
          - `has_collectibles` boolean, required
          - `playlist_library` PlaylistLibrary
            - `contents` object[]
              - …
          - `allow_ai_attribution` boolean, required
          - `profile_type` string
        - `collaborators` User[] — Accepted collaborator artists on the track.
          - `album_count` integer, required
          - `artist_pick_track_id` string
          - `artist_coin_badge` object, required
            - `mint` string
            - `logo_uri` string
            - `banner_image_url` string
            - `ticker` string — The coin symbol/ticker
          - `coin_flair_mint` string
          - `bio` string
          - `cover_photo` CoverPhoto
            - `640x` string
            - `2000x` string
            - `mirrors` string[]
          - `followee_count` integer, required
          - `follower_count` integer, required
          - `handle` string, required
          - `id` string, required
          - `is_verified` boolean, required
          - `twitter_handle` string
          - `instagram_handle` string
          - `tiktok_handle` string
          - `verified_with_twitter` boolean, required
          - `verified_with_instagram` boolean, required
          - `verified_with_tiktok` boolean, required
          - `website` string
          - `donation` string
          - `location` string
          - `name` string, required
          - `playlist_count` integer, required
          - `profile_picture` ProfilePicture
            - `150x150` string
            - `480x480` string
            - `1000x1000` string
            - `mirrors` string[]
          - `repost_count` integer, required
          - `track_count` integer, required
          - `is_deactivated` boolean, required
          - `is_available` boolean, required
          - `erc_wallet` string, required
          - `spl_wallet` string, required
          - `spl_usdc_wallet` string, required
          - `spl_usdc_payout_wallet` string
          - `supporter_count` integer, required
          - `supporting_count` integer, required
          - `total_audio_balance` integer, required
          - `wallet` string, required — The user's Ethereum wallet address for their account
          - `balance` string, required
          - `associated_wallets_balance` string, required
          - `total_balance` string, required
          - `waudio_balance` string, required
          - `associated_sol_wallets_balance` string, required
          - `blocknumber` integer, required
          - `created_at` string, required
          - `is_storage_v2` boolean, required
          - `creator_node_endpoint` string
          - `current_user_followee_follow_count` integer, required
          - `does_current_user_follow` boolean, required
          - `does_current_user_subscribe` boolean, required
          - `does_follow_current_user` boolean, required
          - `handle_lc` string, required
          - `updated_at` string, required
          - `cover_photo_sizes` string
          - `cover_photo_cids` CoverPhoto
            - `640x` string
            - `2000x` string
            - `mirrors` string[]
          - `cover_photo_legacy` string
          - `profile_picture_sizes` string
          - `profile_picture_cids` ProfilePicture
            - `150x150` string
            - `480x480` string
            - `1000x1000` string
            - `mirrors` string[]
          - `profile_picture_legacy` string
          - `has_collectibles` boolean, required
          - `playlist_library` PlaylistLibrary
            - `contents` object[]
              - …
          - `allow_ai_attribution` boolean, required
          - `profile_type` string
        - `pending_collaborators` User[] — Pending collaborator invites; only present on the owner's own tracks.
          - `album_count` integer, required
          - `artist_pick_track_id` string
          - `artist_coin_badge` object, required
            - `mint` string
            - `logo_uri` string
            - `banner_image_url` string
            - `ticker` string — The coin symbol/ticker
          - `coin_flair_mint` string
          - `bio` string
          - `cover_photo` CoverPhoto
            - `640x` string
            - `2000x` string
            - `mirrors` string[]
          - `followee_count` integer, required
          - `follower_count` integer, required
          - `handle` string, required
          - `id` string, required
          - `is_verified` boolean, required
          - `twitter_handle` string
          - `instagram_handle` string
          - `tiktok_handle` string
          - `verified_with_twitter` boolean, required
          - `verified_with_instagram` boolean, required
          - `verified_with_tiktok` boolean, required
          - `website` string
          - `donation` string
          - `location` string
          - `name` string, required
          - `playlist_count` integer, required
          - `profile_picture` ProfilePicture
            - `150x150` string
            - `480x480` string
            - `1000x1000` string
            - `mirrors` string[]
          - `repost_count` integer, required
          - `track_count` integer, required
          - `is_deactivated` boolean, required
          - `is_available` boolean, required
          - `erc_wallet` string, required
          - `spl_wallet` string, required
          - `spl_usdc_wallet` string, required
          - `spl_usdc_payout_wallet` string
          - `supporter_count` integer, required
          - `supporting_count` integer, required
          - `total_audio_balance` integer, required
          - `wallet` string, required — The user's Ethereum wallet address for their account
          - `balance` string, required
          - `associated_wallets_balance` string, required
          - `total_balance` string, required
          - `waudio_balance` string, required
          - `associated_sol_wallets_balance` string, required
          - `blocknumber` integer, required
          - `created_at` string, required
          - `is_storage_v2` boolean, required
          - `creator_node_endpoint` string
          - `current_user_followee_follow_count` integer, required
          - `does_current_user_follow` boolean, required
          - `does_current_user_subscribe` boolean, required
          - `does_follow_current_user` boolean, required
          - `handle_lc` string, required
          - `updated_at` string, required
          - `cover_photo_sizes` string
          - `cover_photo_cids` CoverPhoto
            - `640x` string
            - `2000x` string
            - `mirrors` string[]
          - `cover_photo_legacy` string
          - `profile_picture_sizes` string
          - `profile_picture_cids` ProfilePicture
            - `150x150` string
            - `480x480` string
            - `1000x1000` string
            - `mirrors` string[]
          - `profile_picture_legacy` string
          - `has_collectibles` boolean, required
          - `playlist_library` PlaylistLibrary
            - `contents` object[]
              - …
          - `allow_ai_attribution` boolean, required
          - `profile_type` string
        - `duration` integer, required
        - `is_downloadable` boolean, required
        - `play_count` integer, required
        - `permalink` string, required
        - `is_streamable` boolean
        - `ddex_app` string
        - `playlists_containing_track` integer[]
        - `pinned_comment_id` integer
        - `album_backlink` AlbumBacklink
          - `playlist_id` integer, required
          - `playlist_name` string, required
          - `permalink` string, required
        - `access` Access, required
          - `stream` boolean, required
          - `download` boolean, required
        - `blocknumber` integer, required — The blocknumber this track was last updated
        - `create_date` string
        - `cover_art_sizes` string, required
        - `cover_art_cids` CoverArt
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `created_at` string, required
        - `credits_splits` string
        - `isrc` string
        - `license` string
        - `iswc` string
        - `field_visibility` FieldVisibility, required
          - `mood` boolean, required
          - `tags` boolean, required
          - `genre` boolean, required
          - `share` boolean, required
          - `play_count` boolean, required
          - `remixes` boolean, required
        - `followee_reposts` Repost[], required
          - `repost_item_id` string, required
          - `repost_type` string, required
          - `user_id` string, required
        - `has_current_user_reposted` boolean, required
        - `is_scheduled_release` boolean, required
        - `is_unlisted` boolean, required
        - `has_current_user_saved` boolean, required
        - `followee_favorites` Favorite[], required
          - `favorite_item_id` string, required
          - `favorite_type` string, required
          - `user_id` string, required
          - `created_at` string, required
        - `route_id` string, required
        - `stem_of` StemParent
          - `category` string, required
          - `parent_track_id` integer, required
        - `track_segments` TrackSegment[], required
          - `duration` number, required
          - `multihash` string, required
        - `updated_at` string, required
        - `user_id` string, required
        - `is_delete` boolean, required
        - `cover_art` string
        - `is_available` boolean, required
        - `ai_attribution_user_id` integer
        - `allowed_api_keys` string[]
        - `audio_upload_id` string
        - `preview_start_seconds` number
        - `bpm` number
        - `is_custom_bpm` boolean
        - `musical_key` string
        - `is_custom_musical_key` boolean
        - `audio_analysis_error_count` integer
        - `comments_disabled` boolean
        - `ddex_release_ids` object
        - `artists` object[]
        - `resource_contributors` DdexResourceContributor[], nullable
          - `name` string, required — Contributor name
          - `roles` string[], required — Contributor roles
          - `sequence_number` integer — Sequence number for ordering
        - `indirect_resource_contributors` DdexResourceContributor[], nullable
          - `name` string, required — Contributor name
          - `roles` string[], required — Contributor roles
          - `sequence_number` integer — Sequence number for ordering
        - `rights_controller` DdexRightsController — DDEX rights controller
          - `name` string, required
          - `roles` string[], required
          - `rights_share_unknown` string — Optional
        - `copyright_line` DdexCopyright
          - `year` string, required — Copyright year (4 characters)
          - `text` string, required — Copyright text
        - `producer_copyright_line` DdexCopyright
          - `year` string, required — Copyright year (4 characters)
          - `text` string, required — Copyright text
        - `parental_warning_type` string, nullable
        - `is_stream_gated` boolean, required — Whether or not the owner has restricted streaming behind an access gate
        - `access_authorities` string[], nullable — Wallet addresses that can sign to authorize stream access (programmable distribution). When empty or omitted, the track is public and validator/creator nodes can serve it.
        - `stream_conditions` union
          - TipGate
            - `tip_user_id` integer, required — Must tip the given user ID to unlock
          - FollowGate
            - `follow_user_id` integer, required — Must follow the given user ID to unlock
          - PurchaseGate
            - `usdc_purchase` UsdcGate, required
              - …
          - TokenGate
            - `token_gate` ExtendedTokenGate, required
              - …
        - `is_download_gated` boolean, required — Whether or not the owner has restricted downloading behind an access gate
        - `download_conditions` union
          - TipGate
            - `tip_user_id` integer, required — Must tip the given user ID to unlock
          - FollowGate
            - `follow_user_id` integer, required — Must follow the given user ID to unlock
          - PurchaseGate
            - `usdc_purchase` UsdcGate, required
              - …
          - TokenGate
            - `token_gate` ExtendedTokenGate, required
              - …
        - `cover_original_song_title` string
        - `cover_original_artist` string
        - `is_owned_by_user` boolean, required — Indicates whether the track is owned by the user for MRI sake
        - `stream` UrlWithMirrors, required
          - `url` string
          - `mirrors` string[], required
        - `download` UrlWithMirrors, required
          - `url` string
          - `mirrors` string[], required
        - `preview` UrlWithMirrors, required
          - `url` string
          - `mirrors` string[], required
      - `cover_art` string
      - `cover_art_sizes` string
      - `cover_art_cids` PlaylistArtwork
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `is_stream_gated` boolean, required
      - `stream_conditions` union
        - TipGate
          - `tip_user_id` integer, required — Must tip the given user ID to unlock
        - FollowGate
          - `follow_user_id` integer, required — Must follow the given user ID to unlock
        - PurchaseGate
          - `usdc_purchase` UsdcGate, required
            - `price` integer, required — The price in USDC needed to unlock
            - `splits` PaymentSplit[], required
              - …
        - TokenGate
          - `token_gate` ExtendedTokenGate, required
            - `token_mint` string, required — The mint of the token needed to unlock
            - `token_amount` integer, required — The amount of the token needed to unlock
      - `is_scheduled_release` boolean, required
      - `release_date` string
      - `ddex_release_ids` object
      - `artists` object[]
      - `copyright_line` object
      - `producer_copyright_line` object
      - `parental_warning_type` string, nullable
    - `saved_playlists` SearchPlaylist[]
      - `artwork` PlaylistArtwork
        - `150x150` string
        - `480x480` string
        - `1000x1000` string
        - `mirrors` string[]
      - `description` string
      - `permalink` string, required
      - `id` string, required
      - `is_album` boolean, required
      - `is_image_autogenerated` boolean, required
      - `playlist_name` string, required
      - `playlist_contents` PlaylistAddedTimestamp[], required
        - `metadata_timestamp` integer — Optional. Metadata timestamp for when the track was added to the playlist.
        - `timestamp` integer, required
        - `track_id` string, required
      - `repost_count` integer, required
      - `favorite_count` integer, required
      - `total_play_count` integer, required
      - `user` User, required
        - `album_count` integer, required
        - `artist_pick_track_id` string
        - `artist_coin_badge` object, required
          - `mint` string
          - `logo_uri` string
          - `banner_image_url` string
          - `ticker` string — The coin symbol/ticker
        - `coin_flair_mint` string
        - `bio` string
        - `cover_photo` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `followee_count` integer, required
        - `follower_count` integer, required
        - `handle` string, required
        - `id` string, required
        - `is_verified` boolean, required
        - `twitter_handle` string
        - `instagram_handle` string
        - `tiktok_handle` string
        - `verified_with_twitter` boolean, required
        - `verified_with_instagram` boolean, required
        - `verified_with_tiktok` boolean, required
        - `website` string
        - `donation` string
        - `location` string
        - `name` string, required
        - `playlist_count` integer, required
        - `profile_picture` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `repost_count` integer, required
        - `track_count` integer, required
        - `is_deactivated` boolean, required
        - `is_available` boolean, required
        - `erc_wallet` string, required
        - `spl_wallet` string, required
        - `spl_usdc_wallet` string, required
        - `spl_usdc_payout_wallet` string
        - `supporter_count` integer, required
        - `supporting_count` integer, required
        - `total_audio_balance` integer, required
        - `wallet` string, required — The user's Ethereum wallet address for their account
        - `balance` string, required
        - `associated_wallets_balance` string, required
        - `total_balance` string, required
        - `waudio_balance` string, required
        - `associated_sol_wallets_balance` string, required
        - `blocknumber` integer, required
        - `created_at` string, required
        - `is_storage_v2` boolean, required
        - `creator_node_endpoint` string
        - `current_user_followee_follow_count` integer, required
        - `does_current_user_follow` boolean, required
        - `does_current_user_subscribe` boolean, required
        - `does_follow_current_user` boolean, required
        - `handle_lc` string, required
        - `updated_at` string, required
        - `cover_photo_sizes` string
        - `cover_photo_cids` CoverPhoto
          - `640x` string
          - `2000x` string
          - `mirrors` string[]
        - `cover_photo_legacy` string
        - `profile_picture_sizes` string
        - `profile_picture_cids` ProfilePicture
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `profile_picture_legacy` string
        - `has_collectibles` boolean, required
        - `playlist_library` PlaylistLibrary
          - `contents` object[]
        - `allow_ai_attribution` boolean, required
        - `profile_type` string
      - `ddex_app` string
      - `access` Access, required
        - `stream` boolean, required
        - `download` boolean, required
      - `upc` string
      - `track_count` integer, required
      - `blocknumber` integer, required
      - `created_at` string, required
      - `followee_reposts` Repost[]
        - `repost_item_id` string, required
        - `repost_type` string, required
        - `user_id` string, required
      - `followee_favorites` Favorite[]
        - `favorite_item_id` string, required
        - `favorite_type` string, required
        - `user_id` string, required
        - `created_at` string, required
      - `has_current_user_reposted` boolean, required
      - `has_current_user_saved` boolean, required
      - `is_delete` boolean, required
      - `is_private` boolean, required
      - `updated_at` string, required
      - `added_timestamps` PlaylistAddedTimestamp[], required — DEPRECATED. Use playlist_contents instead.
        - `metadata_timestamp` integer — Optional. Metadata timestamp for when the track was added to the playlist.
        - `timestamp` integer, required
        - `track_id` string, required
      - `user_id` string, required
      - `tracks` Track[]
        - `artwork` TrackArtwork, required
          - `150x150` string
          - `480x480` string
          - `1000x1000` string
          - `mirrors` string[]
        - `description` string
        - `genre` string, required
        - `id` string, required
        - `track_cid` string
        - `preview_cid` string
        - `orig_file_cid` string
        - `orig_filename` string
        - `is_original_available` boolean, required
        - `mood` string
        - `release_date` string, date
        - `remix_of` RemixParent, required
          - `tracks` Remix[]
            - `parent_track_id` string, required
            - `user` User, required
              - …
            - `has_remix_author_reposted` boolean, required
            - `has_remix_author_saved` boolean, required
        - `repost_count` integer, required
        - `favorite_count` integer, required
        - `comment_count` integer, required
        - `tags` string
        - `title` string, required
        - `user` User, required
          - `album_count` integer, required
          - `artist_pick_track_id` string
          - `artist_coin_badge` object, required
            - `mint` string
            - `logo_uri` string
            - `banner_image_url` string
            - `ticker` string — The coin symbol/ticker
          - `coin_flair_mint` string
          - `bio` string
          - `cover_photo` CoverPhoto
            - `640x` string
            - `2000x` string
            - `mirrors` string[]
          - `followee_count` integer, required
          - `follower_count` integer, required
          - `handle` string, required
          - `id` string, required
          - `is_verified` boolean, required
          - `twitter_handle` string
          - `instagram_handle` string
          - `tiktok_handle` string
          - `verified_with_twitter` boolean, required
          - `verified_with_instagram` boolean, required
          - `verified_with_tiktok` boolean, required
          - `website` string
          - `donation` string
          - `location` string
          - `name` string, required
          - `playlist_count` integer, required
- … truncated; see the full OpenAPI document linked below

## Other responses

- `400` — Bad request
- `500` — Server error

---

[API](https://skmtc.dev/audius/apis/audius-api.md) · [All operations](https://skmtc.dev/audius/apis/audius-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/audius/audius-api/revisions/940230b2ed3d/schema)