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%%]”}
Pingback: Introducing the SALT recommender API ( based on 10 years of University of Manchester circulation data) | SALT – Surfacing the Academic Long Tail
Fantastic stuff!
I’ve knocked up a html / js browser for the salt recommender, based on an ISBN. It also uses a bit of COPAC SRU data and Syndetics images from the Cambridge subscription. Links out to CUL catalogue right now, if you give my the linking for Manchester I can add they as well.
http://www.lib.cam.ac.uk/recommend/
Very buggy, not IE friendly.
Pingback: Introducing the SALT recommender API ( based on 10 years of University of Manchester circulation data) | Innovations