Cómo obtener calificaciones de Goodreads a través de API

Para los amantes de los libros que tienen un gusto por un género específico, probablemente verifiquen la recomendación de un amigo antes que seguir una lista de los más vendidos. Esta es la razón por la cual Goodreads de Amazon es un sitio marcado para lectores ávidos. Es un lugar donde puedes encontrar una extensa base de datos de libros, recomendaciones y reseñas de otros amantes de los libros.

Goodreads también proporciona una API para que los desarrolladores accedan a sus datos y los personalicen aún más según nuestra aplicación. Hoy veremos cómo recuperar calificaciones de libros de Goodreads a través de la API de Goodreads utilizando el ISBN o el Número de libro estándar internacional, que luego se pueden usar al mostrar información de libros y tal en su sitio web.

Para comenzar, inicie sesión o regístrese con un nombre, id. De correo electrónico y contraseña en Goodreads y vaya a https://www.goodreads.com/api/keys (enlace). Ingrese el nombre de la aplicación y el nombre de la compañía y genere su clave API. Luego verifique su cuenta a través del correo electrónico recibido en la identificación de correo electrónico que ingresó.

Asegúrese de consultar las Condiciones del servicio para desarrolladores de la API. También tienen una lista de métodos API en su página API, algunos de esos métodos requerirán autenticación OAuth, el resto solo necesitará la clave del desarrollador, como la que veremos en esta publicación.

El tipo de respuesta de esos métodos varía, ya sea solo en XML o JSON, o una opción para elegir entre estos dos utilizando el parámetro de format .

book.review_counts es un método API de Goodreads que book.review_counts todas las estadísticas de revisión para una lista de ISBN de libros. Su tipo de respuesta es JSON. La URL de solicitud es la siguiente: https://www.goodreads.com/book/review_counts.json.

Toma cuatro parámetros:

• key, que es la clave del desarrollador
• isbns : una matriz o cadena separada por comas simples de los ISBN de los libros que queremos que revisen las estadísticas de
• format : el formato de la respuesta (aunque honestamente, no estoy seguro de por qué existe esta, ya que la respuesta siempre será en JSON. ¿Planes para futuras implementaciones?)
• callback, la función que cerrará la respuesta JSON

Tomemos los dos libros; Head First Java, Primera edición (ISBN: 0596009208) y JavaScript: The Good Parts, 1ª edición (ISBN: 0596517742) y obtener sus estadísticas de revisión. La URL de solicitud es así:

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

Y el texto de responseText después del embellecimiento se ve así.

 {"libros": [{"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"}]} 

Si desea la calificación del libro de Head First Java, Primera Edición, está en myJSON.books[0].average_rating . Las claves ratings_count y reviews_count en los objetos representan la cantidad total de calificaciones emitidas y revisiones realizadas para esa edición en particular del libro.

Del mismo modo, text_reviews_count representa el total de comentarios de solo texto de la edición en particular del libro. Mientras que work_ratings_count, work_reviews_count y work_text_reviews_count representan las calificaciones totales, las revisiones y las reseñas de solo texto de todas las ediciones.

Si hace clic en Detalles de la calificación de JavaScript: Las buenas partes (1.ª edición) en Goodreads, se mostrará esto.

Puede usar toda esa información de revisión adicional si desea o simplemente mostrar una calificación con estrellas para el libro utilizando el valor de la clave average_rating .

Nota : De acuerdo con la documentación de la API, "La API de Goodreads le brinda acceso completo a los metadatos propiedad de Goodreads, pero no le da acceso completo para reservar metadatos proporcionados por terceros, como Ingram. Es posible que se excluyan las imágenes de la portada del libro, las descripciones y otros datos de fuentes de terceros, ya que no tenemos una licencia para distribuir estos datos a través de nuestra API ".

Una vez que haya preparado las portadas y descripciones de los libros, puede mostrar la información del libro como se muestra a continuación.