For developers

Another Read provides an API for developers. Our API makes it easy for developers to query data on Another Read for use in their own apps, websites and 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

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

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/v1/register/default.aspx

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

  • email
  • receiveAlerts

Example query

Example query

var dataToSend = { email: "[email protected]", receiveAlerts: true
		
return $.ajax({
	type: "POST",
	url: "http://anotherread.com/site/read/templates/api/account/json/v1/register/default.aspx",
	dataType: "json",
	traditional: true,
	data: dataToSend
});

 

Activity API

Activity API endpoint

Activity API endpoint

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=activities

The API Endpoint can be queried using the following URL parameters in a GET Request:

  • contributors
  • publishers
  • imprint
  • keywords
  • quantityOfRecord
  • accesskey

Example queries

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

Example query

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=stack&accesskey=XXXXXXXXXXXXXXXX&quantityOfRecord=100&keywords=dog

Example query - 100 activity items matching the keyword of "dog" for the publisher with ID 88.

Example query

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=stack&accesskey=XXXXXXXXXXXXXXXX&quantityOfRecord=100&keywords=dog&publishers=88

Example query - 100 activity items matching the keyword of "dog" for the contributor with ID 8012.

Example query

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=stack&accesskey=XXXXXXXXXXXXXXXX&quantityOfRecord=100&keywords=dog&contributors=8012

Output

The API outputs JSON data, and returns:

ActivityID
A unique ID for the activity item.

CreatedByUserID
The ID of the user that created the item as given by Another Read.

ActivityTypeID
The type of activity.

PublisherID
The ID of the publisher as given by Another Read.

BookID
If the activity is associated with a book, the ID of the book as given by Another Read.

ImprintID
The ID of the Imprint as given by Another Read.

AgeTo
The suggested upper age the activity item may be of interest to.

AgeFrom
The suggested lower age the activity item may be of interest to.

Latitude
If the activity item relates to a geographic location such as an event, the latitude of that event.

Longitude
If the activity item relates to a geographic location such as an event, the longitude of that event.

CreatedDate
The date the activity item was created e.g. 2018-01-01T00:00:00.000.

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

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

Keywords
Keywords associated with the activity item.

Title
The title of the activity item.

HashTags
Suggested hashtags associated with the activity item.

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

AvatarImageUrl
The URL of an avatar associated with the activity item e.g. the author of the book.

LinkUrl
The default URL the activity item should link to.

CategoryList
A list of categories associated with the activity item, each entry includes CategoryID, Name, DeletedByUserID, CategoryTypes.

ContributorList
A list of contributors (authors and illustrators) associated with the activity item, each entry includes ContributorID, StateID, UserID, Name, DisplayName, Biography, SmallAvatarImageFileName, StateName.

ActivityWeightPercent
The weighting associated with an activity item as given by Another Read.

Featured
Indicates whether the activity item is flagged to be featured.

Approved
Indicates whether the activity item is approved.

IsPinned
Indicates whether the activity item is currently pinned.

StyleID
An ID indicating which style to use to display the item within Another Read.

PinFromDate
If pinned, the pinned from date.

PinToDate
If pinned, the pinned to date.

ExpiryDate
A date the activity item should expire.

CanEdit
N/A.

Suggestions API

Suggestions API endpoint

Suggestions API endpoint

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=suggestions

The Suggestions API Endpoint can be queried using the following URL parameters in a GET Request:

  • quantityOfRecord

Example query

Example query

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=suggestions&accesskey=XXXXXXXXXXXXXXXX&quantityOfRecord=100

 

Stacks API

Stacks API endpoint

Stacks API endpoint

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=stacks

The Stacks API Endpoint can be queried using the following URL parameters in a GET Request:

  • quantityOfRecord

Example query

Example query

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=stacks&accesskey=XXXXXXXXXXXXXXXX&quantityOfRecord=100

 

Delete Stacks API endpoint

Delete Stacks API endpoint

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

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

  • usertoken
  • stackidlist

Example query

Example query

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

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

 

Stack Search API endpoint

Stack Search API endpoint

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

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

  • usertoken
  • search
  • quantityofrecords

Example query

Example query

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

 

Get Stack Admin List API endpoint

Get Stack Admin List API endpoint

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

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

  • usertoken
  • pagenumber
  • pagesize

The following parameters are optional:

  • showdefaultstacks

Example query

Example query

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

return $.ajax({
	type: "POST",
	url: "http://anotherread.com/site/read/templates/api/stacks/json/v1/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/v1/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};

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

 

Stack API

Stack API endpoint

Stack API endpoint

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=stack

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

  • stackid

Example query

Example query

http://anotherread.com/site/read/templates/activityfeedapi.aspx?cc=gb&action=stack&accesskey=XXXXXXXXXXXXXXXX&stackid=1

 

Save Stack API endpoint

Save Stack API endpoint

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

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

  • usertoken
  • stacktitle
  • isbnlist
  • ispublished

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/v1/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/v1/save-stack/default.aspx",
	dataType: "json",
	traditional: true,
	data: dataToSend
});

 

Edit Stack API endpoint

Edit Stack API endpoint

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

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

  • usertoken
  • stackid

Example query

Example query

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

 

Today

7 days to go until Music Is My Life is released, illustrated by Ali Mac and written by Myles Tanzer. Published by Wide Eyed Editions.
Myles Tanzer and Ali Mac

Today

7 days to go until The Surprising Lives of Animals is released, illustrated by Stef Murphy and written by Stef Murphy. Published by Ivy Kids.
Stef Murphy

Today

7 days to go until I Like Animals ... what jobs are there? is released, illustrated by Roberto Blefari and written by Steve Martin. Published by Ivy Kids.
Steve Martin and Roberto Blefari

Today

7 days to go until Poems Aloud is released, illustrated by Daniel Gray-Barnett and written by Joseph Coelho. Published by Wide Eyed Editions.
Joseph Coelho and Daniel Gray-Barnett