S2O Partner API Introduction

afterpageloadcalls

Brief description of S2O

S2O is is our Song to Opportunity matching system. Music Xray can take any mp3, extract relevant audio features and and find out how closely correlated the mp3 is to an existing database of songs. Music Xray also provides best in class opportunities for artists looking to place their music within the music industry. Many times the industry knows exactly what type of music they are looking for. Thus, they upload seed songs. We then use those seed songs to determine which songs would be likely fits to which opportunities. On our site we tell our users via various methods what type of matches are available to them. Integrating with our S2O partner API allows you to do the same. When users come to our site via the links provided by s2o to opportunities and sign up they will be your affiliates and you will earn commission on all future purchases from that user.

API design Principle

The S2O Partner API is built with the design principles of REST in mind, exposing Music Xray resources like tracks, track sets which can be accessed and manipulated using the HTTP methods GET, POST, PUT and DELETE.

All S2O Partner API resources are accessed and manipulated in a similar way. A list of the latest resources is usually available through /[resource name], a single specific resource through /[resource name]/[id].

XML is the only supported format currently please make sure you use ".xml" when querying and endpoint to maintain backwards compatibility. If you are using our ruby SDK you do not need to worry about those details.

Step 1 :: Sign Up as a Fan or Artist

You will need sign up for an account at http://www.musicxray.com. When prompted to choose your account type you can choose fan or artist but do not choose music industry professional. If you already have an account you can skip this step and move on.

Step 2 :: Register Application

Visit the following link and register a new application.

register a new app

Step 3 :: Tell us your intentions with the API

Send an email to jeff@musicxray.com from the same email address you used to sign up. The subject should be "partner api access request", please include detailed description of how you intend to use the api and the domain that is going to have the integration. At this time access to the API is only being granted on a very limited basis while we work to improve our scalability. In the near future we will be removing this step but as we ramp up and address some concerns we've decided to go slow as to meet the needs of our partners in a controlled manner.

Step 4 :: Download the ruby SDK

Please visit our SDK page to find a library that works for your site. If one isn't available, please let us know and we may be able to create one for you. If we are unable to create one in the language of your choice then you will have to read the rest of the API documentation and create an SDK from scratch. If you do so, please let us know about it so we can tell other developers who might have the same problem.

Step 5 :: Integrate and Profit

Okay, admittedly this is much easier said than done please check out some of the following resources to get a better understanding of the integration details.