Come ottenere valutazioni di Goodreads tramite API

Per gli amanti dei libri che amano uno specifico genere, probabilmente controlleranno le raccomandazioni di un amico piuttosto che seguire una lista di bestseller. Questo è il motivo per cui Amazon Goodreads è un sito preferito dai lettori accaniti. È un posto in cui puoi trovare un ampio database di libri, raccomandazioni e recensioni di altri amanti dei libri.

Goodreads fornisce anche un'API per gli sviluppatori per accedere ai propri dati e personalizzarli ulteriormente secondo la nostra applicazione. Oggi vedremo come recuperare le valutazioni del libro Goodreads tramite l'API Goodreads utilizzando il codice ISBN o il numero di libro standard internazionale, che può essere utilizzato in futuro durante la visualizzazione delle informazioni sui libri e simili sul tuo sito web.

Per iniziare, accedi o registrati con un nome, un ID e una password per Goodreads e vai su https://www.goodreads.com/api/keys (link). Immettere il nome dell'applicazione e il nome dell'azienda e generare la chiave API. Quindi verifica il tuo account tramite l'e-mail ricevuta nell'ID e-mail che hai inserito.

Assicurati di consultare i Termini di servizio per gli sviluppatori per l'API. Hanno anche un elenco di metodi API nella loro pagina API, alcuni di questi metodi richiedono l'autenticazione OAuth, al resto servirà solo la chiave sviluppatore, come quella che vedremo in questo post.

Il tipo di risposta di questi metodi varia, è solo in XML o JSON, o un'opzione per scegliere tra questi due utilizzando il parametro format .

book.review_counts è un metodo API Goodreads che recupera tutte le statistiche di revisione per un elenco di ISBN di libri. Il suo tipo di risposta è JSON. L'URL della richiesta è simile a questo: https://www.goodreads.com/book/review_counts.json.

Ci vogliono quattro parametri:

• key, che è la chiave sviluppatore
• isbns : una matrice o una singola stringa separata da virgole dei codici ISBN dei libri di cui vogliamo le statistiche di revisione
• format - il formato della risposta (anche se in tutta onestà, non sono davvero sicuro del motivo per cui esiste, dal momento che la risposta sarà sempre in JSON.) Piani per implementazioni future?)
• callback, la funzione che avvolgerà la risposta JSON

Prendiamo i due libri; Head First Java, Prima edizione (ISBN: 0596009208) e JavaScript: The Good Parts, 1a edizione (ISBN: 0596517742) e ottieni le loro statistiche di revisione. L'URL della richiesta è come questo:

 https://www.goodreads.com/book/review_counts.json?key={apikey}&isbns=0596009208, 0596517742 

E la responseText dopo l'abbellimento assomiglia a questo.

 {"books": [{"id": 231262, "isbn": "0596009208", "isbn13": "9780596009205", "ratings_count": 1842, "reviews_count": 3599, "text_reviews_count": 124, "work_ratings_count" : 2016, "work_reviews_count": 3943, "work_text_reviews_count": 136, "average_rating": "4.16"}, {"id": 2998152, "isbn": "0596517742", "isbn13": "9780596517748", "ratings_count" : 4430, "reviews_count": 8921, "text_reviews_count": 363, "work_ratings_count": 4990, "work_reviews_count": 9821, "work_text_reviews_count": 381, "average_rating": "4.22"}]} 

Se desideri la valutazione del libro Head First Java, First Edition, è in myJSON.books[0].average_rating . Le chiavi ratings_count e reviews_count negli oggetti rappresentano il numero totale di voti espressi e recensioni fatte per quella particolare edizione del libro.

Allo stesso modo, text_reviews_count rappresenta le text_reviews_count totali di solo testo della particolare edizione del libro. Mentre work_ratings_count, work_reviews_count e work_text_reviews_count rappresentano le valutazioni totali, recensioni e recensioni di solo testo di tutte le edizioni.

Se si fa clic su Rating Dettagli di JavaScript: The Good Parts (1st Edition) in Goodreads verrà visualizzato questo.

Puoi utilizzare tutte le informazioni di revisione aggiuntive se desideri o semplicemente visualizzare una valutazione a stelle per il libro utilizzando il valore della chiave average_rating .

Nota : in base alla documentazione API, "L'API Goodreads ti dà pieno accesso ai metadati di proprietà di Goodreads, ma non ti dà pieno accesso ai metadati di libri forniti da terze parti come Ingram. Potrebbero essere escluse le immagini di copertina del libro, le descrizioni e altri dati da fonti di terze parti, perché non abbiamo una licenza per distribuire questi dati tramite la nostra API. "

Una volta che hai preparato le copertine e le descrizioni dei libri, puoi visualizzare le informazioni del libro come in seguito.