• Register

Penguin Random House Developer Blog

Enhanced API v1.2.25 released

On Monday June 12, 2017, version 1.2.25 of the Enhanced PRH API was released to production. If you encounter any problems with your applications as a result of these changes, please contact us at api@penguinrandomhouse.com.

Version 1.2.25 release notes

A new feature exposing additional promotional images was added to both the /works/views/product-display and /search/views/search-display endpoint. It is a hash mapping the image type to a list of promo image objects.

For the /works listing, the element additionalPromoImages is added to each Title object and is always populated.

/domains/PRH.US/works/208913/views/product-display

          "additionalPromoImages": {
            "14": [
              {
                "copyright": null,
                "imagename": "9780375869020_3068.pdf",
                "photocredit": null,
                "photocaption": null,
                "photodate": null,
                "releasedB2B": null,
                "releasedB2C": "2017-03-24",
                "promoImageUrl": "https:\/\/images.randomhouse.com\/promo_image\/9780375869020_3068.pdf"
              }
            ],
            "19": [
              {
                "copyright": null,
                "imagename": "9780375869020_3067.pdf",
                "photocredit": null,
                "photocaption": null,
                "photodate": null,
                "releasedB2B": null,
                "releasedB2C": "2017-03-24",
                "promoImageUrl": "https:\/\/images.randomhouse.com\/promo_image\/9780375869020_3067.pdf"
              },
              {
                "copyright": null,
                "imagename": "9780375869020_3069.pdf",
                "photocredit": null,
                "photocaption": null,
                "photodate": null,
                "releasedB2B": null,
                "releasedB2C": "2017-03-24",
                "promoImageUrl": "https:\/\/images.randomhouse.com\/promo_image\/9780375869020_3069.pdf"
              }
            ]
          },

For the /search listing, it is only conditionally populated it populatePromoImages=true is passed. Because it is attached at the work level, the hash of image types to image listings is further mapped by ISBN.

/domains/PRH.US/search/views/search-display?q=wonder&populatePromoImages=true

        "additionalPromoImages": {
          "9780375869020": {
            "14": [
              {
                "copyright": null,
                "imagename": "9780375869020_3068.pdf",
                "photocredit": null,
                "photocaption": null,
                "photodate": null,
                "releasedB2B": null,
                "releasedB2C": "2017-03-24",
                "promoImageUrl": "https:\/\/images.randomhouse.com\/promo_image\/9780375869020_3068.pdf"
              }
            ],
            "19": [
              {
                "copyright": null,
                "imagename": "9780375869020_3067.pdf",
                "photocredit": null,
                "photocaption": null,
                "photodate": null,
                "releasedB2B": null,
                "releasedB2C": "2017-03-24",
                "promoImageUrl": "https:\/\/images.randomhouse.com\/promo_image\/9780375869020_3067.pdf"
              },
              {
                "copyright": null,
                "imagename": "9780375869020_3069.pdf",
                "photocredit": null,
                "photocaption": null,
                "photodate": null,
                "releasedB2B": null,
                "releasedB2C": "2017-03-24",
                "promoImageUrl": "https:\/\/images.randomhouse.com\/promo_image\/9780375869020_3069.pdf"
              }
            ]
          }
        }

New Feature