Series resource

This resource returns information about book series.

Specifications

List series

Return a list of series objects.

/series 

Listings require a domain so typically you will specify this as a subresource of a particular domain (see Domains).

/domains/{domain}/series

Get series

Return details about a specific series.

/series/{seriesCode}

Related information

Get objects related to the specified series.

/series/{seriesCode}/authors
/series/{seriesCode}/categories
/series/{seriesCode}/events
/series/{seriesCode}/titles
/series/{seriesCode}/works

Parameters

series.countMin

(optional, numeric) restrict results to series with a count equal to or greater than the number specified

series.countMax

(optional, numeric) restrict results to series with a count equal to or less than the number specified

series.numbered

(optional, boolean) set to 'true' to return only numbered series; set to 'false' to return only unnumbered

series.kids

(optional, boolean) set to 'true' to return series that have kids books; set to 'false' to return series that have no kids books

series.authorId

(optional, numeric, list) restrict the results to just those series which match one of the specified author IDs with the identified "primary authors" of a series via the SERIESxAUTHOR table; note this is different from specifying authorId which considers all the contributors attached to any ISBN that is tagged as being a member of this series code.

series.catUri

(optional, list) restrict the results to just those series for which the featured ISBN has one of the categories identified by the specified cat URIs.

Representation

/domains/PRH.US/series/SOO

        "seriesCode": "SOO",
        "seriesName": "A Song of Ice and Fire",
        "description": "<b>An immersive entertainment experience unlike any other, A Song of Ice and Fire has earned George R. R. Martin—dubbed “the American Tolkien” by <i>Time</i> magazine—international acclaim and millions of loyal readers.</b><br><br> In a land where summers can last decades and winters a lifetime, trouble is brewing. The cold is returning, and in the frozen wastes to the North of Winterfell, sinister and supernatural forces are massing beyond the kingdom’s protective Wall. At the center of the conflict lie the Starks of Winterfell, a family as harsh and unyielding as the land they were born to. Sweeping from a land of brutal cold to a distant summertime kingdom of epicurean plenty, here is a tale of lords and ladies, soldiers and sorcerers, assassins and bastards, who come together in a time of grim omens. Amid plots and counterplots, tragedy and betrayal, victory and terror, the fate of the Starks, their allies, and their enemies hangs perilously in the balance, as each endeavors to win that deadliest of conflicts: the game of thrones.<br><br> <b>Praise for A Song of Ice and Fire</b><br><br> “One of the best series in the history of fantasy.”<b>—<i>Los Angeles Times</i></b><br><br> “Long live George Martin . . . a literary dervish, enthralled by complicated characters and vivid language, and bursting with the wild vision of the very best tale tellers.”<b><i>—The New York Times</i></b><br><br> “The only fantasy series I’d put on a level with J.R.R. Tolkien’s The Lord of the Rings . . . a fantasy series for hip, smart people, even those who don’t read fantasy.”<b>—<i>Chicago Tribune</i></b><br><br> “Martin has produced—is producing, since the series isn’t over—the great fantasy epic of our era.”<b>—Lev Grossman, <i>Time</i></b><br>",
        "seriesCount": 5,
        "seriesDate": "2015-03-31",
        "isNumbered": true,
        "isKids": false,
        "seoFriendlyUrl": "\/series\/SOO\/a-song-of-ice-and-fire",

Views

Series display

Designed to support the PRH.com series detail page.

/series/{seriesCode}/views/series-display

Other series

Designed to list other series related to the specified series by category.

/series/{seriesCode}/views/other-series

The representation is the vanilla series object with the authors array from SERIESxAUTHOR as well.

You can supply the series.countMin and series.countMax parameters to filter which series are returned.

List display

To support PRH.com when the DCAs override the series returned by the other-series display, we need to take a list of series codes and be able to return the same enhanced representation including the SERIESxAUTHOR data.

/series/views/list-display