{"repo":"garethbjohnson/gutendex","free":true,"listed":false,"github":"https://github.com/garethbjohnson/gutendex","clone":"git clone https://github.com/garethbjohnson/gutendex.git","description":"Web API for Project Gutenberg ebook metadata","language":"Python","stars":374,"topics":["gutenberg","api"],"license":"MIT","category":"api-integrations-sdks","readme_excerpt":"Gutendex ======== Gutendex is a simple, self-hosted web API for serving book catalog information from Project Gutenberg, an online library of free ebooks. Try it at gutendex.com . Why? ---- Project Gutenberg can be a useful source of literature, but its large size makes it difficult to access and analyse it on a large scale. Thus, an API of its catalog information is useful for automating these tasks. How does it work? ----------------- Gutendex uses Django to download catalog data and serve it in a simple JSON REST API. Project Gutenberg has no such public API of its own, but it publishes nightly archives of complicated XML files. Gutendex downloads these files, stores their data in a database, and publishes the data in a simpler format. Installation ------------ See the installation guide. API --- When your server is up and running, you should see a home page that says \"Gutendex\" at the root URL (e.g. http://localhost:8000 by default when using manage.py to serve on your local machine). You should run your own server, but you can test queries at gutendex.com . Lists of Books Lists of book information in the database are queried using the API at /books (e.g. gutendex.com/books ). Book data will be returned in the JSON format where results is an array of 0-32 book objects, next and previous are URLs to the next and previous pages of results, and count in the total number of books for the query on all pages combined. By default, books are ordered by popularity, determined by t","default_branch":null,"files":null,"tree":[],"storefront":"/r/garethbjohnson","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/garethbjohnson/gutendex/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}