- Previous: Series resource
- Up: Resources
- Next: Work resource
Title resource
This resource returns information about books identified by ISBNs.
See also Concepts - Works and ISBNs
Specifications
List titles
Return a list of title objects.
/titles
Listings require a domain so typically you will specify this as a subresource of a particular domain (see Domains).
/domains/{domain}/titles
Get title
Get details about a specific ISBN
/titles/{isbn}
Additional content
Get additional title content.
/titles/{isbn}/awards
/titles/{isbn}/characters
/titles/{isbn}/content
/titles/{isbn}/dimensions
/titles/{isbn}/hashtags
/titles/{isbn}/keywords
/titles/{isbn}/promoimages
/titles/{isbn}/retaillinks
/titles/{isbn}/salesrestrictions
Related info
Get objects related to the specified ISBN.
/titles/{isbn}/authors
/titles/{isbn}/categories
/titles/{isbn}/divisions
/titles/{isbn}/domains
/titles/{isbn}/events
/titles/{isbn}/imprints
/titles/{isbn}/series
/titles/{isbn}/weblinks
/titles/{isbn}/works
Parameters
There are no parameters specific to the Title resource.
Representation
Note that the cover image can be found within the _links element by searching for the record with rel=icon (see Concepts > Images).
/domains/PRH.US/titles/9780140067484
{
"isbn": 9780140067484,
"isbnHyphenated": "978-0-14-006748-4",
"title": "The Puzzle Palace",
"subtitle": "Inside America's Most Secret Intelligence Organization",
"author": "James Bamford",
"onsale": "1983-09-29",
"price": [
{
"amount": 20,
"currencyCode": "USD",
"pricingType": null
}
],
"seoFriendlyUrl": "\/books\/321214\/the-puzzle-palace-by-james-bamford\/9780140067484",
"format": {
"code": "TR",
"description": "Trade Paperback"
},
"subformat": {
"code": null,
"description": null
},
"division": {
"code": "62",
"description": "Penguin Adult HC\/TR"
},
"imprint": {
"code": "ID",
"description": "Penguin Books"
},
"pages": 656,
"age": {
"code": null,
"description": null
},
"grade": {
"code": null,
"description": "ALL"
},
"sgmt_desc": null,
"subjects": [
{
"code": "HIS036070",
"description": "History - United States - 21St Century"
},
{
"code": "POL036000",
"description": "Political Science - Intelligence & Espionage"
},
{
"code": "LAW039000",
"description": "Law - Government - Federal"
}
],
"trim": "5-1\/16 x 7-3\/4",
"formatFamily": "Paperback",
"consumerFormat": "Paperback",
"consumerImprint": "Penguin Books",
"consumerImprintUri": "PenguinBooks",
"saleStatus": "IP",
"language": "E",
"seriesNumber": null,
"subseries": null,
"editionType": null,
"propertyName": null,
"cartonQuantity": 28,
"version": "Regular Edition",
"productLine": "43A",
"productType": "3AB",
"flags": [
],
"workId": 321214,
"frontlistiestSeq": null,
"contribRoleCode": null,
"contribRoleDesc": null,
"salesRestriction": {
"code": "07",
"description": "US, Canada, Open Mkt"
},
"titleBlock": null,
"titleShort": "PUZZLE PALACE, THE",
"audioPackage": null,
"projectedMinutes": null,
"binding": {
"code": null,
"description": null
},
"editionId": 0,
"_links": [
{
"rel": "self",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484",
"method": "GET",
"parameters": null
},
{
"rel": "icon",
"href": "https:\/\/images.randomhouse.com\/cover\/9780140067484",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/authors\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/authors",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/categories\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/categories",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/titles\/awards\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/awards",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/titles\/characters\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/characters",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/titles\/content\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/content",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/events\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/events",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/titles\/hashtags\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/hashtags",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/titles\/promoimages\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/promoimages",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/titles\/retaillinks\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/retaillinks",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/weblinks\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/titles\/9780140067484\/weblinks",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/divisions\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/divisions\/62",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/imprints\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/imprints\/ID",
"method": "GET",
"parameters": null
},
{
"rel": "https:\/\/api.penguinrandomhouse.com\/title\/works\/definition",
"href": "https:\/\/api.penguinrandomhouse.com\/title\/client\/Public\/domains\/PRH.US\/works\/321214",
"method": "GET",
"parameters": null
}
],
"_embeds": null
}
Views
List display
Used by PRH.com to display ISBN-based pubsets.
/titles/views/list-display
Product display
Used by Penguin.com to fetch title-level data to drive product display templates. It is the same representation as the work product display view.
/titles/{isbn}/views/product-display
Retail links
As of version 1.1.11, you may now fetch affiliated retailer links with the /retaillinks sub-resource.
/titles/{isbn}/retaillinks?affiliateSiteId={affiliateSiteId}
This is implemented by calling the Penguin service that PRH.com has used to generate affiliate links.
To get links with the appropriate affiliate code embedded, you should specify an affiliateSiteId parameter. The possible values are:
103 Stacks US 104 Penguin FB MyList 201 Random House 301 Penguin Random House 302 Brightly 303 Bookmarks 401 LitFlash 403 Stacks BR 8001 Affiliate - Default PRH 8002 Affiliate - Penguin Press 8003 Affiliate - Penguin Newsletters 8004 Retailer Widget Default
Here is a sample call and a portion of the output.
/domains/PRH.US/titles/9780140056433/retaillinks
{
"description": "Amazon",
"displayName": "Amazon",
"isbn": 9780140056433,
"url": "http:\/\/www.amazon.com\/gp\/product\/B002IVZ5UO?tag=randohouseinc7913-20",
"retailerId": 7,
"siteId": 8001,
"trackingCode": "randohouseinc7913-20",
"_embeds": null,
"_links": [
]
}
- Previous: Series resource
- Up: Resources
- Next: Work resource
0 Comments
Please sign in to post a comment.