titles/{id}

Returns detailed information about a given title from a library catalog, specified by title ID.

Resource URL

https://api.bibliocommons.com/v1/titles/{id}

Request Parameters

Parameter Type Description Default Required?
id String The ID of the title to return. N/A Yes

Response Fields

Response Field Type Description Returned Link To *
id String The title ID. Always
title String The title of the title. Always details_url
sub_title String The subtitle of the title, if one exists. Sometimes
format Object The format of the title. Always
  id String The ID of the format.
   name String The user-friendly name of the format.
details_url String The URL for the title details page in the catalog. Always
availability Object The current availability status of the title, across all copies and locations. (Might be null) Sometimes
  id String The ID of the availability status. Sometimes
  name String The user-friendly name of the availability status. Sometimes
authors Object[] The list of authors. Sometimes
  name String The author name.
isbns String[] The list of all ISBN identifiers associated with the title. Sometimes
upcs String[] The list of all UPC identifiers associated with the title. Sometimes
call_number String The call number associated with the title.  Note that the call number for some copies may be different. Sometimes
description String A description of the title. Sometimes
additional_contributors Object[] The list of additional contributors. Sometimes
   name String The full name of the additional contributor.
publishers Object[] The list of publishers. Sometimes
   name String The full publisher name.
pages Integer The number of pages. Sometimes
series Object[] Series information if this title is part of a series. Sometimes
   name String The series name.
   number String The number of this title within the series.
edition String The specific edition represented by this title. Sometimes
primary_language Object The primary language of the title. Sometimes
  name String The user-friendly name of the pimary language.
languages Object[] The list of all languages for the title. Sometimes
  name String Ther user-friendly name of the language.
contents String[] The table of contents. Sometimes
performers Object[] The list of performers in the title. Sometimes
  name String The full name of the performer.
suitabilities Object[] A list of audience suitabilities. Sometimes
    name String The audience suitability.
notes String[] The list of all notes associated with the title. Sometimes
statement_of_responsibility String The statement of responsibility. Sometimes
physical_description String[] The list of all physical descriptions of the title. Sometimes
publication_date String The date of publication (often a year). Sometimes

Example Request

GET https://api.bibliocommons.com/v1/titles/612436321?api_key={key}

Response:

{
  "title": {
    "id": "612436321",
    "title": "Harry Potter and the Deathly Hallows",
    "format": {
      "id": "BK",
      "name": "Book"
    }, 
    "details_url": "http://examplepl.bibliocommons.com/item/show/612436321",
    "availability": {
      "id": "AVAILABLE",
      "name": "Available"
    }, 
    "authors": [
      {
        "name": "Rowling, J. K."
      }
    ],
    "isbns": [
      "9781551929767",
      "9781408810606",
      "1408810603"
    ],
    "call_number": "J FIC Rowli",
    "description": "Seventh-year Hogwarts student Harry Potter must find the strength to locate and destroy Voldemort's remaining Horcruxes as he follows the inexorable path laid out for him.",
    "publishers": [
      {
        "name": "Bloomsbury"
      }
    ],
    "pages": 607,
    "series": [
      {
        "name": "Harry Potter series",
        "number": "7"
      }
    ],
    "primary_language": {
      "name": "English"
    },
    "languages": [
      {
        "name": "English"
      }
    ], 
    "notes": [
      "Published also: Vancouver : Raincoast books, 2007"
    ],
    "statement_of_responsibility": "J.K. Rowling",
    "physical_description": [
      "607 p. --"
    ]
  }
}