Question 1

How do I authenticate my requests?

Accepted Answer

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.

Question 2

What book data is available and how is it organized?

Accepted Answer

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).

HAPI Books

Frequently Asked Questions