# Using the LibraryThing API from C#

- Link: https://saguiitay.com/using-the-librarything-api-from-c/
- Published: 2014-09-24T13:19:00+03:00
- Author: Itay

If you are not familiar with [LibraryThing](http://www.librarything.com/), go ahead
and visit their website – it’s probably the most comprehensive books
collection 
in the web.

LibraryThing provide several APIs, one of them a RESTful API, which can be invoked
from C# relatively easily. In this post I’ll describe how to use that API.

First, you need to get a Developer Key. You can do that here: [http://www.librarything.com/services/keys.php](http://www.librarything.com/services/keys.php)

Here’s the most important thing you need:

    ```notranslate
    private const string CollectionByUser = "http://www.librarything.com/api_getdata.php?userid={0}&resultsets=books&max=9999&booksort=title&responseType=json&key=" + DevKey;
    private const string WorkUrlByISBN = "http://www.librarything.com/services/rest/1.1/?method=librarything.ck.getwork&isbn={0}&apikey=" + DevKey;
    private const string WorkUrlById = "http://www.librarything.com/services/rest/1.1/?method=librarything.ck.getwork&id={0}&apikey=" + DevKey;
    private const string WorkUrlByLCCN = "http://www.librarything.com/services/rest/1.1/?method=librarything.ck.getwork&lccn={0}&apikey=" + DevKey;
    private const string WorkUrlByOCLC = "http://www.librarything.com/services/rest/1.1/?method=librarything.ck.getwork&oclc={0}&apikey=" + DevKey;
    private const string AuthorUrlByCode = "http://www.librarything.com/services/rest/1.1/?method=librarything.ck.getauthor&authorcode={0}&apikey=" + DevKey;
    private const string ImageUrl = "http://covers.librarything.com/devkey/" + DevKey + "/{0}/isbn/{1}";
    ```

These URLs allow you to retrieve information from LibraryThing, by providing a Developer
Key, and the details about which data you want to get:

 * CollectionByUser: Retrieve the list of books that a user has added in his collection.
   Notice that the URL returns the books result-set (you can also get the users’
   ratings, reviews and tags).
 * WorkUrlByISBN: Retrieve information about a specific work (book), provided the
   book’s ISBN.
 * WorkUrlById: Retrieve information about a specific work (book), provided the 
   book’s LibraryThing ID.
 * WorkUrlByLCCN: Retrieve information about a specific work (book), provided the
   book’s LCCN (Library of Congress Control Number).
 * WorkUrlByOCLC: Retrieve information about a specific work (book), provided the
   book’s OCLC (Online Computer Library Center).
 * AuthorUrlByCode: Retrieve information about a specific author, provided the author’s
   LibraryThing author-code.
 * ImageUrl: Retrieve the cover image of a book, provided the book’s ISBN, and the
   requested image size (

Now, if you want to see some code, we’ll start by creating an HttpClient instance:

    ```notranslate
    _handler = new HttpClientHandler();
    if (_handler.SupportsAutomaticDecompression)
        _handler.AutomaticDecompression = DecompressionMethods.Deflate | DecompressionMethods.GZip;
    _httpClient = new HttpClient(_handler);
    ```

To get a book’s details, we’ll make the following call to the LibraryThing API:

    ```notranslate
    var url = string.Format(WorkUrlByISBN, isbn);
    string content;
    try
    {
        var response = await httpClient.GetAsync(url).ConfigureAwait(false);
        if (!response.IsSuccessStatusCode)
            return null;
        content = await response.Content.ReadAsStringAsync().ConfigureAwait(false);
    }
    catch (Exception)
    {
        return null;
    }
    ```

You can then parse the result into a workable object model. The model is a bit complex,
so I’ve posted it as Gist: [https://gist.github.com/saguiitay/be3868dae2efb12802a2](https://gist.github.com/saguiitay/be3868dae2efb12802a2)

One method in that Gist requires some explanation – the parsing of the Xml returned
from LibraryThing is not straight forward – you need
to decode it, in order for 
some Xml entities to be processed correctly. For that, I’ve created an extension
method forString ([https://gist.github.com/saguiitay/be3868dae2efb12802a2#file-stringextensions-cs](https://gist.github.com/saguiitay/be3868dae2efb12802a2#file-stringextensions-cs)),
that replaced the XmlEntities into their equivalent character.

All in all, LibraryThing provides an extensive API to their data, which is mostly
painless to work with, and provide detailed and valuable information. While the 
app is not longer available to download, tou can see the results of using LibraryThing
to retrieve information about books and authors in my Windows Phone App “Library”
here: [http://www.windowsphone.com/s?appid=01f350f2-01d1-4210-a83b-9874b71e9496](http://www.windowsphone.com/s?appid=01f350f2-01d1-4210-a83b-9874b71e9496)

### _Related_
