haileyhoyat/celebrity-book-clubs-api

Hello, this is the API for the BList. This API aggregates books from various book lists.

NOTE: Most recent scrape for all book lists is 01-08-2024

NOTE: As of 01/01/2024, the API production endpoints are a bit buggy. For now, it is recommended that you run the API locally.

- API production endpoint: https://celebrity-book-clubs-api-git-main-hails-projects-2a5888c5.vercel.app

- API production endpoint for all book lists: https://celebrity-book-clubs-api-git-main-hails-projects-2a5888c5.vercel.app/books

- API production endpoint for a specific book list: https://celebrity-book-clubs-api-git-main-hails-projects-2a5888c5.vercel.app/books/{book_list}

The book_lists that are currently being scraped are:

• reesewitherspoon: Book club for Reese Witherspoon (https://reesesbookclub.com/article/4eRlfCOXueqPrm6ZnQpzwl)
• goodmorningamerica: Book club for Good Morning America (https://www.goodmorningamerica.com/culture/story/shop-gma-book-club-picks-list--81520726)
• todayshow: Book club for The Today Show (hosted by Jenna Bush Hager) (https://www.today.com/shop/read-jenna-book-club-list-today-s-jenna-bush-hager-t164652)
• nytcombinedprintandebookfiction: NYT best sellers fiction list for print and ebook (October 16, 2022 - present) (https://www.nytimes.com/books/best-sellers/) (Note: This book list is scraped using the NYT Book API and requires an API key from them: https://developer.nytimes.com/docs/books-product/1/overview)
• nytcombinedprintandebooknonfiction: NYT best sellers nonfiction list for print and ebook (October 16, 2022 - present) (https://www.nytimes.com/books/best-sellers/) (Note: This book list is scraped using the NYT Book API and requires an API key from them: https://developer.nytimes.com/docs/books-product/1/overview)
• nationalbookawardsfiction: National Book Awards winners for the category 'Fiction' (https://en.wikipedia.org/wiki/List_of_winners_of_the_National_Book_Award)
• nationalbookawardsnonfiction: National Book Awards winners for the category 'Nonfiction' (https://en.wikipedia.org/wiki/List_of_winners_of_the_National_Book_Award)
• nationalbookawardspoetry: National Book Awards winners for the category 'Poetry' (https://en.wikipedia.org/wiki/List_of_winners_of_the_National_Book_Award)
• nationalbookawardsyoungpeoplesliterature: National Book Awards winners for the category 'Young People's Literature' (https://en.wikipedia.org/wiki/List_of_winners_of_the_National_Book_Award)
• oprahwinfrey: Book club for Oprah Winfrey (https://www.oprah.com/book/oprahs-book-club-let-us-descend-by-jesmyn-ward?editors_pick_id=26790)

To run this API locally:

1. clone the repo 'git clone https://github.com/haileyhoyat/celebrity-book-clubs-api.git'.
2. Run the command 'npm install && npm start'.

The API returns books from each book list in a json format.

Example json() response object:

{

"book_list": "todayshow",

"title": "The Sun Sets in Singapore",

"author": "Kehinde Fadipe",

"date": {

  "month": "November",

  "year": "2023"

}    

}

celebrity-book-clubs-api's Issues

Buggy production endpoints.

The production API endpoints are a bit buggy in that the data won't load immediately; the data will eventually load but it takes a couple of "Empty cache and Hard reload"s to do it. I think the issue is that it's waiting for the response from each url, and coordinating those responses are tricky.