API Introduction

Woopra API is mostly RESTful. API calls should be made with HTTP POST/GET to https://www.woopra.com/rest/[version]/[call].

A valid response has a 200 status code and a valid JSON in the body.

Authentication

Generate a new Access Key in your members area, use App Id and Secret Key as user and password respectively for your Http Basic Authorization header:

Example Command Line (curl):

curl --user AppID:SecretKey https://www.woopra.com/rest/2.2/report ...

Versioning

Supported versions: 2.0, 2.1 and 2.2

https://www.woopra.com/rest/2.0/call

https://www.woopra.com/rest/2.1/call

https://www.woopra.com/rest/2.2/call

There is no change log for 2.2, 2.1. Future change logs will be posted here.

Examples

Example jQuery Snippet


$.ajax({
    type: 'POST',
    url: 'http://www.woopra.com/rest/2.2/profile',
    crossDomain: true,
    dataType: "json",
    jsonp: false,
    cache: false,
    beforeSend: function (xhr) {
        xhr.setRequestHeader('Authorization', 'Basic '+btoa("RONWDCCFEOHVQ4U30ESHSYNTW4W9VVZ7" + ":" + "JhYxou0LOHgEasdGD4z3CufdhgtjwFrw2WdOAtQFG56265gGYggqbAMuYEOirVo"));
    },
    data: {
    	request: JSON.stringify( { "website": "woopra.com", "date_format": "MM-dd-yyyy", "email": "tigi@brembo.com" })
    },
    success: function (text) {
        alert(text);
    }
});

Example raw HTTP frame:

POST /rest/2.2/profile HTTP/1.1
Host: www.woopra.com
Authorization: Basic XXX...

{
    "website": "woopra.com",
    "date_format": "MM-dd-yyyy",
    "email": "tigi@brembo.com"
}

OR

POST /rest/2.2/profile HTTP/1.1
Host: www.woopra.com
Authorization: Basic XXX...

request=%7B%22website%22%3A+%22woopra.com%22%2C%22date_format%22%3A+%22MM-dd-yyyy%22%2C%22email%22%3A%22tigi%40brembo.com%22%7D

Using curl


curl https://www.woopra.com/rest/2.2/profile \
--user QSBEUTTEZ8J5CEUVIUECQK99PWVH7TLE:wmaH6Oqk9THl7gW3nouRBSsIHyM8d9YJjIhwRgTLbUI1Spnnqb4bqMEP7CuBJQ7C \
-X POST -d \
  '{
    "website": "woopra.com",
    "date_format": "MM-dd-yyyy",
    "email": "tigi@brembo.com"
  }'

Do you know what your customers are doing?
Find out in 5 minutes.

Start your 30-day free trial. No credit cards. No obligations.

Try it out