On Friday November 6, 2015, version 1.1.11 of the Enhanced PRH API was released to production. The IO Docs have been updated to reflect new parameters. If you encounter any problems with your applications as a result of these changes, please contact us at api@penguinrandomhouse.com.

Version 1.1.11 release notes

Retail links added

When a user asked us recently about retail links we had to report that unfortunately they were not available in the API. Well thanks to some help from our colleague Mike Yacullo, we are happy to announce the addition of a /retaillinks sub-resource which can be accessed off a specific title, e.g./domains/PRH.US/titles/9780140056433/retaillinks. This generates a list of links to various retailers and can accept an affiliateSiteId to tailor which affiliate gets credit for the link (see documentation).

Other changes

The Title representation gained a new element, cartonQuantity, which gives the number of books per carton and comes from SAP.

List requests got a new parameter option, catSeq. This integer value can be specified multiple times and targets the seq value on the Title-Category join table. It can be used to restrict which joins are considered when you're listing titles from category or vice versa. For example if you wanted to return titles for which "Epic Fantasy" was only the first category, you could request:

/domains/PRH.US/titles?catUri=/epic-fantasy&catSeq=1

Bug fixes

A couple of the bug fixes are worth noting. RHAPI-361 was about an issue with the /authors endpoint when multiple Author ID values were specified. The count returned was correctly two but there were two copies of each author record. This has been fixed.

RHAPI-367 reported an issue where the /works endpoint was reporting the number of ISBNs rather than the number of works. This was fixed with a modification to the SQL.

Bug

• [RHAPI-353] - Links exposed in search results improper
• [RHAPI-354] - Alternate author link should be suppressed when clientSourceId = 0
• [RHAPI-361] - Incorrect cardinality of /authors
• [RHAPI-367] - Work count incorrect

New Feature

• [RHAPI-349] - Add "cartonQty" to the TItle representation
• [RHAPI-359] - Expose retailer links as a title subresource
• [RHAPI-363] - Add "catSeq" parameter to restrict category matches

Task

• [RHAPI-348] - Add "series.minPrintScore" parameter for /series
• [RHAPI-360] - Please add an onsaledate for the frontlistiest title in the works/views/list-display