Endpoints
Books 9
Authors 2
What is the HAPI Books API?
HAPI Books is an API about books. It gives information about thousands of books from all around the world. Search by name, by genre, get the best books by year, and more!
HAPI Books API is available on the JoJ API marketplace. Subscribe with a single JoJ API key, call it through one gateway, and pay from one wallet — no separate account or contract with the provider.
HAPI Books API endpoints
- GET
/month/{year}/{month}Get the Top 15 most popular books in a Month of an Year
Provide the year and the month (between 1 and 12) and receive the 15 most popular books for that month.
- GET
/nominees/{genre}/{year}List of Nominated Books for a Genre in a Year
For a certain year and a genre, get the list of all nominated books to win an award.
- GET
/top/{year}Get the Awarded Books of a Year
Returns the list of the best books of a year by its winning category. Each returned book has its Name, Winning Category, Cover Image and more.
- GET
/search/{book_name}Search Books by Name
Giving a book name (where spaces must be replaced by '+') you will receive a list of corresponding books. This list can return up to 20 books related to the input. Each book has information such as Name, Authors, Cover image URL, Launched Year, and many more.
- GET
/week/{genre}/{number_results}Get Weekly Popular Books by Genre
Returns the most popular books from the last weeks given a genre.
- GET
/book/{book_Id}Get Book Information by Book Id
Giving its Id, this endpoint returns a lot of information about that book, such as Name, Published Date, Authors, Synopsis, and many more.
- GET
/book/{id}/reviewsGet Book Reviews
30 reviews with text, rating, likes, spoiler flag, date, reviewer info. total_count shows how many exist overall
- GET
/list/{id}Goodreads Listopia list
Goodreads has popular community lists (Best Books of the Decade, etc.)
- GET
/series/{id}Get Full series
All books in order with position, rating, ratings count, publication year
- GET
/author/{author_Id}Get Author Information by Id
Get a large variety of information of an Author such as the name, a brief biography, the list of books, and more.
- GET
/top_authorsGet the Most Popular Authors
Get the list of the most popular authors right now with a set of other relevant information.
Frequently asked questions about HAPI Books API
How do I authenticate my requests?
Every request must include your API key in the X-JoJAPI-Key header (e.g. X-JoJAPI-Key: jk_your_key_here). Alternatively, you can pass it as a Bearer token via Authorization: Bearer jk_your_key_here. Requests without a valid key tied to an active subscription will return a 401 Unauthorized or Subscription Not Found error.
What book data is available and how is it organized?
The API covers popular, award-nominated, and trending books and authors — including monthly and weekly top charts by genre (/month/{year}/{month}, /week/{genre}/{number_results}), yearly award winners and nominees (/top/{year}, /nominees/{genre}/{year}), book search and details (/search/{book_name}, /book/{book_Id}, /book/{id}/reviews), series info (/series/{id}), curated lists (/list/{id}), and author profiles (/author/{author_Id}, /top_authors).