Print score

While the PRH API does not expose sales or printing figures in the results, you can use the print score field to help order or filter your results relative to each other.

Defining print score

Print score is computed at the work level based on a field called LTD total in print that is stored at the ISBN level. We call the field print score rather than "LTD in print" because we exclude certain ISBNs from this calculation in an effort to make products from different divisions and different markets more comparable. The final rules were derived by the group driving the PRH.com site but we believe these rules and the resulting lists are generally useful to anyone using the API.

Titles excluded from the print score computation

All the ISBNs of a work are used in the computation of a print score except titles with:

  • a format code of
    • CD (‘Abridged Compact Disc’, ‘Compact Disc’, ‘Unabridged Compact Disc’)
    • CS (‘Abridged Cassette’, ‘Cassette’)
    • DN (‘Abridged Audiobook Download’, ‘Audiobook Download’, ‘Unabridged Audiobook Download’)
    • MM (Paperback)
  • an imprint code of
    • A4 (Everyman's Library )
    • C6 (Living Language)
    • GB (Golden Books)
    • I2 (Princeton Review)
    • PG (Prima Games)
    • W1 (WaterBrook Press)
    • WG (Watson-Guptill) 
  • a Game BISAC code
  • a BISAC code of "JNF014000"
  • e-books with no subformat
  • e-books with specific subformats
  • (format_code=’EL’) and subformat IN ( '001','002','003','004','005','020','021','022','023','024','025','032')
  • a CN category of Merchandise (2000000086)
  • a CN category of Children's Books (2000000029) or Children's Middle Grade Books (2000000100)

As a sort order

You can order works by print score by specifying sort=printscore. Obviously this is most useful coupled with dir=desc to show the highest printing titles first.

For example here is a listing of the 3 new releases with the highest print score as of 10/21/2015.

/domains/PRH.US/works?showNewReleases=true&rows=3&sort=printScore&dir=desc

    "works": [
      {
        "workId": 98144,
        "title": "The Girl with the Dragon Tattoo",
        "author": "Stieg Larsson",
        "onsale": "2008-09-16",
        "language": "E",
        "seoFriendlyUrl": "\/books\/98144\/the-girl-with-the-dragon-tattoo-by-stieg-larsson",
        "_links": [
          
        ],
        "_embeds": null
      },
      {
        "workId": 295286,
        "title": "Paper Towns",
        "author": "John Green",
        "onsale": "2008-10-16",
        "language": "E",
        "seoFriendlyUrl": "\/books\/295286\/paper-towns-by-john-green",
        "_links": [
          
        ],
        "_embeds": null
      },
      {
        "workId": 36941,
        "title": "The Maze Runner (Maze Runner Series #1)",
        "author": "James Dashner",
        "onsale": "2009-10-06",
        "language": "E",
        "seoFriendlyUrl": "\/books\/36941\/the-maze-runner-maze-runner-series-1-by-james-dashner",
        "_links": [
          
        ],
        "_embeds": null
      }
    ],

 

As a filter

The parameter minPrintScore is useful when you want to sort by something other than print score. This is used by PRH.com for certain carousels and promotional spots where the goal is to promote the biggest titles of the season.

For example, here is a listing of titles coming soon ordered by ascending date with a 40,000 floor for the print score field.

/domains/PRH.US/titles?showComingSoon=true&rows=3&sort=onsale&dir=asc&minPrintScore=40000

    "titles": [
      {
        "isbn": 9780142425763,
        "isbnHyphenated": "978-0-14-242576-3",
        "title": "I'll Give You the Sun",
        "subtitle": null,
        "author": "Jandy Nelson",
        "onsale": "2015-10-27",
        "price": [
          {
            "amount": 10.99,
            "currencyCode": "USD",
            "pricingType": null
          },
          {
            "amount": 13.99,
            "currencyCode": "CAD",
            "pricingType": null
          }
        ],
        "seoFriendlyUrl": "\/books\/306095\/ill-give-you-the-sun-by-jandy-nelson\/9780142425763",
        "format": {
          "code": "TR",
          "description": "Trade Paperback"
        },
        "division": {
          "code": "64",
          "description": "Penguin Young Readers"
        },
        "imprint": {
          "code": "JW",
          "description": "Speak"
        },
        "pages": 400,
        "age": {
          "code": "14UP",
          "description": "14 and up"
        },
        "grade": {
          "code": "09UP",
          "description": "Grade 9 & Up"
        },
        "sgmt_desc": null,
        "subjects": [
          {
            "code": "JUV013070",
            "description": "Juvenile Fiction - Family - Siblings"
          },
          {
            "code": "JUV039030",
            "description": "JUV039030"
          },
          {
            "code": "JUV060000",
            "description": "Juvenile Fiction - LGBT"
          }
        ],
        "trim": "5-1\/2 x 8-1\/4",
        "formatFamily": "Paperback",
        "consumerFormat": "Paperback",
        "consumerImprint": "Speak",
        "consumerImprintUri": "Speak",
        "saleStatus": "IN",
        "language": "E",
        "seriesNumber": null,
        "subseries": null,
        "editionType": null,
        "propertyName": null,
        "flags": [
          
        ],
        "workId": 306095,
        "frontlistiestSeq": null,
        "_links": [
          
        ],
        "_embeds": null
      },
      {
        "isbn": 9780143108399,
        "isbnHyphenated": "978-0-14-310839-9",
        "title": "The Danish Girl",
        "subtitle": "A Novel (Movie Tie-In)",
        "author": "David Ebershoff",
        "onsale": "2015-10-27",
        "price": [
          {
            "amount": 16,
            "currencyCode": "USD",
            "pricingType": null
          },
          {
            "amount": 21,
            "currencyCode": "CAD",
            "pricingType": null
          }
        ],
        "seoFriendlyUrl": "\/books\/319110\/the-danish-girl-by-david-ebershoff\/9780143108399",
        "format": {
          "code": "TR",
          "description": "Trade Paperback"
        },
        "division": {
          "code": "62",
          "description": "Penguin Adult HC\/TR"
        },
        "imprint": {
          "code": "ID",
          "description": "Penguin Books"
        },
        "pages": 304,
        "age": {
          "code": null,
          "description": null
        },
        "grade": {
          "code": null,
          "description": "ALL"
        },
        "sgmt_desc": null,
        "subjects": [
          {
            "code": "FIC019000",
            "description": "Fiction - Literary"
          },
          {
            "code": "FIC014000",
            "description": "FIC014000"
          },
          {
            "code": "FIC011000",
            "description": "Fiction - Gay"
          }
        ],
        "trim": "5-5\/16 x 8",
        "formatFamily": "Paperback",
        "consumerFormat": "Paperback",
        "consumerImprint": "Penguin Books",
        "consumerImprintUri": "PenguinBooks",
        "saleStatus": "IN",
        "language": "E",
        "seriesNumber": null,
        "subseries": null,
        "editionType": null,
        "propertyName": null,
        "flags": [
          
        ],
        "workId": 319110,
        "frontlistiestSeq": null,
        "_links": [
          
        ],
        "_embeds": null
      },
      {
        "isbn": 9780143108993,
        "isbnHyphenated": "978-0-14-310899-3",
        "title": "Lost Ocean",
        "subtitle": "An Inky Adventure and Coloring Book",
        "author": "Johanna Basford",
        "onsale": "2015-10-27",
        "price": [
          {
            "amount": 21.95,
            "currencyCode": "CAD",
            "pricingType": null
          },
          {
            "amount": 16.95,
            "currencyCode": "USD",
            "pricingType": null
          }
        ],
        "seoFriendlyUrl": "\/books\/534363\/lost-ocean-by-johanna-basford\/9780143108993",
        "format": {
          "code": "TR",
          "description": "Trade Paperback"
        },
        "division": {
          "code": "62",
          "description": "Penguin Adult HC\/TR"
        },
        "imprint": {
          "code": "ID",
          "description": "Penguin Books"
        },
        "pages": 80,
        "age": {
          "code": null,
          "description": null
        },
        "grade": {
          "code": null,
          "description": "ALL"
        },
        "sgmt_desc": null,
        "subjects": [
          {
            "code": "JNF001000",
            "description": "Juvenile Nonfiction - Activity Books"
          },
          {
            "code": "JNF021000",
            "description": "JNF021000"
          },
          {
            "code": "ART016000",
            "description": "Art - Individual Artists - General"
          }
        ],
        "trim": "10 x 10",
        "formatFamily": "Paperback",
        "consumerFormat": "Paperback",
        "consumerImprint": "Penguin Books",
        "consumerImprintUri": "PenguinBooks",
        "saleStatus": "IN",
        "language": "E",
        "seriesNumber": null,
        "subseries": null,
        "editionType": null,
        "propertyName": null,
        "flags": [
          "INSIGHT"
        ],
        "workId": 534363,
        "frontlistiestSeq": null,
        "_links": [
          
        ],
        "_embeds": null
      }
    ],

1 Comment

  1. Daniel Hallman4 years ago

    How often are print scores recalculated?

    What are the min/max print scores?

    If scores are stored at the ISBN level, can the API consumer obtain print scores?

Please sign in to post a comment.