Aller au contenu principal
État du réseau
Se connecter
Piloterr
Retour à la bibliothèque

API Goodreads Book

Lisez un livre Goodreads par l'identifiant numérique de la recherche, par exemple 44767458 pour Dune.

Actif2 crédits = 1 requêteGET/v2/goodreads/book
Essayer l'endpoint gratuitementPiloterr

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

Lit une page livre Goodreads. Passez l'id numérique de la recherche, ou une URL /book/show/. La réponse est un objet plat. 44767458 est Dune de Frank Herbert, le même id et le même titre que la carte dune.

La carte de recherche stocke un plancher abrégé. Cet endpoint stocke les ratings_count et reviews_count exacts de la page livre.

DémarrageLink to Démarrage

GET https://api.piloterr.com/v2/goodreads/book?query=44767458
GET https://api.piloterr.com/v2/goodreads/book?query=https://www.goodreads.com/book/show/44767458

GET et POST prennent le même query. Le dossier Dune comprend l'ISBN 9780593099322, 658 pages, le format Hardcover et la série Dune #1.

ParamètresLink to Paramètres

Paramètre Obligatoire Exemple
query oui 44767458

query est obligatoire. Un entier est l'id. Une URL doit être sur goodreads.com et contenir /book/show/. Un titre, une URL de recherche ou un autre hôte renvoie 400.

Champs de réponseLink to Champs de réponse

Champ Type Sens
id string Id, par exemple 44767458
title string Titre
url string URL /book/show/{id}
series string ou null Texte du lien série, par exemple Dune #1
authors array Auteurs. Dune liste Frank Herbert
rating number ou null Note moyenne
ratings_count number ou null Nombre exact de notes
reviews_count number ou null Nombre exact de critiques
image string ou null Couverture
book_format string ou null Format, par exemple Hardcover
pages number ou null Nombre de pages
language string ou null Langue
isbn string ou null ISBN
genres array Genres affichés
published string ou null Date de première publication
awards array Prix. Tableau vide s'il n'y en a pas
description string ou null Résumé, sans le contrôle "more" final

Pas d'enveloppe results. La chaîne de série peut différer de la carte de recherche pour le même id.

Cas d'usageLink to Cas d'usage

  • Enregistrer l'ISBN 9780593099322, 658 pages et Hardcover pour la clé 44767458.
  • Conserver le compte exact de notes après qu'une carte a stocké le plancher 1700000.
  • Lire les genres et les lignes Hugo et Nebula imprimées pour Dune.

Codes d'erreurLink to Codes d'erreur

Code Sens
400 Requête vide, jeton non numérique, ou domaine hors goodreads.com
401 Clé API absente
404 Pas de page livre pour cet id
500 Échec de la récupération

Endpoints liésLink to Endpoints liés

Goodreads Search

API associées

Étendez vos capacités data avec ces outils complémentaires.

Tout voir
Goodreads Search/v2/goodreads/search

Recherchez des livres Goodreads par mot-clé. pagination.next est une URL de recherche Goodreads pour la page suivante.

GET2 crédits = 1 requêteActif

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus
Commencer gratuitement (+500 crédits)PiloterrParler à un expert