titles

Returns a list of titles from a given library catalog and matching a given set of search criteria, with basic information about each title.

Resource URL

https://api.bibliocommons.com/v1/titles

Request Parameters

Parameter Type Description Default Required?
q String The query string to search for. N/A Yes
library String The ID of the library catalog to search.   N/A Yes
search_type String The type of search to perform.  Supported search types are keyword, author, subject, tag, series, and custom. keyword No

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. Sometimes
id String The ID of the availability status.
name String The user-friendly name of the availability status.
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

Example Request

GET https://api.bibliocommons.com/v1/titles?library=examplepl&q=Harry+Potter&api_key={key}

Response:

{
  "count": 122,
  "limit": 10,
  "pages": 13,
  "page": 1,
  "titles": [
    {
      "id": "754151321",
      "title": "Harry Potter and the Deathly Hallows",
      "sub_title": "Part 1",
      "format": {
        "id": "DVD",
        "name": "DVD"
      }
      "details_url": "http://examplepl.bibliocommons.com/item/show/754151321",
      "availability": {
        "id": "AVAILABLE",
        "name": "Available"
      }
      "upcs": [
        "883929184507"
      ]
    },
    {
      "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",
      ]
    },
    ... 
  ]
}