JSON API (beta)

This JSON API is free for normal, non commercial use. You can get data with HTTP and HTTPS. For any questions please write an email to contact@hearthis.at
API is still in development and may change without warning


Newest Tracks (User-Feed [logged in])

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

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

Example output:
{
  "success": true,
  "timestamp": 1398162200,
  "tracks": [
    {
      "id": "34962",
      "stream": "http:\/\/htstream11.net\/d399e620e6d7694febb29b288b6d54ef.mp3",
      "wave_data": "http:\/\/hearthis.at\/_\/wave_data\/9761\/3000_d399e620e6d7694febb29b288b6d54ef.mp3.js",
      "img": "http:\/\/hearthis.at\/_\/cache\/images\/track\/500\/09ab8bd4740b99bd59ceb55533269df6_w500_h500_yp.jpg",
      "img_bg": "http:\/\/hearthis.atimage not found",
      "url": "http:\/\/hearthis.at\/6zghqxxt\/deep-deeper-goodzilla-vol12014\/",
      "api_url": "http:\/\/api.hearthis.at\/6zghqxxt\/deep-deeper-goodzilla-vol12014\/",
      "author": "9761",
      "author_name": "MARKUS - GOODZILLA",
      "author_url": "http:\/\/hearthis.at\/6zghqxxt\/",
      "api_author_url": "http:\/\/api.hearthis.at\/6zghqxxt\/",
      "name": "Deep deeper Goodzilla vol1:2014",
      "slush": "deep-deeper-goodzilla-vol12014",
      "description": "",
      "buy_link": "",
      "buy_link_title": "",
      "category": "house",
      "subcategories": "Deep house,Deep Vocal House,UK Deep House",
      "tags": "",
      "tags_artist": "",
      "length": "3878",
      "plays_count": "2",
      "likes_count": "0",
      "refeed_count": "0",
      "comment_count": "0",
      "download": "1",
      "download_url": "http:\/\/hearthis.at\/6zghqxxt\/deep-deeper-goodzilla-vol12014\/download\/",
      "download_count": "2",
      "highlight": "",
      "generated": "1",
      "privat": "0",
      "related": "1",
      "related_artists": "",
      "timestamp": "2014-04-22 11:20:21"
    }
  ]
}

Genre Index

Example query: http://api.hearthis.at/categories/

Example output:
{
  "success": true,
  "timestamp": 1398162845,
  "categories": [
    {
      "id": "acoustic",
      "name": "Acoustic",
      "url": "http:\/\/hearthis.at\/categories\/acoustic\/",
      "api_url": "http:\/\/api.hearthis.at\/categories\/acoustic\/"
    }
  ]
}

Genre Feed

get parameter value default description
genre string [see genre index "api_url"] genre to show
page int 1 page to show
count int 5 entries per page (max: 20)

Example query: http://api.hearthis.at/categories/house/?page=1&count=5

Example output:
{
  "success": true,
  "timestamp": 1398163132,
  "tracks": [
    {
      "id": "34962",
      "stream": "http:\/\/htstream11.net\/d399e620e6d7694febb29b288b6d54ef.mp3",
      "wave_data": "http:\/\/hearthis.at\/_\/wave_data\/9761\/3000_d399e620e6d7694febb29b288b6d54ef.mp3.js",
      "img": "http:\/\/hearthis.at\/_\/cache\/images\/track\/500\/09ab8bd4740b99bd59ceb55533269df6_w500_h500_yp.jpg",
      "img_bg": "http:\/\/hearthis.atimage not found",
      "url": "http:\/\/hearthis.at\/6zghqxxt\/deep-deeper-goodzilla-vol12014\/",
      "api_url": "http:\/\/api.hearthis.at\/6zghqxxt\/deep-deeper-goodzilla-vol12014\/",
      "author": "9761",
      "author_name": "MARKUS - GOODZILLA",
      "author_url": "http:\/\/hearthis.at\/6zghqxxt\/",
      "api_author_url": "http:\/\/api.hearthis.at\/6zghqxxt\/",
      "name": "Deep deeper Goodzilla vol1:2014",
      "slush": "deep-deeper-goodzilla-vol12014",
      "description": "",
      "buy_link": "",
      "buy_link_title": "",
      "category": "house",
      "subcategories": "Deep house,Deep Vocal House,UK Deep House",
      "tags": "",
      "tags_artist": "",
      "length": "3878",
      "plays_count": "2",
      "likes_count": "0",
      "refeed_count": "0",
      "comment_count": "0",
      "download": "1",
      "download_url": "http:\/\/hearthis.at\/6zghqxxt\/deep-deeper-goodzilla-vol12014\/download\/",
      "download_count": "2",
      "highlight": "",
      "generated": "1",
      "privat": "0",
      "related": "1",
      "related_artists": "",
      "timestamp": "2014-04-22 11:20:21"
    }
  ]
}

Login

Limited to 5 tries/minute

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

Example query: http://api.hearthis.at/login/

Example success output:
{
  "success": true,
  "message": "logged in",
  "timestamp": 1394747353,
  "data": {
    "id": "101",
    "img": "https:\/\/hearthis.at\/_\/cache\/images\/user\/512\/700ee9e3d6c1994fd7f37b6dc1ab580c_w512_h512_yp.jpg",
    "img_bg": "https:\/\/hearthis.at\/_\/uploads\/101\/image_user_bg\/28e5ccf440bc53be87c58da31c8ee36cueberschall.png",
    "url": "https:\/\/hearthis.at\/ueberschall\/",
    "api_url": "http:\/\/api.hearthis.at\/ueberschall\/",
    "name": null,
    "slush": "ueberschall",
    "description": "",
    "url_facebook": "https:\/\/www.facebook.com\/ueberschallblog",
    "url_twitter": "",
    "category": "drumandbass",
    "category2": "",
    "category3": "",
    "category4": "",
    "inside": "",
    "premium": "2",
    "beta": "0",
    "hidden": "0",
    "featured_track": "0",
    "template": "0"
  }
}

User Data [logged in]

Limited to 5 tries/minute

Example query: http://api.hearthis.at/login/

Example success output:
{
  "success": true,
  "timestamp": 1394747356,
  "data": {
    "id": "101",
    "img": "https:\/\/hearthis.at\/_\/cache\/images\/user\/512\/700ee9e3d6c1994fd7f37b6dc1ab580c_w512_h512_yp.jpg",
    "img_bg": "https:\/\/hearthis.at\/_\/uploads\/101\/image_user_bg\/28e5ccf440bc53be87c58da31c8ee36cueberschall.png",
    "url": "https:\/\/hearthis.at\/ueberschall\/",
    "api_url": "http:\/\/api.hearthis.at\/ueberschall\/",
    "name": null,
    "slush": "ueberschall",
    "description": "",
    "url_facebook": "https:\/\/www.facebook.com\/ueberschallblog",
    "url_twitter": "",
    "category": "drumandbass",
    "category2": "",
    "category3": "",
    "category4": "",
    "inside": "",
    "premium": "2",
    "beta": "0",
    "hidden": "0",
    "featured_track": "0",
    "template": "0",
    "sets": [
    ],
    "tracks": [
      {
        "id": "6580",
        "name": "UeberschallCast 7 - Veak",
        "slush": "ueberschallcast-7-veak",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-7-veak\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-7-veak\/"
      },
      {
        "id": "1215",
        "name": "UeberschallCast Mai\/Juni 2013 Apo",
        "slush": "ueberschallcast-maijuni-2013-apo",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-maijuni-2013-apo\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-maijuni-2013-apo\/"
      },
      {
        "id": "525",
        "name": "Ueberschall Cast April 2013 Quincee",
        "slush": "ueberschall-cast-april-2013-quincee",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschall-cast-april-2013-quincee\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschall-cast-april-2013-quincee\/"
      },
      {
        "id": "297",
        "name": "UeberschallCast Februar2013 Goldee",
        "slush": "ueberschallcast-februar2013-goldee",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-februar2013-goldee\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-februar2013-goldee\/"
      },
      {
        "id": "296",
        "name": "UeberschallCast Dezember2012\/Januar2013 Nadeltrauma & Real",
        "slush": "ueberschallcast-dezember2012januar2013-nadeltrauma-real",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-dezember2012januar2013-nadeltrauma-real\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-dezember2012januar2013-nadeltrauma-real\/"
      },
      {
        "id": "295",
        "name": "UeberschallCast November2012 Boxxfrogg",
        "slush": "ueberschallcast-november2012-boxxfrogg",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-november2012-boxxfrogg\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-november2012-boxxfrogg\/"
      },
      {
        "id": "294",
        "name": "UeberschallCast Oktober2012 Fraktion42",
        "slush": "ueberschallcast-oktober2012-fraktion42",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-oktober2012-fraktion42\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-oktober2012-fraktion42\/"
      }
    ],
    "follower": 0
  }
}

Single Artist

Example query: http://api.hearthis.at/mario.mauer/

Example success output:
{
  "success": true,
  "timestamp": 1394747356,
  "data": {
    "id": "101",
    "img": "https:\/\/hearthis.at\/_\/cache\/images\/user\/512\/700ee9e3d6c1994fd7f37b6dc1ab580c_w512_h512_yp.jpg",
    "img_bg": "https:\/\/hearthis.at\/_\/uploads\/101\/image_user_bg\/28e5ccf440bc53be87c58da31c8ee36cueberschall.png",
    "url": "https:\/\/hearthis.at\/ueberschall\/",
    "api_url": "http:\/\/api.hearthis.at\/ueberschall\/",
    "name": null,
    "slush": "ueberschall",
    "description": "",
    "url_facebook": "https:\/\/www.facebook.com\/ueberschallblog",
    "url_twitter": "",
    "category": "drumandbass",
    "category2": "",
    "category3": "",
    "category4": "",
    "inside": "",
    "premium": "2",
    "beta": "0",
    "hidden": "0",
    "featured_track": "0",
    "template": "0",
    "sets": [
    ],
    "tracks": [
      {
        "id": "6580",
        "name": "UeberschallCast 7 - Veak",
        "slush": "ueberschallcast-7-veak",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-7-veak\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-7-veak\/"
      },
      {
        "id": "1215",
        "name": "UeberschallCast Mai\/Juni 2013 Apo",
        "slush": "ueberschallcast-maijuni-2013-apo",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-maijuni-2013-apo\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-maijuni-2013-apo\/"
      },
      {
        "id": "525",
        "name": "Ueberschall Cast April 2013 Quincee",
        "slush": "ueberschall-cast-april-2013-quincee",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschall-cast-april-2013-quincee\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschall-cast-april-2013-quincee\/"
      },
      {
        "id": "297",
        "name": "UeberschallCast Februar2013 Goldee",
        "slush": "ueberschallcast-februar2013-goldee",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-februar2013-goldee\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-februar2013-goldee\/"
      },
      {
        "id": "296",
        "name": "UeberschallCast Dezember2012\/Januar2013 Nadeltrauma & Real",
        "slush": "ueberschallcast-dezember2012januar2013-nadeltrauma-real",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-dezember2012januar2013-nadeltrauma-real\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-dezember2012januar2013-nadeltrauma-real\/"
      },
      {
        "id": "295",
        "name": "UeberschallCast November2012 Boxxfrogg",
        "slush": "ueberschallcast-november2012-boxxfrogg",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-november2012-boxxfrogg\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-november2012-boxxfrogg\/"
      },
      {
        "id": "294",
        "name": "UeberschallCast Oktober2012 Fraktion42",
        "slush": "ueberschallcast-oktober2012-fraktion42",
        "url": "https:\/\/hearthis.at\/ueberschall\/ueberschallcast-oktober2012-fraktion42\/",
        "api_url": "http:\/\/api.hearthis.at\/ueberschall\/ueberschallcast-oktober2012-fraktion42\/"
      }
    ],
    "follower": 0
  }
}

Track Search

Limited to 5 tries/minute

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

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

Example output:
{
  "success": true,
  "timestamp": 1398164496,
  "data": [
    {
      "type": "track",
      "id": "32454",
      "stream": "http:\/\/lq1.hearthis.at\/6ceaa4a05967126c62553cda9fbaa0f6.mp3",
      "wave_data": "http:\/\/hearthis.at\/_\/wave_data\/7\/3000_6ceaa4a05967126c62553cda9fbaa0f6.mp3.js",
      "img": "http:\/\/hearthis.at\/_\/cache\/images\/track\/500\/4bca82faa3864058ffcd14f69ae5d7aa_w500_h500_yp.jpg",
      "img_bg": "http:\/\/hearthis.at\/_\/cache\/images\/track\/600\/9fa41d227fe2bf64028f13d460583ebc_w600_h600_yp.jpg",
      "url": "http:\/\/hearthis.at\/shawne\/shawne-porn-bass-15-05042014\/",
      "api_url": "http:\/\/api.hearthis.at\/shawne\/shawne-porn-bass-15-05042014\/",
      "author": "7",
      "author_name": "Shawne",
      "author_url": "http:\/\/hearthis.at\/shawne\/",
      "api_author_url": "http:\/\/api.hearthis.at\/\/",
      "name": "Shawne @\u00a0Porn & Bass 15 (05.04.2014)",
      "slush": "shawne-porn-bass-15-05042014",
      "description": "und gleichzeitig Demo f\u00fcr 2014. Gespielt auf 3-Decks. 45 Tracks in einer Stunde.",
      "buy_link": "",
      "buy_link_title": "",
      "category": "drumandbass",
      "subcategories": "Power Liquid,Jump Up,Liquid",
      "tags": "Porn & Bass,n*dorphinclub,Fraktion42,Shawne,Chemnitz,Drum & Bass,jump up,power liquid",
      "tags_artist": "Shawne",
      "length": "3723",
      "plays_count": "351",
      "likes_count": "4",
      "refeed_count": "4",
      "comment_count": "2",
      "download": "1",
      "download_url": "http:\/\/hearthis.at\/shawne\/shawne-porn-bass-15-05042014\/download\/",
      "download_count": "47",
      "highlight": "d81900",
      "generated": "1",
      "privat": "0",
      "related": "1",
      "related_artists": "Shawne",
      "timestamp": "2014-04-06 18:37:17"
    }
  ]
}