maxtv-api is the API of maxtv-labs, available at

What is an API ?
An API (Application Program Interface) is a set of routines, protocols, and tools for building software applications.
Basically, an API specifies how software components should interact.
Additionally, APIs are used when programming graphical user interface (GUI) components.

A complete overview of the maxtv-api functionalities is available with maxtv-api-explorer tool (based on swagger-ui).
Note : this overview is complete only if you're logged with your maxtv account.


maxtv-api is compatible with OAuth 2.0 for some specific scopes.
OAuth 2.0 is the industry-standard protocol for authorization.
maxtv-api follows this naming convention for the API url : {scheme}://{host}/{scope}/{function}.{format}

It's the protocole scheme of an url : http or https

It's the server address : or

A scope is a mechanism in OAuth 2.0 to limit an application's access to a user's account.
In maxtv-api, it's also a list of functions.
You can find all scopes available in the maxtv-api-explorer tool.

the name of a function available in the scope.
You can find all function available in the maxtv-api-explorer tool.

in maxtv-api, the output format is generally json or xml, but some specific function can output an other format.
You can find the output format for each functions in the maxtv-api-explorer tool.

Examples :
{sheme} : https | {host} : | {scope} : user | {function} : browser | {output} : json
{sheme} : https | {host} : | {scope} : user | {function} : browser | {output} : xml


api.js is a javascript method provided by maxtv-labs to query maxtv-api

How to use api.js :

1 - load api.js

<script src="//"></script>
    var api = new maxtv_api_object(); = '';
    api.client_id = 'my_client_id';
    api.scope = 'user';
    api.key = 'my_api_key';

2 - query the maxtv-api with api.get method

    api.get('//' + + '/user/ip.json', function(data){
    }, function(data){

3 - query the maxtv-api with method

<script>'user', 'ip', function(data){
    }, function(data){