Home

Overview

Our API is purely RESTful with each request needing a api_key, a method, and a extra parameter that depends on the method chosen. The response format is XML by default, although this can be overriden using the format parameter to ask for the response to be in json.
Example request URL

http://www.nvivo.es/api/request.php?api_key=XXX&method=user.getEvents&user=hermzz&format=json

Any request will return at least some XML or JSON, the status indicates whether the request was valid or if there was a problem. See the appendix for a list of error IDs and what they mean.
Example succesful XML response

<?xml version="1.0" encoding="UTF-8" ?>
<response status="success" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos">
  <events>
    [ ... ]
  </events>
</response>

Example failed JSON response

{"status": "error", "error": {"id": 7, "message": "The artist you requested doesn\'t exist"}}

API Methods

Third party libraries

  1. PHP5 library written by one of our programmers
  2. Ruby library written by the nice dudes at codegram

If you’ve written a library in another language please let us know

Pages