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

Filename: ckinfo_series.xml

Sample Feed: ckinfo_series.xml

Status: To be retired May 1, 2022

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>