Recommendations

Full Recommendations

Filename: fullrecommendations.xml

Sample Feed: fullrecommendations_small.xml

Contents and Purpose

This is the best work-to-work recommendations feed, replacing the now-deprecated Recommendations Feed. Each recommendation includes author and series codes so that feed users can choose to "throttle" or adjust the recommendations to fit their particular situation.

If you do not throttle or adjust in this way, a given book may recommend ten or even a hundred books by the same author before getting to one by a different author.

Example

<recommendations>
    <work>
        <workcode>26</workcode>
        <authors>
            <id>8034</id>
        </authors>
        <series>
            <id>1406811</id>
        </series>
        <recommendationlist>
            <recommendation>
                <rank>1</rank>
                <workcode>37347</workcode>
                <authors>
                    <id>8034</id>
                </authors>
                <series>
                    <id>1406811</id>
                </series>   
            </recommendation>
            <recommendation>
                <rank>3</rank>
                <workcode>107572</workcode>
                <authors>
                    <id>8034</id>
                </authors>
                <series>
                    <id>1406811</id>
                </series>
            </recommendation>
        </recommendationlist>
    </work>
</recommendations>

Elements and Attributes

<recommendations> is the top-level element.
  • <work> (repeated) is the work that is recommending and all its recommendations.
    • <workcode> (required) the work id, or workcode, of the recommending work.
    • <authors> (optional) the authors of the recommending work.
      • <id> (repeated) the id of the (main) authors of the recommending work.
    • <series> (optional) the series of the recommending work.
      • <id> (repeated) the id of the series of the recommending work.
    • <recommendationlist> (required) encloses all the recommendations.
      • <recommendation> (repeatable) encloses one recommendation.
        • <rank> (required) the rank-order of the recommendation (1 is the best recommendation, 2 the second-best, etc.).
        • <workcode> (required) the work id, or workcode, of the recommendation.
        • <authors> (optional) the authors of the recommended work.
          • <id> (repeated) the id of the author of the recommended work.
        • <series> (optional) the series of the recommended work.
          • <id> (repeated) the id of the series of the recommended work.