Deprecated
NOTE: These feeds are deprecated for ongoing use and may not be updated frequently. They are retained for legacy reasons.
Recommendations
Filename: recommendations.xml
Sample Feed: recommendations_small.xml
Status: No longer being added to; file be retired May 1, 2022
Contents and Purpose
This is a straightforward work-to-recommended works format.
Note: This is a deprecated feed. The data in this feed uses a version of the recommendations algorithm which has been superceded. In addition, recommendations within this feed will include too many author- and series-repetitions for display, unless you throttle them back on other data.
Example
<recommendations>
<work workcode="14" count="20">
<recommendedwork rank="1">708756</recommendedwork>
<recommendedwork rank="2">376671</recommendedwork>
<recommendedwork rank="3">1392416</recommendedwork>
...
<recommendedwork rank="20">136284</recommendedwork>
</work>
</recommendations>
Elements and Attributes
<recommendations>
is the top-level
element.
<work>
(repeated) is the work that is recommending. Is has the required attributes:workcode="N"
attr is the work id, called the workcode.count="N"
attr is the number of recommendations.<recommendedwork>
(repeated) is for the works recommended. The number within the element is the work id, or workcode, of the work recommended.rank="N"
attr is rank of the recommendation—1 is the best recommendation, 2 the second-best, etc.
Series Information
Contents and Purpose
This is a feed of series information for works.
Example
<commonknowledge>
<item>
<key>23-1827134-eng</key>
<language>English</language>
<type>series</type>
<text>A Sleuthing Sisters Mystery</text>
<status>0</status>
<descriptionlist>
<description>
<language>eng</language>
<text>
The Sleuthing Sisters is a cozy-mystery series set in Michigan and written by Maggie Pill.
</text>
</description>
</descriptionlist>
<worklist>
<work order="0001">
<workcode>5138658</workcode>
<text>A Sleuthing Sisters Mystery (Book 1)</text>
<displaytext>A Sleuthing Sisters Mystery</displaytext>
<position>Book 1</position>
<position_simple>1</position_simple>
<order>0001</order>
</work>
<work order="0002">
<workcode>6292862</workcode>
<text>A Sleuthing Sisters Mystery (Book 2)</text>
<displaytext>A Sleuthing Sisters Mystery</displaytext>
<position>Book 2</position>
<position_simple>2</position_simple>
<order>0002</order>
</work>
<work order="0003">
<workcode>8970934</workcode>
<text>A Sleuthing Sisters Mystery (Book 3)</text>
<displaytext>A Sleuthing Sisters Mystery</displaytext>
<position>Book 3</position>
<position_simple>3</position_simple>
<order>0003</order>
</work>
<work order="0009">
<workcode>6832344</workcode>
<text>A Sleuthing Sisters Mystery (9|Omnibus 1 - 3)</text>
<displaytext>A Sleuthing Sisters Mystery</displaytext>
<position>Omnibus 1 - 3</position>
<position_simple>Omnibus 1 - 3</position_simple>
<order>0009</order>
</work>
</worklist>
</item>
</commonknowledge>