SALT recommender API

Data Source: University of Manchester, John Rylands Library (circulation data: 2001 – 2011).

Note: Currently not regularly updated, although this is under review.

Licensing: CC-BY

Where: http://vm-salt.mimas.ac.uk/getSuggestions.api

Raw data also available here: http://vm-salt.mimas.ac.uk/data
Note: these are LARGE files. 1GB of data in total

Go here if you want to learn more about how we processed this data

Parameters:

format Format of returned results.  Allowed values: xml and json [default: xml]
isbn ISBN (or JRUL control number) of item for which recommendations are required
threshold Minimum number of unique users who must have borrowed both the item in the request and any recommendation for the recommendation to be included in results [default: 15]
workID JRUL workID of the item for which recommendations are required

Notes:

(i)        one of isbn and workID is required, though if values for both isbn and workID are given then isbn is used in preference (i.e. workID is ignored).

(ii)        a maximum of 40 suggestions are returned.

Results (with example data)

1.    Request successful, results found (results returned)

http://vm-salt.mimas.ac.uk/getSuggestions.api?isbn=0552153575&threshold=6

Returns HTTP Status 200 OK.

XML (default format)

<?xml version=”1.0″ encoding=”UTF-8″?>

<Response_getSuggestions>

<Item>

<isbn>041508881x</isbn>

<citation>Dawson, Graham. – Soldier heroes : British adventure, Empire and the imagining of masculinity 1994</citation>

<workID>838073</workID>

<ranking>1</ranking>

</Item>

</Response_getSuggestions>

JSON (with additional parameter format=json)

[{“isbn”:”041508881x”,”citation”:”Dawson, Graham. – Soldier heroes : British adventure, Empire and the imagining of masculinity 1994″,”workID”:”838073″,”ranking”:1}]

2.    Request successful, no results found (comment returned)

 http://vm-salt.mimas.ac.uk/getSuggestions.api?isbn=0552153575

Returns HTTP Status 404 Not Found.

XML (default format)

<?xml version=”1.0″ encoding=”UTF-8″?>

<Response_getSuggestions>

<Comment>No suggestions found [isbn: 0552153575, threshold = 15]</Comment> </Response_getSuggestions>

JSON (with additional parameter format=json)

{“comment”:”No suggestions found [isbn: 0552153575, threshold = 15]”}

3.    Request unsuccessful, invalid parameter value (error returned)

http://vm-salt.mimas.ac.uk/getSuggestions.api?isbn=0552153575%%

Returns HTTP Status 400 Bad Request.

XML (default format)

<?xml version=”1.0″ encoding=”UTF-8″?>

<Response_getSuggestions>

<Error>Invalid isbn [0552153575%%]</Error>

</Response_getSuggestions>

JSON (with additional parameter format=json)

{“error”:”Invalid isbn [0552153575%%]”}

4 thoughts on “SALT recommender API

  1. Pingback: Introducing the SALT recommender API ( based on 10 years of University of Manchester circulation data) | SALT – Surfacing the Academic Long Tail

  2. Pingback: Announcing the Copac Activity Data Project (otherwise known as SALT 2) | Copac Activity Data Project

Leave a Reply

Your email address will not be published. Required fields are marked *