Get started

Overview OAuth Simplified

Accounts

GET /get_me GET /tokens POST /login DELETE /logout POST /register POST /confirm POST /reset POST /reset_password GET /incoming_requests GET /outcoming_requests

Users

GET /user/{user_tag} GET /user/{user_tag}/friends GET /user/{user_tag}/playlists GET /user/{user_tag}/photos GET /user/{user_tag}/posts POST /user/{user_tag}/post

Relationships

GET /user/{user_tag}/relationships PATCH /user/{user_tag}/subscribe DELETE /incoming_requests/{user_id}

Dialogs (Messages)

GET /dialogs POST /dialogs POST /dialogs/private/{user_id} GET /dialogs/{dialog_id} GET /dialogs/{dialog_id}/messages GET /dialogs/messages/{message_id} DELETE /dialogs/messages/
{message_id}

Tracks (MuseBase)

GET /musebase/{track_id} GET /musebase/find/{mask} POST /musebase/upload GET /musebase/playlists/{playlist_id} GET /user/{user_tag}/playlists

Photos

GET /photos/{photo_id} POST /photos/upload DELETE /photos/{photo_id} GET /user/{user_tag}/photos

Posts

GET /posts/{post_id} DELETE /posts/{post_id} PATCH /posts/{post_id} PATCH /posts/{post_id}/like GET /posts/{post_id}/comments POST /posts/{post_id}/comment

Comments

GET /comments/{comment_id} DELETE /comments/{comment_id} PATCH /comments/{comment_id}/like

Safety

GET /safety/link

Other

GET /languages GET /countries GET /countries/{country_id}/regions GET /countries/{country_id}/regions/
{region_id}/cities

Yurba CDN (cdn.yurba.one)

GET /photos/{photo_id}.jpg GET /musebase/{track_id}.mp3

GET /musebase/playlists/{playlist_id}

Returns PlaylistModel.

Request URL params:

playlist_id: int

Request headers:

token: string

Response:

{
   ID: int,
   Name: string,
   Release: string,
   Description: string,
   Tracks: list[int],
   Author: ShortUserModel,
   Timestamp: int,
   Cover: int
}

More about ShortUserModel you can look here: /user/{user_id}

Example:

{
   ID: 68,
   Name: "alone... again",
   Release: "2022",
   Description: "",
   Tracks: [
      4971,
      4972,
      4973
      4974,
      4976
   ],
   Author: {
      ID: 1,
      Name: "Ілля",
      Surname: "Чернов",
      Link: "sample",
      Avatar: 715,
      Sub: 1,
      Verify: "Default",
      Ban: 0,
      Emoji: ":ua:",
      CosmeticAvatar: 0
   },
   Timestamp: 1695016301,
   Cover: 676
}

Errors:

auth_failed: token authorization failed

invalid_tracks: failed to read tracks json

Legacy

Legacy endpoint allows you to display a PlaylistLegacyModel that contains a TrackModel instead of a track ID.

GET /musebase/playlists/{playlist_id}/legacy

Returns PlaylistLegacyModel.

Request URL params:

playlist_id: int

Response:

{
   ID: int,
   Name: string,
   Release: string,
   Description: string,
   Tracks: list[TrackModel],
   Author: ShortUserModel,
   Timestamp: int,
   Cover: int
}

Example:

{
   ID: 68,
   Name: "alone... again",
   Release: "2022",
   Description: "",
   Tracks: [
        {
            ID: 4971,
            Name: "chamber of reflection",
            Author: "mac demarco",
            Mine: false,
            Release: "2014",
            Size: "9.29",
            Duration: 232,
            Timestamp: 1678665089,
            Cover: 538,
            Url: "https://cdn.yurba.one/musebase/4971.mp3"
        },
        {
            ID: 4972,
            Name: "No Suprises",
            Author: "Radiohead",
            Mine: false,
            Release: "1997",
            Size: "5.69",
            Duration: 229,
            Timestamp: 1678665151,
            Cover: 0,
            Url: "https://cdn.yurba.one/musebase/4972.mp3"
        },
        {
            ID: 4973,
            Name: "K",
            Author: "Cigarettes After Sex",
            Mine: false,
            Release: "2017",
            Size: "12.79",
            Duration: 320,
            Timestamp: 1678665297,
            Cover: 539,
            Url: "https://cdn.yurba.one/musebase/4973.mp3"
        },
        {
            ID: 4974,
            Name: "Space Song",
            Author: "Beach House",
            Mine: false,
            Release: "2015",
            Size: "12.84",
            Duration: 321,
            Timestamp: 1678665393,
            Cover: 540,
            Url: "https://cdn.yurba.one/musebase/4974.mp3"
        },
        {
            ID: 4976,
            Name: "welcome and goodbye ",
            Author: "dream, ivory",
            Mine: false,
            Release: "2018",
            Size: "3.33",
            Duration: 120,
            Timestamp: 1678668421,
            Cover: 542,
            Url: "https://cdn.yurba.one/musebase/4976.mp3"
        }
   ],
   Author: {
      ID: 1,
      Name: "Ілля",
      Surname: "Чернов",
      Link: "sample",
      Avatar: 715,
      Sub: 1,
      Verify: "Default",
      Ban: 0,
      Emoji: ":ua:",
      CosmeticAvatar: 0
   },
   Timestamp: 1695016301,
   Cover: 676
}