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 Responses to 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. 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.

  3. Pingback: Introducing the SALT recommender API ( based on 10 years of University of Manchester circulation data) | Innovations

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s