users/{id}/user_content

Returns the list of user contributed content for a given user, specified by user ID.

Resource URL

https://api.bibliocommons.com/v1/users/{id}/user_content

Request Parameters

Parameter Type Description Default Required?
id String The user ID. N/A Yes

Response Fields

Response Field Type Description Returned
title Object The title that this content is associated with.  See titles Response Fields. Always

 

content

 

Object[]

 

The list of content created by this user associated with this title.

 

Sometimes

content_type Object The type of user content, for example comment, rating, tag, etc. Always
   id String The ID of the content type.
      name String The user-friendly name of the content type.
  content_data variable The content data.  The Type returned depends on the value of content_type.  For example if content_type is comment, the return type will be String.  If content_type is rating, the return type will be Number.  If content_type is more complex, the data will be returned as an Object with multiple fields. Always
  updated String The date and time that the content was last updated. Always

Example Request

GET https://api.bibliocommons.com/v1/users/1313142/user_content?api_key={key}

Response:

{
  "count": 68,
  "limit": 10,
  "pages": 7,
  "page": 1,
  "user_content": [
    {
      "title": {
        "id": "612436321",
        "title": "Harry Potter and the Deathly Hallows",
        "format": {
          "id": "BK",
          "name": "Book" 
        }
        "details_url": "http://examplepl.bibliocommons.com/item/show/612436321", 
        "authors": [
          {
            "name": "Rowling, J. K."
          }
        ]
        "isbns": [
          "9781551929767",
          "9781408810606",
          "1408810603",
        ]
      }
      "content": [
        {
          "content_type": {
            "id": "comment",
            "name": "Comment"
          },
          "content_data": "A satisfying finish to a great series.  Obviously the kids will love it, but it's an entertaining 

read for adults as well.",
          "timestamp": "2011-09-19T23:07:08Z"
        },
        {
          "content_type": {
            "id": "rating",
            "name": "Rating"
          }
          "content_data": 4.0,
          "timestamp": "2011-09-19T23:07:08Z"
        }
      ]
    },
    {
      "title": {
        "id": "701925235",
        "title": "Toy Story",
        "format": {
          "id": "DVD",
          "name": "DVD"
        }, 
        "details_url": "http://examplepl.bibliocommons.com/item/show/701925235",
        "upcs": [
          "786936798333"
        ]
      }
    }, 
    {
      "title": {
        "id": "695532321",
        "title": "What the Dog Saw",
        "format": {
          "id": "BOOK_CD",
          "name": "Audiobook CD"
        },
        "details_url": "http://examplepl.bibliocommons.com/item/show/695532321",
        "authors": [
          {
            "name": "Gladwell, Malcolm"
          }
        ],
        "isbns": [
          "1600249159"
        ]
      },
      "content": [
        {
          "content_type": {
            "id": "rating",
            "name": "Rating"
          },
          "content_data": 4.0,
          "timestamp": "2011-06-05T02:36:36Z"
        }
      ]
    }
    ...
  ]
}