API V2

Feed/Popular/New

get parameter value default description
page int 1 page to show
count int 5 entries per page (max: 20)
duration int duration (+/- 5 minutes)
type str [empty] / popular / new
category str [empty] / house / drumandbass / etc. - see genre API
show-feed-start str 2024-10-23 Start Date
show-feed-end str 2024-10-30 End Date

Example query: https://api-v2.hearthis.at/feed/?page=1&count=5

Example output:
[
  {
    "id": "48250",
    "created_at": "2014-07-06 13:05:10",
    "user_id": "7",
    "duration": "7376",
    "permalink": "shawne-back-to-the-roots-2-05072014",
    "description": "Years: 2000 - 2005\r\nSet Time: Warm Up (11 pm - 01 am)\r\n",
    "downloadable": "1",
    "genre": "Drum & Bass",
    "genre_slush": "drumandbass",
    "title": "Shawne @ Back To The Roots 2 (05.07.2014)",
    "uri": "https:\/\/api-v2.hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "permalink_url": "http:\/\/hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "artwork_url": "http:\/\/hearthis.at\/_\/cache\/images\/track\/500\/801982cafc20a06ccf6203f21f10c08d_w500.png",
    "background_url": "",
    "waveform_data": "http:\/\/hearthis.at\/_\/wave_data\/7\/3000_4382f398c454c47cf171aab674cf00f0.mp3.js",
    "waveform_url": "http:\/\/hearthis.at\/_\/wave_image\/7\/4382f398c454c47cf171aab674cf00f0.mp3.png",
    "user": {
      "id": "7",
      "permalink": "shawne",
      "username": "Shawne (hearthis.at)",
      "uri": "https:\/\/api-v2.hearthis.at\/shawne\/",
      "permalink_url": "http:\/\/hearthis.at\/shawne\/",
      "avatar_url": "http:\/\/hearthis.at\/_\/cache\/images\/user\/512\/06a8299b0e7d8f2909a22697badd7c09_w512.jpg"
    },
    "stream_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/listen\/",
    "download_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/download\/",
    "playback_count": "75",
    "download_count": "9",
    "favoritings_count": "7",
    "favorited": false,
    "comment_count": "0"
  }
]

All Genres

Example query: https://api-v2.hearthis.at/categories/

Example output:
[
  {
    "id": "acoustic",
    "name": "Acoustic",
    "url": "https:\/\/hearthis.at\/categories\/acoustic\/",
    "api_url": "https:\/\/api-v2.hearthis.at\/categories\/acoustic\/"
  }
]

Genre List

get parameter value default description
page int 1 page to show
count int 5 entries per page (max: 20)
duration int duration (+/- 5 minutes)

Example query: https://api-v2.hearthis.at/categories/drumandbass/?page=1&count=5

Example output:
[
  {
    "id": "48250",
    "created_at": "2014-07-06 13:05:10",
    "user_id": "7",
    "duration": "7376",
    "permalink": "shawne-back-to-the-roots-2-05072014",
    "description": "Years: 2000 - 2005\r\nSet Time: Warm Up (11 pm - 01 am)\r\n",
    "downloadable": "1",
    "genre": "Drum & Bass",
    "genre_slush": "drumandbass",
    "title": "Shawne @ Back To The Roots 2 (05.07.2014)",
    "uri": "https:\/\/api-v2.hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "permalink_url": "http:\/\/hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "artwork_url": "http:\/\/hearthis.at\/_\/cache\/images\/track\/500\/801982cafc20a06ccf6203f21f10c08d_w500.png",
    "background_url": "",
    "waveform_data": "http:\/\/hearthis.at\/_\/wave_data\/7\/3000_4382f398c454c47cf171aab674cf00f0.mp3.js",
    "waveform_url": "http:\/\/hearthis.at\/_\/wave_image\/7\/4382f398c454c47cf171aab674cf00f0.mp3.png",
    "user": {
      "id": "7",
      "permalink": "shawne",
      "username": "Shawne (hearthis.at)",
      "uri": "https:\/\/api-v2.hearthis.at\/shawne\/",
      "permalink_url": "http:\/\/hearthis.at\/shawne\/",
      "avatar_url": "http:\/\/hearthis.at\/_\/cache\/images\/user\/512\/06a8299b0e7d8f2909a22697badd7c09_w512.jpg"
    },
    "stream_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/listen\/",
    "download_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/download\/",
    "playback_count": "75",
    "download_count": "9",
    "favoritings_count": "7",
    "favorited": false,
    "comment_count": "0"
  }
]

Single Artist

Example query: https://api-v2.hearthis.at/shawne/

Example success output:
{
  "id": "366",
  "permalink": "tbase",
  "username": "T:Base",
  "uri": "https:\/\/api-v2.hearthis.at\/tbase\/",
  "permalink_url": "http:\/\/hearthis.at\/tbase\/",
  "avatar_url": "http:\/\/hearthis.at\/_\/cache\/images\/user\/512\/16c222232d29f7212114fdc107bf5701_w512.jpg",
  "background_url": "\/_\/cache\/images\/user\/600\/60852d6372a1f744fc4649c264357840_w600.jpg",
  "description": "DJ\/Producer from Chemnitz, Germany. \r\n\r\nBookings: level_c42@yahoo.com\r\n\r\naim: C Recordings\r\n\r\nLabels:\r\n\r\nC Recordings \/ Influenza \/ Soul Deep Recordings \/ Liquid Tones \/ Goo News Boppers\/ Diskool Records \/ All Street Recordings \/ Mu:sick Recordings.\r\n\r\n",
  "track_count": 10,
  "playlist_count": 2,
  "likes_count": 15,
  "followers_count": 31,
  "following": false
}

Aktion
Follow / Unfollow: https://api-v2.hearthis.at/user_ajax_function.php (POST) value description
action string accepted: follow
userid int $USERIDTOFOLLOW

Artist: Lists

get parameter value default description
type string choose list type: likes / playlists / tracks
page int 1 page to show
count int 5 entries per page (max: 20)

Example query: https://api-v2.hearthis.at/shawne/?type=likes&page=1&count=5

Example output:
[
  {
    "id": "48250",
    "created_at": "2014-07-06 13:05:10",
    "user_id": "7",
    "duration": "7376",
    "permalink": "shawne-back-to-the-roots-2-05072014",
    "description": "Years: 2000 - 2005\r\nSet Time: Warm Up (11 pm - 01 am)\r\n",
    "downloadable": "1",
    "genre": "Drum & Bass",
    "genre_slush": "drumandbass",
    "title": "Shawne @ Back To The Roots 2 (05.07.2014)",
    "uri": "https:\/\/api-v2.hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "permalink_url": "http:\/\/hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "artwork_url": "http:\/\/hearthis.at\/_\/cache\/images\/track\/500\/801982cafc20a06ccf6203f21f10c08d_w500.png",
    "background_url": "",
    "waveform_data": "http:\/\/hearthis.at\/_\/wave_data\/7\/3000_4382f398c454c47cf171aab674cf00f0.mp3.js",
    "waveform_url": "http:\/\/hearthis.at\/_\/wave_image\/7\/4382f398c454c47cf171aab674cf00f0.mp3.png",
    "user": {
      "id": "7",
      "permalink": "shawne",
      "username": "Shawne (hearthis.at)",
      "uri": "https:\/\/api-v2.hearthis.at\/shawne\/",
      "permalink_url": "http:\/\/hearthis.at\/shawne\/",
      "avatar_url": "http:\/\/hearthis.at\/_\/cache\/images\/user\/512\/06a8299b0e7d8f2909a22697badd7c09_w512.jpg"
    },
    "stream_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/listen\/",
    "download_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/download\/",
    "playback_count": "75",
    "download_count": "9",
    "favoritings_count": "7",
    "favorited": false,
    "comment_count": "0"
  }
]

Single Track

Example query: https://api-v2.hearthis.at/shawne/shawne-back-to-the-roots-2-05072014/

Example success output:
[
  {
    "id": "48250",
    "created_at": "2014-07-06 13:05:10",
    "user_id": "7",
    "duration": "7376",
    "permalink": "shawne-back-to-the-roots-2-05072014",
    "description": "Years: 2000 - 2005\r\nSet Time: Warm Up (11 pm - 01 am)\r\n",
    "downloadable": "1",
    "genre": "Drum & Bass",
    "genre_slush": "drumandbass",
    "title": "Shawne @ Back To The Roots 2 (05.07.2014)",
    "uri": "https:\/\/api-v2.hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "permalink_url": "http:\/\/hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "artwork_url": "http:\/\/hearthis.at\/_\/cache\/images\/track\/500\/801982cafc20a06ccf6203f21f10c08d_w500.png",
    "background_url": "",
    "waveform_data": "http:\/\/hearthis.at\/_\/wave_data\/7\/3000_4382f398c454c47cf171aab674cf00f0.mp3.js",
    "waveform_url": "http:\/\/hearthis.at\/_\/wave_image\/7\/4382f398c454c47cf171aab674cf00f0.mp3.png",
    "user": {
      "id": "7",
      "permalink": "shawne",
      "username": "Shawne (hearthis.at)",
      "uri": "https:\/\/api-v2.hearthis.at\/shawne\/",
      "permalink_url": "http:\/\/hearthis.at\/shawne\/",
      "avatar_url": "http:\/\/hearthis.at\/_\/cache\/images\/user\/512\/06a8299b0e7d8f2909a22697badd7c09_w512.jpg"
    },
    "stream_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/listen\/",
    "download_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/download\/",
    "playback_count": "75",
    "download_count": "9",
    "favoritings_count": "7",
    "favorited": false,
    "comment_count": "0"
  }
]

Aktion
Like / Unlike (als Grafik): https://api-v2.hearthis.at/trackimgcnt.php (GET) value description
action string accepted: likes
trackid int $TRACKID

Single Playlist

get parameter value default description
page int 1 page to show
count int 5 entries per page (max: 20)

Example query: https://api-v2.hearthis.at/shawne?type=playlists

Example success output:
[
  {
    "id": "438",
    "user_id": "7",
    "permalink": "438-7",
    "title": "Back In Time",
    "description": "",
    "privat": "0",
    "uri": "https:\/\/api-v2.hearthis.at\/set\/438-7\/",
    "permalink_url": "http:\/\/hearthis.at\/set\/438-7\/",
    "artwork_url": "",
    "track_count": 2,
    "user": {
      "id": "7",
      "permalink": "shawne",
      "username": "Shawne (hearthis.at)",
      "uri": "https:\/\/api-v2.hearthis.at\/shawne\/",
      "permalink_url": "http:\/\/hearthis.at\/shawne\/",
      "avatar_url": "http:\/\/hearthis.at\/_\/cache\/images\/user\/512\/06a8299b0e7d8f2909a22697badd7c09_w512.jpg"
    }
  }
]

Aktionen
Add Playlist: https://api-v2.hearthis.at/set_ajax_add.php (POST) value description
action string add
new_set string $PLAYLISTNAME
Add to EXISTING Playlist: https://api-v2.hearthis.at/set_ajax_add.php (POST) value description
action string add
track_id int $TRACKID
set int $PLAYLISTID
Add to NEW Playlist: https://api-v2.hearthis.at/set_ajax_add.php (POST) value description
action string add
track_id int $TRACKID
new_set string $PLAYLISTNAME
Delete from Playlist: https://api-v2.hearthis.at/set_ajax_edit.php (POST) value description
action string deleteentry
id int $TRACKID
set_id int $PLAYLISTID
Sort Playlist: https://api-v2.hearthis.at/set_ajax_edit.php (POST) value description
action string sort
track_light__move[] array $TRACKID
set_id int $PLAYLISTID
Delete Playlist: https://api-v2.hearthis.at/set_ajax_edit.php (POST) value description
action string delete
set int $PLAYLISTID

Example query: https://api-v2.hearthis.at/shawne/set/64-7/

Example success output:
[
  {
    "id": "48250",
    "created_at": "2014-07-06 13:05:10",
    "user_id": "7",
    "duration": "7376",
    "permalink": "shawne-back-to-the-roots-2-05072014",
    "description": "Years: 2000 - 2005\r\nSet Time: Warm Up (11 pm - 01 am)\r\n",
    "downloadable": "1",
    "genre": "Drum & Bass",
    "genre_slush": "drumandbass",
    "title": "Shawne @ Back To The Roots 2 (05.07.2014)",
    "uri": "https:\/\/api-v2.hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "permalink_url": "http:\/\/hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "artwork_url": "http:\/\/hearthis.at\/_\/cache\/images\/track\/500\/801982cafc20a06ccf6203f21f10c08d_w500.png",
    "background_url": "",
    "waveform_data": "http:\/\/hearthis.at\/_\/wave_data\/7\/3000_4382f398c454c47cf171aab674cf00f0.mp3.js",
    "waveform_url": "http:\/\/hearthis.at\/_\/wave_image\/7\/4382f398c454c47cf171aab674cf00f0.mp3.png",
    "user": {
      "id": "7",
      "permalink": "shawne",
      "username": "Shawne (hearthis.at)",
      "uri": "https:\/\/api-v2.hearthis.at\/shawne\/",
      "permalink_url": "http:\/\/hearthis.at\/shawne\/",
      "avatar_url": "http:\/\/hearthis.at\/_\/cache\/images\/user\/512\/06a8299b0e7d8f2909a22697badd7c09_w512.jpg"
    },
    "stream_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/listen\/",
    "download_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/download\/",
    "playback_count": "75",
    "download_count": "9",
    "favoritings_count": "7",
    "favorited": false,
    "comment_count": "0"
  }
]

Login

Limited to 5 tries/minute

post parameter value default description
email string email address to login
password string password address to login

Login url: https://api-v2.hearthis.at/login/

Facebook Login

GET parameter value default description
access_token string FB access token

Login url: https://api-v2.hearthis.at/login/

Logout

Login url: https://api-v2.hearthis.at/logout/

User Data [logged in]

Limited to 5 tries/minute

Example query: https://api-v2.hearthis.at/login/

New: You can use POST/GET "key" and "secret" values on each API endpoint to authenticate user to the API.

Example success output:
{
  "id": "7",
  "permalink": "shawne",
  "username": "Benedikt Gro\u00df",
  "uri": "https:\/\/api-v2.hearthis.at\/shawne\/",
  "permalink_url": "http:\/\/hearthis.at\/shawne\/",
  "avatar_url": "http:\/\/hearthis.at\/_\/cache\/images\/user\/512\/06a8299b0e7d8f2909a22697badd7c09_w512.jpg",
  "background_url": "\/_\/cache\/images\/user\/600\/7b01a96957b9fe0ceada0433aaadb357_w600.jpg",
  "description": "Shawne ist seit 2001 in der Drum & Bass Szene aktiv und feierte 2011, nach einer mehrj\u00e4hrigen Pause, seinen Wiedereinstieg als DJ im N*DORPHINCLUB Chemnitz. Sein Stil l\u00e4sst sich am Besten als eine Mischung zwischen Power Liquid und Jump Up beschreiben. Dabei entstehen neben treibenden Mashups auch Live-Remixe und neue Variationen bekannter Klassiker sowie neuer Produktionen. Um der Dynamik seines Stils gerecht zu werden spielt Shawne seine Sets auf 3 Plattenspielern oder 3 CD Playern gleichzeitig. \r\n\r\n2013 hat Shawne hearthis.at gegr\u00fcndet und entwickelt.\r\n\r\nShawne played alongside: Alex Reeve, Aphrodite, Audionaut, B Complex, Bootleg, Brazed, Bulldogs (Live), Cave, Cursive, Danny Byrd, Delta Heavy, Force, Extant, Freakk Red, Fru:tee, Jaycut, Jonny Kage, kiba, Kolt Siewerts, Lettuce, MaryJane42, Nano42, Neuroton, Ozma, Pats42, pull:180, Quest, Racoon, Repulse, Sick Noize, Sighter, Snipes, Squizz, Stereo, Trebor, Truempman, TSdnb, Veak, MC Shaolin42, MC Phowa, MC Mace, Ill Type MC, Dubwiser MC and many more\r\n\r\nShawne played at: Stadtfest Chemnitz, N*DORPHINCLUB (Chemnitz), Muna (Bad Klosterlausnitz), Substanz (Chemnitz), Wasserturm (Eisenberg), EXIT Club (Heiligenstadt), Stay Rebel Festival (Chemnitz), Fabrix (Werdau), S\u00e4chsischer Bahnhof (Gera), Reich & Sch\u00f6n Festival (Auterwitz), Kassablanca (Jena), S\u00fcdbahnhof (Chemnitz), Gotec Club (Karlsruhe), Caf\u00e9 Taktlos (Glauchau), Mocc Klub (Zwickau)",
  "track_count": 20,
  "playlist_count": 6,
  "likes_count": 412,
  "followers_count": 770,
  "following": false,
  "key": "KEY OF USER",
  "secret": "LOGIN SECRET OF USER"
}

Search

get parameter value default description
type string tracks (or empty) / user / playlists
t string search query
page int 1 page to show
count int 5 entries per page (max: 20)
duration int duration (+/- 5 minutes)

Example query: https://api-v2.hearthis.at/search?t=shawne&page=1&count=5

Example output:
[
  {
    "id": "48250",
    "created_at": "2014-07-06 13:05:10",
    "user_id": "7",
    "duration": "7376",
    "permalink": "shawne-back-to-the-roots-2-05072014",
    "description": "Years: 2000 - 2005\r\nSet Time: Warm Up (11 pm - 01 am)\r\n",
    "downloadable": "1",
    "genre": "Drum & Bass",
    "genre_slush": "drumandbass",
    "title": "Shawne @ Back To The Roots 2 (05.07.2014)",
    "uri": "https:\/\/api-v2.hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "permalink_url": "http:\/\/hearthis.at\/\/shawne-back-to-the-roots-2-05072014\/",
    "artwork_url": "http:\/\/hearthis.at\/_\/cache\/images\/track\/500\/801982cafc20a06ccf6203f21f10c08d_w500.png",
    "background_url": "",
    "waveform_data": "http:\/\/hearthis.at\/_\/wave_data\/7\/3000_4382f398c454c47cf171aab674cf00f0.mp3.js",
    "waveform_url": "http:\/\/hearthis.at\/_\/wave_image\/7\/4382f398c454c47cf171aab674cf00f0.mp3.png",
    "user": {
      "id": "7",
      "permalink": "shawne",
      "username": "Shawne (hearthis.at)",
      "uri": "https:\/\/api-v2.hearthis.at\/shawne\/",
      "permalink_url": "http:\/\/hearthis.at\/shawne\/",
      "avatar_url": "http:\/\/hearthis.at\/_\/cache\/images\/user\/512\/06a8299b0e7d8f2909a22697badd7c09_w512.jpg"
    },
    "stream_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/listen\/",
    "download_url": "http:\/\/hearthis.at\/shawne\/shawne-back-to-the-roots-2-05072014\/download\/",
    "playback_count": "75",
    "download_count": "9",
    "favoritings_count": "7",
    "favorited": false,
    "comment_count": "0"
  }
]

User History

GET parameter value default description
page int 1 page to show
count int 5 number of results

Login url: https://api-v2.hearthis.at/v2.2/htry/?page=1&count=5