.. semetricapi documentation master file, created by sphinx-quickstart on Thu May 26 11:03:06 2011. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. .. index:: sign up, overview, rules, contact A brief introduction ==================== Click to :ref:`signup-label` for a free non-commercial API key. .. toctree:: :maxdepth: 3 :titlesonly: :hidden: self basics identification timeseries summaries events demographics locations lists charts sentiment examples signup -------------- So what is it? -------------- The Musicmetric API provides `RESTful `_ access to the data used in our `products `_. The API provides data for hundreds of thousands of artists. If you'd need a list of artists to get started with whatever you're building, why not try one of our :doc:`charts`. We provide the following data and services: * Time series data of fan activity on a set of social networks, see :ref:`timeseries-label` * Sentiment analysis service for music related text, see :ref:`sentiment-label` * Fan demographics, see :ref:`demographics-label` * Online press coverage of an artist (*coming soon*) ------------- Using the API ------------- **Some general rules:** * Please contact us at api@musicmetric.com for anything related to the API * If you want to use the API commercially please contact us. If you're a company using it to make a hack or dataviz – that’s fine. If you’re bulk scraping the data and using it in your product that’s not. * Be nice. Please don’t access our API using your data centre full of web-crawlers. Keep requests to a maximum of 2 per second. * If you are making a web-based hack, please include our logo to acknowledge your use of our API by deep linking to `this logo image `_ * Let us know if you’ve made anything cool using our API - we'd love to see it!