ArtistServer.com API

  1. Overview
    1. Overview
    2. Apply for a Key
    3. Available APIs
    4. Terms and Conditions
  2. RSS Feeds
  3. Site Widgets

API Documentation

  1. Overview
    1. Overview
    2. Apply for a Key - in order to manage our API, keep track of how it's being used, and communicate with those using it, we've selected to use our site's own account ID as your API key. Simply join the site, and you'll have your key generated automatically.
    3. Available APIs - The first stage of our API was our RSS feeds, which provided access to most of the data on our site. The second stage, is the release of our Artist Widgets, a collection of objects people can include on their sites which will offer songs, rigntones, or photos. And at a later date, our API will include a REST interface for interacting with an even greater range of functions and data.
    4. Terms and Conditions The ArtistServer.com API and RSS feeds are provided free of charge for use by individuals and non-competing organizations for personal use in a content reader or as part of a non-commercial Website or blog. ArtistServer.com requires proper format and attribution whenever ArtistServer.com content is posted on your Website. You may not alter links, nor alter or remove the ArtistServer.com name, logo, or URL from the generated content from our API and/or RSS feeds. If you have special needs, or you do run a commercial site/service and wish to republish portions of site please contact us before you plan your integration. ArtistServer.com reserves the right to require you to cease use and distribution of our API and feeds at any time for any reason.
  2. RSS Feeds
    1. Overview - Unfortunately, our RSS feeds started off with a less that ideal URL structure, with no universal point for requesting, nor readable variables in the URL. Ad new feeds are added, we will adhere to a more consistent structure. Our feeds are served as RSS 1.0.
    2. Request Formats
      1. New News: This feed delivers the 15 most recent News Releases, Articles, Documents, etc posted on our site.
        http://www.artistserver.com/webservices/news_rss.cfm
      2. New Reviews: This feed delivers the 15 most recent song reviews posted on our site.
        http://www.artistserver.com/webservices/reviews_rss.cfm
      3. New Songs: This feed delivers the 15 most recent songs posted on our site. Note: this is NOT a podcast.
        http://www.artistserver.com/webservices/songs_rss.cfm
      4. New Blogs: This feed delivers the 15 most recent blogs posted on our site.
        http://www.artistserver.com/webservices/blogs_rss.cfm
      5. New Songs by Genre: To set the genre, simply set the last integer in the URL to the genre ID from our site.
        http://www.artistserver.com/webservices/songs_rss.cfm/g/2
      6. Top 40 in Genre - 7 day chart:
        http://www.artistserver.com/webservices/songcharts_rss.cfm/sp/7/g/2
      7. Top 40 in Genre - 30 day chart:
        http://www.artistserver.com/webservices/songcharts_rss.cfm/sp/30/g/2
      8. Reviews by Artist: This feed delivers the 15 most recent reviews of an artist.
        http://www.artistserver.com/webservices/reviews_rss.cfm/a/9
      9. Songs by Artist: This feed delivers the 15 most recent songs by an artist.
        http://www.artistserver.com/webservices/songs_rss.cfm/a/9
      10. Blogs by Artist: This feed delivers the 15 most recent blog postings by an artist.
        http://www.artistserver.com/webservices/blogs_rss.cfm/a/9
      11. Blogs by Members: This feed delivers the 15 most recent blog postings by a member.
        http://www.artistserver.com/webservices/blogs_rss.cfm/a/8173
  3. Site Widgets
    1. Overview - Site Widgets are easy to use objects which can be added to any Web page to provide a selection of music, or ringtones and at a later date, photos. Each widget is a single Javascript link you add to your page, where the parameters that define and control the widget are found in the URL itself.
    2. Widgets Available
      1. song [not yet available]
      2. playlist [tag, genre and artist do not apply] [not yet available]
      3. ringtone [player does not apply]
      4. photo [not yet available]
      5. friend [tag, genre, artist and player do not apply] [not yet available]
    3. Request Format
      <script type="text/javascript" src="http://api.artistserver.com/js.cfm/key/1/widget/song/player/yes/sort/new/count/4/width/200/height/350/bgcolor/FFFFFF/text/000000/link/0000FF/border/666666/genre/4"></script>
    4. Parameters

      The following are the parameters found in a request URL broken down into groupings. All parameters are required except the filters. Not all parameters apply to all widgets - see widget details about which parameters do or do not apply.

      [base url]
      http://api.artistserver.com/ - all api calls will run through this base URL
      [interface]
      js.cfm/ - currently, the only option is javascript, but this will most likely expand to include REST (rest.cfm) at a later date.
      [access key]
      key/*integer*/ - our key is your account ID after you signup at the site.
      [settings]
      widget/*string*/ - the widget name establishes which widget to display
      player/*integer*/ - decides if a flash player is displayed or not. Player is required on the Ringtones Widget
      sort/*top-new*/ - this variable does not apply to all widgets, the options are for a top/chart listing, or a new listing
      count/*integer*/ - the count variable establishes the maximum number of items to display in your widget, we have a range of 2-10
      [layout]
      width/*integer*/ - the width establishes the width of the widget in pixels, the minimum is 120
      height/*integer*/ - the width establishes the height of the widget in pixels, the minimum is 120
      icons/*yes-no*/ - most widgets have items with icons (60 x 60 pixels), here you can select if they should be displayed or not
      [skin]
      bgcolor/*FFFFFF*/ - the background color of the widget
      text/*666666*/ - the text color of the widget
      link/*0000FF*/ - the link color of the widget
      border/*000000*/ - the border color of the widget
      [filters]
      genre/*integer*/ - filters your widget's items by genre ID
      tag/*escaped%20string*/ - filters your widget's items by a Tag (an escaped string)
      artist/*integer*/ - filters your widget's items by artist ID