The hearthis.at account this server acts as: id, permalink, name, counts and Premium state.

Newest public tracks on hearthis.at, or the popular ones (optionally within one genre).

All genres with their ids and slugs. Includes "later" once the account saved something to Listen later.

Tracks of one genre, newest first.

One section of the hearthis.at home screen: stories (banners), latest_artists (featured artists), moods, newcomers (first upload in the last 7 days), genres_today (sounds per genre in the last 24 h), premium (plans and running promotion).

Search tracks, artists (users) or playlists by text.

Upcoming events (gigs, live shows), or one event with its id.

Tracks the account listened to recently.

The Listen later list of the account, newest first.

Metadata of one track: title, artist, genre, duration, counts, stream and artwork URLs.

More about one track: playlist (chapters / tracklist), transcript (AI transcript), related (similar tracks), reactions (emoji reactions) or comments.

Likes a track, or removes the like when it is already liked. The answer says the new state.

Reposts a track to the account's followers, or takes the repost back when it already exists.

Saves a track of someone else to Listen later (on=true), removes it (on=false), or toggles (on omitted).

A signed MP3 URL of a track for a cast receiver, valid 12 hours; fetching it counts as a play of this account.

Posts a public comment on a track, optionally at a position in seconds or as a reply to another comment.

Deletes a comment of the account (or any comment on an own track).

Posts an emoji reaction at a position of a track. Valid reaction ids are in get_track_part part=reactions.

Streaming quality of an own track. Without value: the current state. value=best queues the highest quality of the file type; a number queues that bitrate (999 = original MP3, 1000 = lossless). The change is transcoded in the background.

Copies the cover or background image of another own track onto this own track.

Uploads a local audio file (mp3, wav, flac, aac, m4a, ogg, aif/aiff, wma, opus) as a new track of the account, with optional metadata and cover. The track stays private unless private=false - publish only when the user asked for it. Only upload files the user named.

Changes settings of an own track - everything the edit page can change, by the same rules. Only the fields given change; options the account cannot use (plan, fan programme, transcript) keep their value. private=false publishes the track and notifies followers. answer.waiting=true: the title matched a copyright keyword and the sound waits for approval.

Deletes an own track. Ask the user for confirmation first.

Sets or replaces the cover of an own track from a local JPG or PNG (max 10 MB).

Removes the cover of an own track.

A profile, or one of its lists: tracks, likes, reposts, following, followers, playlists, connected, badges.

Follows a user, or unfollows when the account already follows them. User id from get_user.

Shows badges on the profile (badges_public) and the weekly mail about new badges (email_badges). Only the fields given change.

subscribed: the fan subscriptions the account pays. subscribers: the account's fans with statistics.

Sets (playlists) of the account.

All tracks of a set.

Adds a track to an existing set (set_id), or creates a new set with that name (new_set_name).

Changes a set of the account by the rules of its edit page - only the fields given change. Owner and moderators; privat only the owner.

Changes the profile of the account by the rules of its settings page - only the fields given change. Options of a plan the account does not have keep their value. E-mail, password, profile address, payouts, podcast and fan subscriptions change only on the website; the answer lists such fields under ignored.

Removes a track from a set of the account.

Deletes a set of the account (the tracks stay). Ask the user for confirmation first.

Groups of a genre, groups a user owns (user_groups) or groups a user joined (joined; default: this account).

A group: info (metadata and own permissions), tracks (paged), members (owner first).

Creates a group owned by the account.

Changes a group by the rules of its edit page - only the fields given change. Owner and editors; private only the owner. member_notify=true mails the members about every new sound - only switch it on when the user asked.

Joins a group (join=true) or leaves it (join=false). The owner cannot leave.

Adds a track to a group (add=true) or removes it (add=false). Owner, editors and the sound's author are published at once; others wait while the group asks for approval. Adding notifies the members and may mail the owner.

Owner only: makes a member an editor or a plain member, or blocks them (use group_block to lift a block).

Owner and editors: blocks a user from a group (they leave it and cannot join or add) or lifts the block.

Owner and editors: publishes a sound that waits for approval; the members are told about it.

Owner only: deletes a group. Ask the user for confirmation first.

Direct-message conversations of the account, most recent first, with unread counts.

Messages with one user, oldest first. Leaves them unread unless mark_read=true.

Incoming messages with an id above since (max 100). Without since only the current cursor comes back. Marks nothing as read.

Sends a direct message (max 2000 characters) to a user. Only send what the user asked to send.

Deletes a whole conversation for both sides. Ask the user for confirmation first.