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. You can obtain your API credentials and share credentials with teammates directly in the Web App following these instructions.

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!