Guru API Overview

Guru's API uses the REST protocol with JSON as the data format.

The root of all API endpoints is https://api.getguru.com/api. Individual API endpoints are included in the documentation for the specific call.

There are two versions of the Guru API, a Team (read-only) version and a User (read/write) version. Authentication for the API uses Basic Auth. Contact Guru customer support (via the "Contact Us") to obtain your authentication token, and let us know what you'd like to achieve so we can give the correct token!

To test your authentication credentials with a User token, you can use the curl command line tool as follows:

curl -u USER:TOKEN https://api.getguru.com/api/v1/teams -D -

To test your authentication credentials with a Team token, you can use the curl command line tool as follows:

curl -u COLLECTION ID:TOKEN https://api.getguru.com/api/v1/teams -D -

If your credentials were correct, you should receive a response that lists information about your Guru team

HTTP/1.1 200 OKContent-Type: application/json[ {  "status" : "ACTIVE",  "id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",  "dateCreated" : "2016-01-01T00:00:00.000+0000",  "name" : "My Guru Team"}]

Explore our API documentation here!