For Developers

Another Read provides an API for developers. Our API makes it easy to query data on Another Read for use in applications, websites, and other digital projects.

Authentication

The API requires a key. If you would like to make use of the API contact us to request a key.

Usertoken API

Get Usertoken API endpoint

                  
http://anotherread.com/site/api/user/json/v1/get-api-key/default.aspx

For endpoints which require a logged in user, account validation is provided through checks against a supplied usertoken which has a limited lifespan. The Get Usertoken API Endpoint requires the following parameters in a POST Request:

username
password

Example query

                  
var dataToSend = { username: "user", password: "1234" };
    
return $.ajax({
  type: "POST",
  url: "http://anotherread.com/api/user/json/v1/get-api-key/default.aspx",
  dataType: "json",
  traditional: true,
  data: jQuery.param(dataToSend)
});

Account API

Register API endpoint

Get Usertoken API endpoint

                  
http://anotherread.com/site/read/templates/api/account/json/v2/register/default.aspx

The Register API Endpoint requires the following parameters in a POST Request:

email
receiveAlerts

Example query

                  
var dataToSend = { email: "[email protected]", receiveAlerts: true

return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/account/json/v2/register/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Activity API

Activity API endpoint

                  
http://anotherread.com/site/read/templates/api/activities/json/v2/get-activity-list/default.aspx

The Activity API Endpoint requires the following parameters in a POST Request:

accesskey
quantityofrecords
pagesize

The Activity API Endpoint requires at least 1 of the following parameters:

contributors
publishers
keywords

Example queries

Example query - 100 activity items matching the keyword of "dog".

Example query

 
var dataToSend = { accesskey:"1234", quantityofrecords:100, keywords:"dog"};
				  
return $.ajax({
  type: "POST",
  url: "https://anotherread.com/site/read/templates/api/activities/json/v2/get-activity-list/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Example query - 100 activity items matching the keyword of "dog" or the publisher Quarto.

Example query

                  
var dataToSend = { accesskey:"1234", quantityofrecords:100, keywords:"dog", publishers:"Quarto"};
				  
return $.ajax({
  type: "POST",
  url: "https://anotherread.com/site/read/templates/api/activities/json/v2/get-activity-list/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Output

The API outputs JSON data, and returns:

ActivityID
A unique ID for the activity item.

ActivityDate
The date the activity item was set to display from e.g. 2018-01-01T00:00:00.

ActivityText
Text content of the activity item, this can include HTML mark-up.

Title
The title of the activity item.

HashTags
Suggested hashtags associated with the activity item.

ActivityJacketImage
The URL of an image associated with the activity item.

Isbn
If the activity is associated with a book, the isbn of the book.

ActivitySourceType
The source type for the activity. This could be Generated, Web or Twitter

ActivityType
The type of activity as given by Another Read.

ContributorList
A list of contributors (authors and illustrators) associated with the activity item, each entry includes ContributorID.

BookLookup
A lookup of book details indexed by Isbn.

ContributorLookup
A lookup of contributor details indexed by ContributorID.

Suggestions API

Suggestions API endpoint

                  
http://anotherread.com/site/read/templates/api/activities/json/v2/get-suggestion-list/default.aspx

The Suggestions API Endpoint requires the following parameters in a POST Request:

usertoken
includestackbooks
includestackbookratings
onlyrecommendationswithbooks

The following parameters are optional:

activitystartdate
activityenddate
activitytype
permitdynamicrecommendations
pagesize
pagenumber

Example query

                  
var dataToSend = { usertoken:"1234", includestackbooks: true, includestackbookratings: true, onlyrecommendationswithbooks: false };
                        
return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/activities/json/v2/get-suggestion-list/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Stacks API

Get Stacks API endpoint

                  
http://anotherread.com/site/read/templates/api/stacks/json/v2/get-stack-list/default.aspx

The Get Stacks API Endpoint requires the following parameters in a POST Request:

usertoken
includebooks
includeratings

The following parameters are optional:

pagesize
pagenumber

Example query

                  
var dataToSend = { usertoken:"1234", includebooks: true, includebookratings: true };
                        
return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/stacks/json/v2/get-stack-list/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Delete Stacks API endpoint

                  
http://anotherread.com/site/read/templates/api/stacks/json/v2/delete-stacks/default.aspx

The Delete Stacks API Endpoint requires the following parameters in a POST Request:

usertoken
stackidlist

Example query

                  
var dataToSend = { usertoken:"1234", stackidlist: "1234, 5678"};

return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/stacks/json/v2/delete-stacks/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Stack Search API endpoint

                  
http://anotherread.com/site/read/templates/api/stacks/json/v2/stack-search/default.aspx

The Stack Search API Endpoint requires the following parameters in a POST Request:

usertoken
search
quantityofrecords
includeratings

Example query

                  
var dataToSend = { usertoken:"1234", search: "books", quantityofrecords: 10, includeratings:true };
                        
return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/site/read/templates/api/stacks/json/v2/stack-search/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Get Stack Admin List API endpoint

                  
http://anotherread.com/site/read/templates/api/stacks/json/v2/get-stack-admin-list/default.aspx

The Get Stack Admin List API Endpoint requires the following parameters in a POST Request:

usertoken
pagenumber
pagesize
includebooks
includeratings

The following parameters are optional:

showdefaultstacks

Example query

                  
var dataToSend = { usertoken:"1234", pagenumber:1, pagesize: 10, includebooks:true, includeratings:true};

return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/stacks/json/v2/get-stack-admin-list/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Example query (showing only default stacks)

                  
var dataToSend = { usertoken:"1234", pagenumber:1, pagesize: 10, showdefaultstacks:true};

return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/stacks/json/v2/get-stack-admin-list/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Example query (hiding default stacks)

                  
var dataToSend = { usertoken:"1234", pagenumber:1, pagesize: 10, showdefaultstacks:false, includebooks:true, includeratings:true};

return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/stacks/json/v2/get-stack-admin-list/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Stack API

Get Stack API endpoint

                  
http://anotherread.com/site/read/templates/api/stacks/json/v2/get-stack/default.aspx

The Get Stack API Endpoint requires the following parameters in a POST Request:

usertoken
stackid
includebooks
includeratings

The following parameters are optional:

relatedbooklimit

Example query

                  
var dataToSend = { usertoken:"1234", stackid:1234, includebooks:true, includeratings:true};

return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/stacks/json/v2/get-stack/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Save Stack API endpoint

                  
http://anotherread.com/site/read/templates/api/stacks/json/v2/save-stack/default.aspx

The save Stack API Endpoint requires the following URL parameters in a POST Request:

usertoken
stacktitle
isbnlist
ispublished

The following parameters are optional:

includeratings

Example stack creation query

Example query

                  
var dataToSend = { usertoken:"1234", stacktitle: "Example stack", isbnlist: "1234, 4567", ispublished: true};
                        
return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/stacks/json/v2/save-stack/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Example update stack query

Example query

                  
var dataToSend = { usertoken:"1234", stacktitle: "Example stack", isbnlist: "1234, 4567", ispublished: true, stackid: 1234};

return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/stacks/json/v2/save-stack/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Edit Stack API endpoint

                  
http://anotherread.com/site/read/templates/api/stacks/json/v2/edit-stack/default.aspx

The Edit Stack API Endpoint requires the following parameters in a POST Request:

usertoken
stackid
includeratings

Example query

                  
var dataToSend = { usertoken:"1234", stackid: 1234, includeratings:true };
                        
return $.ajax({
  type: "POST",
  url: "http://anotherread.com/site/read/templates/api/stacks/json/v2/edit-stack/default.aspx",
  dataType: "json",
  traditional: true,
  data: dataToSend
});

Start today

If you would like to make use of the API contact us to request a key.

Get in touch