Comment obtenir les évaluations Goodreads via l'API

Pour les amateurs de livres qui aiment un genre spécifique, ils vérifieront probablement les recommandations d'un ami plutôt que de suivre la liste des best-sellers. C'est pourquoi Amazon's Goodreads est un site marqué par des favoris pour les lecteurs assidus. C'est un endroit où vous pouvez trouver une vaste base de données de livres, recommandations et critiques rédigées par d'autres passionnés de livres..

Goodreads fournit également une API permettant aux développeurs de accéder à ses données et personnaliser davantage selon notre application. Nous verrons aujourd’hui comment récupérer des classements de livre Goodreads via l’API Goodreads à l’aide de l’ISBN ou du numéro international normalisé du livre, qui pourra ensuite être utilisé lors de l’affichage des informations sur le livre, par exemple sur votre site Web..

Pour commencer, connectez-vous ou inscrivez-vous avec un nom, un identifiant de messagerie et un mot de passe à Goodreads, puis accédez à https://www.goodreads.com/api/keys (lien). Entrez un nom d'application ou un nom d'entreprise et générez votre clé API. Ensuite, vérifiez votre compte à l'aide du courrier électronique reçu dans l'identifiant que vous avez entré..

Assurez-vous de consulter leurs Conditions d'utilisation pour les développeurs pour l'API. Ils ont également une liste de méthodes API dans leur page API. Certaines de ces méthodes nécessiteront une authentification OAuth, le reste ne fera que besoin de la clé de développeur, comme celui que nous verrons dans cet article.

Le type de réponse de ces méthodes varie, c’est soit uniquement en XML ou en JSON, soit une option permettant de choisir entre ces deux méthodes à l’aide de la touche format paramètre.

book.review_counts est une méthode de l'API Goodreads qui récupère toutes les statistiques de révision pour une liste de numéros ISBN de livres. Son type de réponse est JSON. L'URL de la demande ressemble à ceci: https://www.goodreads.com/book/review_counts.json .

Il faut quatre paramètres:

clé, qui est la clé de développeur
isbns - un tableau ou une chaîne séparée par des virgules des ISBN des livres que nous voulons, les statistiques de révision de
format - le format de la réponse (bien que, en toute honnêteté, je ne sache pas vraiment pourquoi celle-ci existe, car la réponse sera toujours en JSON. Des plans pour les implémentations futures?)
rappeler, la fonction qui va conclure la réponse JSON

Prenons les deux livres. Head First Java, Première édition (ISBN: 0596009208) et JavaScript: The Good Parts, 1ère édition (ISBN: 0596517742) et obtenez leurs statistiques de révision. L'URL de la requête est comme ceci:

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

Et le réponseTexte après l'embellissement ressemble à ceci.

"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, de" avis ". : 4430, "reviews_count": 8921, "text_reviews_count": 363, "work_ratings_count": 4990, "work_reviews_count": 9821, "work_text_reviews_count": 381, "moyennement": "4.22"]

Si vous voulez la cote du Head First Java, première édition livre, c'est dans myJSON.books [0] .average_rating. le ratings_count et reviews_count les clés dans les objets représentent le nombre total d’évaluations et d’évaluations effectuées pour cette édition particulière du livre..

De même , text_reviews_count représente le nombre total de critiques textuelles de l'édition particulière du livre. Tandis que work_ratings_count, work_reviews_count et work_text_reviews_count représente le total des notes, des critiques et des critiques textuelles de toutes les éditions.

Si vous cliquez sur Rating Details of JavaScript: les bonnes parties (1ère édition) dans Goodreads ça va afficher cette.

Vous pouvez utiliser toutes ces informations supplémentaires si vous le souhaitez ou simplement afficher un nombre d'étoiles pour le livre à l'aide de la touche note moyenne valeur clé.

Remarque: Selon la documentation de l'API, “L'API Goodreads vous donne un accès complet aux métadonnées appartenant à Goodreads, mais ne vous donne pas un accès complet aux métadonnées de livres fournies par des tiers tels qu'Ingram. Les images de couverture de livre, les descriptions et autres données provenant de sources tierces peuvent être exclues, car nous ne sommes pas autorisés à distribuer ces données via notre API..”

Une fois que vous avez préparé les couvertures et les descriptions du livre, vous pouvez afficher les informations sur le livre un peu comme ci-dessous..