API V2
Aktionen
Bitte während der Wiedergabe eines Track folgenden Call im 30 Sekunden Abstand ausführen: https://api-v2.hearthis.at/track_ajax_count.phpDieser zählt bei uns die gespielte Nettozeit hoch.
GET parameter | value | description |
---|---|---|
action | string | accepted: time |
trackid | int | $TRACKID |
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 | 2021-02-24 | Start Date |
show-feed-end | str | 2021-03-03 | 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: [email protected]\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 |
---|---|---|---|
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