Author representation

The Author representation is returned by the /authors resource. When a list of authors is returned, you will get back an array of author objects in an element called authors.

Fields

authorId

the numeric identifier (AUTHOR.AUTHORID)

display

the author's full name, suitable for display (AUTHOR.AUTHORDISPLAY)

first

the author's first name (AUTHOR.AUTHORFIRST)

last

the author's last name (AUTHOR.AUTHORLAST)

company

an object with two elements, key and value. If the key is 'R_H' then the value will be empty; otherwise it will contain the division name that the key implies. For more information, see the concept article on multiple authors. (AUTHOR.COMPANY_CODE)

clientSourceId

the authorId from which this record was copied. For more information, see the concept article on multiple authors. (AUTHOR.CLIENT_SOURCE_ID)

contribRoleCode, contribRoleDesc

a code and the description of that code identifying the role that this contributor had in relation to a work or title. For more information, see the concept article on contributor roles. (ISBNxAUTHOR.CONTRIBROLECODE, CONTRIBROLE.CONTRIBROLEDESC)

This field is only populated when the author is being displayed in the context of a specific work ID or ISBN.

For example both /domains/PRH.US/works/203112/authors and /domains/PRH.US/authors/8240?isbn=9780739377727 return

            "contribRoleCode": "A",
            "contribRoleDesc": "Written by",

for the single Janet Evanovich record. It does not matter how the work ID or ISBN is specified as long as it is singular.

Other notes

A link to the author's photo can be extracted from the _links array by looking for rel=icon and extracting the associated href value.

               {
                  "rel":"icon",
                  "href":"https://images.randomhouse.com/author/8240",
                  "method":"GET",
                  "parameters":null
               },

The presence of this link is not a guarantee that the author has a photo however the public image server will always serve a default image (e.g. https://images.randomhouse.com/author/1). Currently there is no way to restrict author listings based on the presence or absence of an author photo.

Example

/domains/PRH.US/authors/8240

{
   "status":"ok",
   "recordCount":​1,
   "startTimestamp":"2016-04-20T10:00Z",
   "endTimestamp":"2016-04-20T10:00Z",
   "timeTaken":​3,
   "data":{
      "authors":[
         {
            "authorId":​8240,
            "display":"Janet Evanovich",
            "first":"Janet",
            "last":"Evanovich",
            "company":{
               "key":"R_H",
               "value":null
            },
            "clientSourceId":​0,
            "seoFriendlyUrl":"/authors/8240/janet-evanovich",
            "contribRoleCode":null,
            "contribRoleDesc":null,
            "_embeds":null,
            "_links":[
               {
                  "rel":"self",
                  "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US/authors/8240",
                  "method":"GET",
                  "parameters":null
               },
               {
                  "rel":"https://api.penguinrandomhouse.com/title/titles/content/definition",
                  "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US/authors/8240/content",
                  "method":"GET",
                  "parameters":null
               },
               {
                  "rel":"icon",
                  "href":"https://images.randomhouse.com/author/8240",
                  "method":"GET",
                  "parameters":null
               },
               {
                  "rel":"https://api.penguinrandomhouse.com/title/events/definition",
                  "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US/authors/8240/events",
                  "method":"GET",
                  "parameters":null
               },
               {
                  "rel":"https://api.penguinrandomhouse.com/title/series/definition",
                  "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US/authors/8240/series",
                  "method":"GET",
                  "parameters":null
               },
               {
                  "rel":"https://api.penguinrandomhouse.com/title/titles/definition",
                  "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US/authors/8240/titles",
                  "method":"GET",
                  "parameters":null
               },
               {
                  "rel":"https://api.penguinrandomhouse.com/title/weblinks/definition",
                  "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US/authors/8240/weblinks",
                  "method":"GET",
                  "parameters":null
               },
               {
                  "rel":"https://api.penguinrandomhouse.com/title/works/definition",
                  "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US/authors/8240/works",
                  "method":"GET",
                  "parameters":null
               }
            ]
         }
      ],
      "_embeds":null,
      "_links":[
         {
            "rel":"https://api.penguinrandomhouse.com/title/domains/definition",
            "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US",
            "method":"GET",
            "parameters":null
         },
         {
            "rel":"https://api.penguinrandomhouse.com/title/views/author-display/definition",
            "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US/authors/8240/views/author-display",
            "method":"GET",
            "parameters":null
         },
         {
            "rel":"self",
            "href":"https://api.penguinrandomhouse.com/title/domains/PRH.US/authors/8240",
            "method":"GET",
            "parameters":null
         }
      ]
   },
   "error":null,
   "params":{
      "domain":"PRH.US",
      "authorId":​8240
   }
}

Versions

version 1

There is currently only one version of the Author representation