NAV
shell ruby python

Introduction

Welcome to the Fanburst API!

All API requests must be made over HTTPS. Requests made over plain HTTP will fail.

We reccomend you pass an Accept-Version header with all of your requests

curl -H "Accept-Version:v1" https://api.fanburst.com/users/52r8yj

Authentication


  Ruby Oauth example

  require 'oauth2'

  client_id     = 'YOUR_CLIENT_ID'
  client_secret = 'YOUR_CLIENT_SECRET'
  redirect_uri  = 'YOUR_REDIRECT_URI'
  site          = "https://fanburst.com"

  client = OAuth2::Client.new(client_id, client_secret, :site => site)

  if params[:code].blank?
    redirect_to client.auth_code.authorize_url(:redirect_uri => redirect_uri)
  else
    token = client.auth_code.get_token(params[:code], :redirect_uri => redirect_uri)
    @access_token = token.token
    @fanburst_user_id = oauth_token.params[:user_id]
    #SAVE THE ACCESS TOKEN AND USER ID TO YOUR DATABASE
  end

Fanburst uses Oauth2 to allow access to the API.

Fanburst expects the client ID to be included in all API requests. Authenticated requests must include a valid access token.

Pagination


  Pagination data is returned in the response headers:

  X-Total: 42
  X-Total-Pages: 5
  X-Page: 3
  X-Per-Page: 10
  X-Next-Page: 4
  X-Prev-Page: 2
  X-Offset: 10

All API endpoints that return multiple items support pagination.

By default we return the first 20 results. To request more results or the next page of results just append one of the parameters below:

HTTP Request

GET https://api.fanburst.com/users/52r8yj/tracks?page=2&per_page=3;

Pagination parameters

Parameter Required Description
page false your current page (default: 1)
per_page false how many to display in a page (default: 20)
offset false the offset to start from (default: 0)

Users

Get User

Example User response:

GET https://api.fanburst.com/users/j6lqq2
{ "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3", "followers_count" : 29, "followings_count" : 0, "track_count" : 13 }

Get a single user by user_id

HTTP Request

GET https://api.fanburst.com/users/<user_id>

Query Parameters

Parameter Required Description
user_id true The ID of the user you are requesting

Properties

Name Example Notes
id "j6lqq2" String
name "NoMBe" String
permalink "nombemusic" String
url "https://fanburst.com/nombemusic" String
avatar_url "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg" String
location "Los Angeles < 3" String
followers_count 29 Integer
followings_count 0 Integer
track_count 13 Integer

Get User's tracks

Example tracks response:

GET https://api.fanburst.com/users/52r8yj/tracks
[ { "id" : "6jdq56", "title" : "Can't Catch Me (feat. New Mystics)", "permalink" : "cant-catch-me-feat-new-mystics", "duration" : 202, "url" : "https://fanburst.com/nombemusic/cant-catch-me-feat-new-mystics", "published_at" : "2017-04-21T17:55:58.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/KVHX8inRMDjVFQUVlmXjafgHhJI=/500x500/cx2.fanburst.com/artwork/ac3cb06d-2b2f-4583-bd30-1ebfc7d713f4.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/o_5pO0e3oSmVyTgpZeCUDkcPzrk=/150x150/cx2.fanburst.com/artwork/ac3cb06d-2b2f-4583-bd30-1ebfc7d713f4.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/LYJSVAKBq8DkzGn86Lw1BbfcCH4=/250x250/cx2.fanburst.com/artwork/ac3cb06d-2b2f-4583-bd30-1ebfc7d713f4.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/KVHX8inRMDjVFQUVlmXjafgHhJI=/500x500/cx2.fanburst.com/artwork/ac3cb06d-2b2f-4583-bd30-1ebfc7d713f4.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/6jdq56/stream", "user" : { "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3" } }, { "id" : "m2yqzv", "title" : "Freak Like Me", "permalink" : "freak-like-me", "duration" : 176, "url" : "https://fanburst.com/nombemusic/freak-like-me", "published_at" : "2017-04-21T17:55:58.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/gMmoWsfN3BGUltwBENiQx8qzesA=/500x500/cx2.fanburst.com/artwork/cfd804f6-6cd2-4402-9929-350dc9e4bc59.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/ioT-0Md0QTkRmbejJXzRTTbSbo8=/150x150/cx2.fanburst.com/artwork/cfd804f6-6cd2-4402-9929-350dc9e4bc59.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/c7cK4Qo_FpjMN3nJMYzZmGpL4qo=/250x250/cx2.fanburst.com/artwork/cfd804f6-6cd2-4402-9929-350dc9e4bc59.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/gMmoWsfN3BGUltwBENiQx8qzesA=/500x500/cx2.fanburst.com/artwork/cfd804f6-6cd2-4402-9929-350dc9e4bc59.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/m2yqzv/stream", "user" : { "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3" } }, { "id" : "vze735", "title" : "Young Hearts", "permalink" : "young-hearts-2", "duration" : 218, "url" : "https://fanburst.com/nombemusic/young-hearts-2", "published_at" : "2017-04-21T17:55:58.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/SinwdFsSh1jgBKZaBS9AZKf17B0=/500x500/cx2.fanburst.com/artwork/0fc40496-917f-4b6f-842f-6b306189e665.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/h_6bthU2DoQctHeVdfhZvKYxsYw=/150x150/cx2.fanburst.com/artwork/0fc40496-917f-4b6f-842f-6b306189e665.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/lcT7olAmklNe04H9HupG1QDeeYU=/250x250/cx2.fanburst.com/artwork/0fc40496-917f-4b6f-842f-6b306189e665.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/SinwdFsSh1jgBKZaBS9AZKf17B0=/500x500/cx2.fanburst.com/artwork/0fc40496-917f-4b6f-842f-6b306189e665.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/vze735/stream", "user" : { "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3" } } ]

Get a users public tracks

HTTP Request

GET https://api.fanburst.com/users/<user_id>/tracks

Query Parameters

Parameter Required Description
user_id true The ID of the user you are requesting

Get User's favorite tracks

Example favorite tracks response:

GET https://api.fanburst.com/users/52r8yj/favorites
[ { "id" : "gv8yv5", "title" : "Make a Move", "permalink" : "make-a-move", "duration" : 176, "url" : "https://fanburst.com/sthumain/make-a-move", "published_at" : "2017-05-10T01:24:40.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/5ituIKr58Fgw7wkjvjrXMhH7BFE=/500x500/cx2.fanburst.com/artwork/2d93f486-83b1-43d9-b477-78ff769ec4fe.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/8JzEdxu4LlZwTk0paJPRBG8TpTk=/150x150/cx2.fanburst.com/artwork/2d93f486-83b1-43d9-b477-78ff769ec4fe.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/3BFmsHT7RZubW72sLDL9Y0vJl0s=/250x250/cx2.fanburst.com/artwork/2d93f486-83b1-43d9-b477-78ff769ec4fe.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/5ituIKr58Fgw7wkjvjrXMhH7BFE=/500x500/cx2.fanburst.com/artwork/2d93f486-83b1-43d9-b477-78ff769ec4fe.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/gv8yv5/stream", "user" : { "id" : "2vzpvn", "name" : "St. Humain", "permalink" : "sthumain", "url" : "https://fanburst.com/sthumain", "avatar_url" : "https://img-fanburst.freetls.fastly.net/oqwFXjhwywGoLoF_YK7vH3R-6UY=/500x500/cx2.fanburst.com/avatar/86b5a747-c799-459a-928b-9e431956f269.jpg", "location" : "Earth" } }, { "id" : "w3g3gz", "title" : "Chris Lake - Stranger", "permalink" : "chris-lake-stranger", "duration" : 233, "url" : "https://fanburst.com/thissongissick-com/chris-lake-stranger", "published_at" : "2016-11-22T17:54:16.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/HFLGXmSr-dq5KmnPuIeHGY78nOk=/500x500/cx2.fanburst.com/artwork/1cb6dec5-9df5-4cef-a0b2-1615732a0ba3.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/YNXd_LVpSViwKx01oqd_W_Cpx5A=/150x150/cx2.fanburst.com/artwork/1cb6dec5-9df5-4cef-a0b2-1615732a0ba3.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/qOyPnne79iWsh64orol7CbMZUL8=/250x250/cx2.fanburst.com/artwork/1cb6dec5-9df5-4cef-a0b2-1615732a0ba3.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/HFLGXmSr-dq5KmnPuIeHGY78nOk=/500x500/cx2.fanburst.com/artwork/1cb6dec5-9df5-4cef-a0b2-1615732a0ba3.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/w3g3gz/stream", "user" : { "id" : "61oeq2", "name" : "Thissongissick.com", "permalink" : "thissongissick-com", "url" : "https://fanburst.com/thissongissick-com", "avatar_url" : "https://img-fanburst.freetls.fastly.net/OK4PLKp2vKUPUwUT23mcf1ozpFY=/500x500/cx2.fanburst.com/avatar/e9fc3507-3639-4efa-88be-0d917e6e177c.png", "location" : "Boulder, CO " } }, { "id" : "w305rp", "title" : "LEAN QUATIFAH x Khia // Bustin", "permalink" : "lean-quatifah-x-khia-bustin", "duration" : 205, "url" : "https://fanburst.com/rooftops-horizon/lean-quatifah-x-khia-bustin", "published_at" : "2016-10-03T10:22:18.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/sup1cU4-Hv48wcgPjVHhbzmxnPQ=/500x500/cx2.fanburst.com/artwork/da749b11-20b6-4a8c-9475-d73a2138a67c.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/mwO4Q1adYURkzriUCpj2LLZH3L4=/150x150/cx2.fanburst.com/artwork/da749b11-20b6-4a8c-9475-d73a2138a67c.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/4Izhuk_I2GAWyAkC-yE0tBBHG80=/250x250/cx2.fanburst.com/artwork/da749b11-20b6-4a8c-9475-d73a2138a67c.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/sup1cU4-Hv48wcgPjVHhbzmxnPQ=/500x500/cx2.fanburst.com/artwork/da749b11-20b6-4a8c-9475-d73a2138a67c.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/w305rp/stream", "user" : { "id" : "6l5ko2", "name" : "ROOFTOPS HORIZON", "permalink" : "rooftops-horizon", "url" : "https://fanburst.com/rooftops-horizon", "avatar_url" : "https://img-fanburst.freetls.fastly.net/BWzkIFfqrXf9xfruc5htka3fwzs=/500x500/cx2.fanburst.com/avatar/18024348-a5be-4bfd-ad91-9baff61152c8.png", "location" : "Paris" } }, { "id" : "x81q3y", "title" : "jackLNDN & Fabich - Without You (jackLNDN Acoustic Cover)[SEE DESCRIPTION FOR FREE DOWNLOAD]", "permalink" : "jacklndn-fabich-without-you-jacklndn-acoustic-coversee-description-for-free-download", "duration" : 149, "url" : "https://fanburst.com/jacklndn/jacklndn-fabich-without-you-jacklndn-acoustic-coversee-description-for-free-download", "published_at" : "2017-01-20T14:57:33.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/HOkFvMlkbOxb_sPfWZnUqc9e3-w=/500x500/cx2.fanburst.com/artwork/0b207329-e060-45fb-9c18-6ae0dd731ad1.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/AlHFAQLJsrpA-xCNf7gPLNqAwhw=/150x150/cx2.fanburst.com/artwork/0b207329-e060-45fb-9c18-6ae0dd731ad1.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/N7uWeMk10cqlogRY8_192RniTiw=/250x250/cx2.fanburst.com/artwork/0b207329-e060-45fb-9c18-6ae0dd731ad1.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/HOkFvMlkbOxb_sPfWZnUqc9e3-w=/500x500/cx2.fanburst.com/artwork/0b207329-e060-45fb-9c18-6ae0dd731ad1.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/x81q3y/stream", "user" : { "id" : "ykwwm7", "name" : "JackLNDN", "permalink" : "jacklndn", "url" : "https://fanburst.com/jacklndn", "avatar_url" : "https://img-fanburst.freetls.fastly.net/4Di6Pe1fDID0udMZkRWXF_iuCII=/500x500/cx2.fanburst.com/avatar/f59ff90e-a696-4268-ad95-dd42be086158.jpg", "location" : "London" } } ]

Get a users favorite tracks

HTTP Request

GET https://api.fanburst.com/users/<user_id>/favorites

Query Parameters

Parameter Required Description
user_id true The ID of the user you are requesting

Search Users

Example search response:

GET https://api.fanburst.com/users/search?query=Vasta
{ "id" : "52r8yj", "name" : "Vasta", "permalink" : "vasta", "url" : "https://fanburst.com/vasta", "avatar_url" : "https://img-fanburst.freetls.fastly.net/IhzVejuAaMB8BhDIXFQiUrF39U0=/500x500/cx2.fanburst.com/avatar/92f072ef-8d06-49db-91d5-c29a9dcfe3d9.png", "location" : "East Side", "followers_count" : 37, "followings_count" : 49, "track_count" : 11 }

Search all users

HTTP Request

GET https://api.fanburst.com/users/search?query=YOUR_QUERY

Query Parameters

Parameter Required Description
query true Seach query

Tracks

Get Track

Example tracks response:

GET https://api.fanburst.com/tracks/jwy82x
{ "id" : "w57r29", "title" : "Seminole", "permalink" : "seminole", "duration" : 256, "url" : "https://fanburst.com/nombemusic/seminole", "published_at" : "2015-09-19T01:37:49.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/_9_C7572WkltYFxLg8LcjEzmsZM=/500x500/cx2.fanburst.com/artwork/cc8ec28b-36e9-4da8-a966-32cdae72bb22.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/hqKC2qTvZUUcjsp1q4vhPGBl8Ws=/150x150/cx2.fanburst.com/artwork/cc8ec28b-36e9-4da8-a966-32cdae72bb22.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/U68tm3ERRa1NS5nl8__-wUc93RA=/250x250/cx2.fanburst.com/artwork/cc8ec28b-36e9-4da8-a966-32cdae72bb22.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/_9_C7572WkltYFxLg8LcjEzmsZM=/500x500/cx2.fanburst.com/artwork/cc8ec28b-36e9-4da8-a966-32cdae72bb22.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/w57r29/stream", "user" : { "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3" } }

Get a single track

HTTP Request

GET https://api.fanburst.com/tracks/<TRACK_ID>

Query Parameters

Parameter Required Description
track_id true The ID of the track you are requesting

Create Track

Example tracks response:

POST https://api.fanburst.com/tracks?access_token=YOUR_ACCESS_TOKEN
{ "id" : "o9mo1x", "title" : "My song", "permalink" : "my-song", "duration" : 279, "url" : "https://fanburst.com/chris/my-song", "published_at" : "2015-12-02T12:56:00.719Z", "private" : true, "downloadable" : true, "stream_url" : "https://api.fanburst.com/tracks/o9mo1x/stream", "user" : { "id" : "q2g86w", "name" : "Chris Miller", "permalink" : "chris", "url" : "https://fanburst.com/chris", "location" : "Australia" } }

To create a new track just post an audio file and title. We support mp3, m4a, wav, flac and most other audio types. Max file size through the API is 750mb

HTTP Request

POST https://api.fanburst.com/tracks?access_token=YOUR_ACCESS_TOKEN

Query Parameters

Parameter Required Description
title true Track title
audio_file true Audio file
description false Track description
downloadable false Is this track downloadable?
private true Is this track private?

Stream Track

Example stream response:

GET https://api.fanburst.com/tracks/jwy82x/stream?client_id=YOUR_CLIENT_ID
Status:302 Found Location:https://dl-a-82.fanburst.com/?f=7389f62b-f186-4289-9f27-55110e80df85.mp3&m=mp3&df=7389f62b-f186-4289-9f27-55110e80df85.mp3&e=1462280072&s=ba7cb40d3742c13d769c451d35d9183c948f2296

Redirects the user to a signed stream URL. Signed URLs generally expire after 60 minutes, to prevent playback issues we recommend requesting a new signed URL each time the user initiates a stream.

HTTP Request

GET https://api.fanburst.com/tracks/<TRACK_ID>/stream

Query Parameters

Parameter Required Description
track_id true The ID of the track you are requesting

Example trending tracks response:

GET https://api.fanburst.com/tracks/trending
[ { "id" : "8n36kl", "title" : "Rose Bonica - Stoicism", "permalink" : "rose-bonica-stoicism", "duration" : 330, "url" : "https://fanburst.com/rose-bonica/rose-bonica-stoicism", "published_at" : "2017-06-01T22:28:14.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/Im16rmOS_NsN2s54Unb8rHhvaAY=/500x500/cx2.fanburst.com/artwork/8c8b748e-4fef-47c9-b83d-478f85dcd8f8.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/b-gDpL6Kr3DVuCvbX4xgzOQ8GMs=/150x150/cx2.fanburst.com/artwork/8c8b748e-4fef-47c9-b83d-478f85dcd8f8.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/XpLduV9JuHfTWADMG-6g7Ww_Wiw=/250x250/cx2.fanburst.com/artwork/8c8b748e-4fef-47c9-b83d-478f85dcd8f8.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/Im16rmOS_NsN2s54Unb8rHhvaAY=/500x500/cx2.fanburst.com/artwork/8c8b748e-4fef-47c9-b83d-478f85dcd8f8.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/8n36kl/stream", "user" : { "id" : "ykw1o7", "name" : "Rose Bonica", "permalink" : "rose-bonica", "url" : "https://fanburst.com/rose-bonica", "avatar_url" : "https://img-fanburst.freetls.fastly.net/rLHRmb12tPae7gSTlGgzeuiUb4s=/500x500/cx2.fanburst.com/avatar/3e99d5c9-e250-4a96-95b6-d6aeb0c01957.jpg", "location" : "Cape Town, South Africa" } }, { "id" : "xgrz42", "title" : "Home", "permalink" : "home", "duration" : 170, "url" : "https://fanburst.com/jupiterdeluxetube/home", "published_at" : "2017-01-12T18:23:37.000Z", "private" : false, "downloadable" : true, "image_url" : "https://img-fanburst.freetls.fastly.net/TOII-ssnJDueGjYiKGAxLW1MU4Q=/500x500/cx2.fanburst.com/artwork/d43e4cc1-813b-4c13-bac3-5bce7b34670b.PNG", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/lsxtjUQrwl1xf7e6tJczZqZpB24=/150x150/cx2.fanburst.com/artwork/d43e4cc1-813b-4c13-bac3-5bce7b34670b.PNG", "square_250" : "https://img-fanburst.freetls.fastly.net/Pho5nCRECL0WJ0CYEv1eBi3tKvA=/250x250/cx2.fanburst.com/artwork/d43e4cc1-813b-4c13-bac3-5bce7b34670b.PNG", "square_500" : "https://img-fanburst.freetls.fastly.net/TOII-ssnJDueGjYiKGAxLW1MU4Q=/500x500/cx2.fanburst.com/artwork/d43e4cc1-813b-4c13-bac3-5bce7b34670b.PNG" }, "stream_url" : "https://api.fanburst.com/tracks/xgrz42/stream", "user" : { "id" : "68kwk6", "name" : "Jupiter Deluxe Tube", "permalink" : "jupiterdeluxetube", "url" : "https://fanburst.com/jupiterdeluxetube", "avatar_url" : "https://img-fanburst.freetls.fastly.net/TGQgXroMDf4vuUS3VQBK65l7_sY=/500x500/cx2.fanburst.com/avatar/059bd136-03d4-4e24-a0f0-2a6fba3e790e.jpg", "location" : "Orange County, CA" } }, { "id" : "2r1lpr", "title" : "Middle Child - Bliss", "permalink" : "middle-child-bliss", "duration" : 148, "url" : "https://fanburst.com/middlechild/middle-child-bliss", "published_at" : "2017-06-04T22:34:17.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/fFhFcNLmLxHEz4DkwND_IVSDNT4=/500x500/cx2.fanburst.com/artwork/f47b4bf6-1495-428d-860e-2231e1b70bdb.png", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/3Nd2N22Wt_Lxn_xAbGtDomF_csM=/150x150/cx2.fanburst.com/artwork/f47b4bf6-1495-428d-860e-2231e1b70bdb.png", "square_250" : "https://img-fanburst.freetls.fastly.net/rsZITNlUd-vh86My1KkHorcDXMo=/250x250/cx2.fanburst.com/artwork/f47b4bf6-1495-428d-860e-2231e1b70bdb.png", "square_500" : "https://img-fanburst.freetls.fastly.net/fFhFcNLmLxHEz4DkwND_IVSDNT4=/500x500/cx2.fanburst.com/artwork/f47b4bf6-1495-428d-860e-2231e1b70bdb.png" }, "stream_url" : "https://api.fanburst.com/tracks/2r1lpr/stream", "user" : { "id" : "2gm982", "name" : "Middle Child", "permalink" : "middlechild", "url" : "https://fanburst.com/middlechild", "avatar_url" : "https://img-fanburst.freetls.fastly.net/55RzXFIaUfx_efF9nwdEAykFrfM=/500x500/cx2.fanburst.com/avatar/3f12671e-4824-44b9-a402-3a39a6a75117.jpg", "location" : "Minneapolis" } } ]

Returns the top 100 tracks on Fanburst. This endpoint does not currently support pagination and returns all 100 tracks. Pagination will be available soon.

HTTP Request

GET https://api.fanburst.com/tracks/trending

Search Tracks

Example search response:

GET https://api.fanburst.com/tracks/search?query=Nombe
[ { "id" : "xgvk5x", "title" : "Vowels", "permalink" : "vowels", "duration" : 212, "url" : "https://fanburst.com/nombemusic/vowels", "published_at" : "2015-09-19T01:37:49.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/9R8gcbbRxan33iiRLOkJgr-kMSM=/500x500/cx2.fanburst.com/artwork/c45b8225-7a6d-4156-86d0-7ff0a43c9f64.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/E4oLDfIUcxA--5Jzbc4qLfanCYM=/150x150/cx2.fanburst.com/artwork/c45b8225-7a6d-4156-86d0-7ff0a43c9f64.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/JykYVsQ4bx0EIiSNtR9jNHzo1P8=/250x250/cx2.fanburst.com/artwork/c45b8225-7a6d-4156-86d0-7ff0a43c9f64.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/9R8gcbbRxan33iiRLOkJgr-kMSM=/500x500/cx2.fanburst.com/artwork/c45b8225-7a6d-4156-86d0-7ff0a43c9f64.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/xgvk5x/stream", "user" : { "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3" } }, { "id" : "w33jrw", "title" : "AtoZ (feat. Durqa)", "permalink" : "atoz-feat-durqa", "duration" : 236, "url" : "https://fanburst.com/nombemusic/atoz-feat-durqa", "published_at" : "2015-09-19T01:37:49.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/6Mzo9GD490Zg-Bfg9fMwgSKpVos=/500x500/cx2.fanburst.com/artwork/9339b481-c292-4f63-952c-0ddd769f5786.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/bGvfxdUu_dej5QCXoDZakt_YS4k=/150x150/cx2.fanburst.com/artwork/9339b481-c292-4f63-952c-0ddd769f5786.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/1GrYYNwft7eV7D6q1Tik17SxxFM=/250x250/cx2.fanburst.com/artwork/9339b481-c292-4f63-952c-0ddd769f5786.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/6Mzo9GD490Zg-Bfg9fMwgSKpVos=/500x500/cx2.fanburst.com/artwork/9339b481-c292-4f63-952c-0ddd769f5786.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/w33jrw/stream", "user" : { "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3" } }, { "id" : "wy520x", "title" : "Change Of Hearts (feat. Winslow Bright)", "permalink" : "change-of-hearts-feat-winslow-bright", "duration" : 260, "url" : "https://fanburst.com/nombemusic/change-of-hearts-feat-winslow-bright", "published_at" : "2015-09-19T01:37:49.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/N2KNx01ZtuZhf_0escBpGIttZ_M=/500x500/cx2.fanburst.com/artwork/609e7469-83a1-43e7-b5da-95949e8513df.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/y968joJjO3mbeBzoZKV2v-gmbPQ=/150x150/cx2.fanburst.com/artwork/609e7469-83a1-43e7-b5da-95949e8513df.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/VYGvMGpPS8GDY_TluLH6KziDtCg=/250x250/cx2.fanburst.com/artwork/609e7469-83a1-43e7-b5da-95949e8513df.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/N2KNx01ZtuZhf_0escBpGIttZ_M=/500x500/cx2.fanburst.com/artwork/609e7469-83a1-43e7-b5da-95949e8513df.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/wy520x/stream", "user" : { "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3" } }, { "id" : "wdvk0w", "title" : "Waves", "permalink" : "waves", "duration" : 191, "url" : "https://fanburst.com/nombemusic/waves", "published_at" : "2015-09-19T01:37:49.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/R6IA2mKWRfRtzdUNWPvNPEhPVYM=/500x500/cx2.fanburst.com/artwork/00221657-20d9-48f6-af7a-3d3b9db2e7a4.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/A50F5OJijkmEMTQ9TP_W_A53BTI=/150x150/cx2.fanburst.com/artwork/00221657-20d9-48f6-af7a-3d3b9db2e7a4.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/98MH2ZHeIp7bYgPHgxQTFed1TE0=/250x250/cx2.fanburst.com/artwork/00221657-20d9-48f6-af7a-3d3b9db2e7a4.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/R6IA2mKWRfRtzdUNWPvNPEhPVYM=/500x500/cx2.fanburst.com/artwork/00221657-20d9-48f6-af7a-3d3b9db2e7a4.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/wdvk0w/stream", "user" : { "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3" } }, { "id" : "571gjr", "title" : "NoMBe VS Sonny Alven - California Girls", "permalink" : "nombe-vs-sonny-alven-california-girls", "duration" : 185, "url" : "https://fanburst.com/nombemusic/nombe-vs-sonny-alven-california-girls", "published_at" : "2017-04-21T17:55:58.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/2uXVnLp2OeDOangCv0pynvJYcq8=/500x500/cx2.fanburst.com/artwork/25690642-73bc-47bb-bd22-8e690069d11e.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/W4lG4MSUw0Wm6OsWhrik_XJpkKk=/150x150/cx2.fanburst.com/artwork/25690642-73bc-47bb-bd22-8e690069d11e.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/9GxuMW9yBhFhTJgISIU6CRXRQDk=/250x250/cx2.fanburst.com/artwork/25690642-73bc-47bb-bd22-8e690069d11e.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/2uXVnLp2OeDOangCv0pynvJYcq8=/500x500/cx2.fanburst.com/artwork/25690642-73bc-47bb-bd22-8e690069d11e.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/571gjr/stream", "user" : { "id" : "j6lqq2", "name" : "NoMBe", "permalink" : "nombemusic", "url" : "https://fanburst.com/nombemusic", "avatar_url" : "https://img-fanburst.freetls.fastly.net/jII5Qe-Hrx-bPYeiaIBSwEygBaI=/500x500/cx2.fanburst.com/avatar/6243a726-91bd-474f-87a8-85cd23e14cc6.jpg", "location" : "Los Angeles <3" } } ]

Search all public tracks

HTTP Request

GET https://api.fanburst.com/tracks/search?query=YOUR_QUERY

Query Parameters

Parameter Required Description
query true Seach query

Playlists

Get Playlist

Example playlist response:

GET https://api.fanburst.com/playlists/6570vg
{ "id" : "6570vg", "title" : "Hero or Bust", "image_url" : "https://img-fanburst.freetls.fastly.net/edNOvWonf34GSnO4BA0xP1ojj8g=/500x500/cx2.fanburst.com/artwork/8a6032ef-0756-4428-b8e3-b398827e7cea.jpg", "tracks_count" : 27, "permalink" : "hero-or-bust", "url" : "https://fanburst.com/herobust/playlist/hero-or-bust", "published_at" : "2017-02-07T22:01:37.000Z", "user" : { "id" : "2p9k5y", "name" : "Herobust", "permalink" : "herobust", "url" : "https://fanburst.com/herobust", "avatar_url" : "https://img-fanburst.freetls.fastly.net/JJqO1tVzUXxB0ZrdsiJY3eOUXL4=/500x500/cx2.fanburst.com/avatar/4569ff59-5de9-4d73-a4f3-58b1efaab2c0.jpg", "location" : "USA" } }

Get a single playlist

HTTP Request

GET https://api.fanburst.com/playlists/<PLAYLIST_ID>

Query Parameters

Parameter Required Description
playlist_id true The ID of the playlist you are requesting

Get Playlist Tracks

Example playlist tracks response:

GET https://api.fanburst.com/playlists/6570vg/tracks
[ { "id" : "wjm4m3", "title" : "Skurt Reynolds (VIP)", "permalink" : "skurt-reynolds-vip", "duration" : 185, "url" : "https://fanburst.com/herobust/skurt-reynolds-vip", "published_at" : "2017-02-01T19:26:46.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/edNOvWonf34GSnO4BA0xP1ojj8g=/500x500/cx2.fanburst.com/artwork/8a6032ef-0756-4428-b8e3-b398827e7cea.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/3JQmZylzKzLLVVgSGh_7P3DWcGs=/150x150/cx2.fanburst.com/artwork/8a6032ef-0756-4428-b8e3-b398827e7cea.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/72Rvrk0nm15sfbYGuebQapceg7k=/250x250/cx2.fanburst.com/artwork/8a6032ef-0756-4428-b8e3-b398827e7cea.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/edNOvWonf34GSnO4BA0xP1ojj8g=/500x500/cx2.fanburst.com/artwork/8a6032ef-0756-4428-b8e3-b398827e7cea.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/wjm4m3/stream", "user" : { "id" : "2p9k5y", "name" : "Herobust", "permalink" : "herobust", "url" : "https://fanburst.com/herobust", "avatar_url" : "https://img-fanburst.freetls.fastly.net/JJqO1tVzUXxB0ZrdsiJY3eOUXL4=/500x500/cx2.fanburst.com/avatar/4569ff59-5de9-4d73-a4f3-58b1efaab2c0.jpg", "location" : "USA" } }, { "id" : "xp6g6z", "title" : "D.R.A.M. - Broccoli ft. Lil Yachty (BUSTED by Herobust)", "permalink" : "dram-broccoli-ft-lil-yachty-busted-by-herobust", "duration" : 275, "url" : "https://fanburst.com/herobust/dram-broccoli-ft-lil-yachty-busted-by-herobust", "published_at" : "2017-02-01T19:26:46.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/zdPI0djUEShcWw8XocpQlSU-JxM=/500x500/cx2.fanburst.com/artwork/51f41f0f-d499-4368-aaf7-97fd032f3d2c.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/gtcA5ua_QVDmUFdAlCRBN8xLip4=/150x150/cx2.fanburst.com/artwork/51f41f0f-d499-4368-aaf7-97fd032f3d2c.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/xK4OJ8VSV8BNZZE9Tx26t4tFBaQ=/250x250/cx2.fanburst.com/artwork/51f41f0f-d499-4368-aaf7-97fd032f3d2c.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/zdPI0djUEShcWw8XocpQlSU-JxM=/500x500/cx2.fanburst.com/artwork/51f41f0f-d499-4368-aaf7-97fd032f3d2c.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/xp6g6z/stream", "user" : { "id" : "2p9k5y", "name" : "Herobust", "permalink" : "herobust", "url" : "https://fanburst.com/herobust", "avatar_url" : "https://img-fanburst.freetls.fastly.net/JJqO1tVzUXxB0ZrdsiJY3eOUXL4=/500x500/cx2.fanburst.com/avatar/4569ff59-5de9-4d73-a4f3-58b1efaab2c0.jpg", "location" : "USA" } }, { "id" : "96r0r2", "title" : "Vertebreaker", "permalink" : "vertebreaker", "duration" : 235, "url" : "https://fanburst.com/herobust/vertebreaker", "published_at" : "2017-02-01T19:26:46.000Z", "private" : false, "downloadable" : false, "image_url" : "https://img-fanburst.freetls.fastly.net/mEth-HeXst8vuOpe-QsJXeiSHxY=/500x500/cx2.fanburst.com/artwork/ce5c3f90-22a5-4c00-920f-ced0f8e60a27.jpg", "images" : { "square_150" : "https://img-fanburst.freetls.fastly.net/MmgmCiCs9N1hvhRX7xcdsfmpD7k=/150x150/cx2.fanburst.com/artwork/ce5c3f90-22a5-4c00-920f-ced0f8e60a27.jpg", "square_250" : "https://img-fanburst.freetls.fastly.net/eyqBxWD56vINI-K0_ebgANcqwkQ=/250x250/cx2.fanburst.com/artwork/ce5c3f90-22a5-4c00-920f-ced0f8e60a27.jpg", "square_500" : "https://img-fanburst.freetls.fastly.net/mEth-HeXst8vuOpe-QsJXeiSHxY=/500x500/cx2.fanburst.com/artwork/ce5c3f90-22a5-4c00-920f-ced0f8e60a27.jpg" }, "stream_url" : "https://api.fanburst.com/tracks/96r0r2/stream", "user" : { "id" : "2p9k5y", "name" : "Herobust", "permalink" : "herobust", "url" : "https://fanburst.com/herobust", "avatar_url" : "https://img-fanburst.freetls.fastly.net/JJqO1tVzUXxB0ZrdsiJY3eOUXL4=/500x500/cx2.fanburst.com/avatar/4569ff59-5de9-4d73-a4f3-58b1efaab2c0.jpg", "location" : "USA" } } ]

Get a playlist's tracks

HTTP Request

GET https://api.fanburst.com/playlists/<PLAYLIST_ID>/tracks

Query Parameters

Parameter Required Description
playlist_id true The ID of the playlist you are requesting

Example trending tracks response:

GET https://api.fanburst.com/playlists/trending
[ { "id" : "gw6735", "title" : "Plugged In: Hip Hop", "image_url" : "https://img-fanburst.freetls.fastly.net/H2g3rZuOeOX9dca7Ppf0CsGYEy8=/500x500/cx2.fanburst.com/artwork/220b7e14-f2cd-4fc1-8ae8-5803672997ab.jpg", "tracks_count" : 37, "permalink" : "plugged-in", "url" : "https://fanburst.com/theplugsociety/playlist/plugged-in", "published_at" : "2017-05-26T19:17:37.000Z", "user" : { "id" : "2zo1d5", "name" : "The Plug Society", "permalink" : "theplugsociety", "url" : "https://fanburst.com/theplugsociety", "avatar_url" : "https://img-fanburst.freetls.fastly.net/dwNleXE8XGABSgmtWS3PL72Pppw=/500x500/cx2.fanburst.com/avatar/3cb0c8d5-be60-4d16-a592-682d85f3db74.png", "location" : "Philadelphia - LA" } }, { "id" : "521vzg", "title" : "Peanut Butter & Good Jams", "image_url" : "https://img-fanburst.freetls.fastly.net/y1wu7LG9VzwLyNoM2VMp1CBOEAY=/500x500/cx2.fanburst.com/artwork/6f4cbb46-2c73-4dac-9dc3-806fc730bca9.png", "tracks_count" : 73, "permalink" : "peanut-butter-good-jams", "url" : "https://fanburst.com/lauff/playlist/peanut-butter-good-jams", "published_at" : "2017-03-31T14:54:21.000Z", "user" : { "id" : "2qn1g4", "name" : "Lauff", "permalink" : "lauff", "url" : "https://fanburst.com/lauff", "avatar_url" : "https://img-fanburst.freetls.fastly.net/0n8WfXZfv4TzUpegUMuc-PzmCAc=/500x500/cx2.fanburst.com/avatar/73d59546-5479-4307-a374-635685cbdc10.png", "location" : "Boston" } } ]

Returns the top playlists on Fanburst. This endpoint does not currently support pagination. Pagination will be available soon.

HTTP Request

GET https://api.fanburst.com/playlists/trending

Me

Current user

Example User response:

GET https://api.fanburst.com/me
{ "id" : "52r8yj", "name" : "Vasta", "permalink" : "vasta", "url" : "https://fanburst.com/vasta", "avatar_url" : "https://img-fanburst.freetls.fastly.net/IhzVejuAaMB8BhDIXFQiUrF39U0=/500x500/cx2.fanburst.com/avatar/92f072ef-8d06-49db-91d5-c29a9dcfe3d9.png", "location" : "East Side", "followers_count" : 37, "followings_count" : 49, "track_count" : 11 }

Get currently authenticated user

HTTP Request

GET https://api.fanburst.com/me?access_token=12345

Properties

Name Example Notes
id "52r8yj" String
name "Vasta" String
permalink "vasta" String
url "https://fanburst.com/vasta" String
avatar_url "https://img-fanburst.freetls.fastly.net/IhzVejuAaMB8BhDIXFQiUrF39U0=/500x500/cx2.fanburst.com/avatar/92f072ef-8d06-49db-91d5-c29a9dcfe3d9.png" String
location "East Side" String
followers_count 37 Integer
followings_count 49 Integer
track_count 11 Integer

Resources

All resources available under the user endpoint (tracks,albums,favorites etc) are also available under the /me endpoint

Follow user

Example response:

POST https://api.fanburst.com/me/following
STATUS 200

Follow a user from currently authenticated account

HTTP Request

POST https://api.fanburst.com/me/following?access_token=12345

Properties

Name Example Notes
user_id "52r8yj" String

Follow check

Example response:

POST https://api.fanburst.com/me/following/contains
{ "user_id" : "52r8yj", "follower_id" : "9yjoe6", "status" : "true" }

Check to see if the currently authenticated user follows another user

HTTP Request

POST https://api.fanburst.com/me/following/contains?access_token=12345

Properties

Name Example Notes
follower_id "9yjoe6" String

Resolve

Resolve content from URL

Example Resolve response:

GET https://api.fanburst.com/resolve?url=https://fanburst.com/vasta/they-back-it-up-vasta-infuze-remix
{ "content_type" : "track", "content_id" : "xkg82o", "api_url" : "https://api.fanburst.com/tracks/xkg82o" }

Resolve allows you to find the content type (track, user, album) and content id from a Fanburst URL. This method does't yet support private tracks or albums.

HTTP Request

GET https://api.fanburst.com/resolve?url=https://fanburst.com/vasta/they-back-it-up-vasta-infuze-remix

Properties

Name Example Notes
content_type "track" String
content_id "xkg82o" String
api_url "https://api.fanburst.com/tracks/xkg82o" String

Errors

The Fanburst API uses the following error codes:

Error Code Meaning
400 Bad Request -- The request was unacceptable, often due to missing a required parameter.
401 Unauthorized -- No valid API client ID provided.
404 Not Found -- The requested item doesn't exist.
429 Too Many Requests -- Too many requests hit the API too quickly.
500, 503 Internal Server Error -- Something went wrong on our end