Pricing

from $2.00 / 1,000 results

Try for free

Go to Apify Store

Goodreads Scraper — Books, ISBN, Reviews & Authors

Try for free

Scrape Goodreads books, reviews, authors, lists, series and search results from any URL, ISBN-10/13 or text query. Book rows include ratings with a 1-5 star distribution, genres, ISBN, pages and series; reviews can be filtered by star range and language. Works with Apify MCP and the API.

Pricing

from $2.00 / 1,000 results

Rating

0.0

(0)

Developer

Khadin Akbar

Actor stats

Bookmarked

Total users

Monthly active users

18 hours ago

Last modified

Categories

Automation

MCP servers

You can access the Goodreads Scraper — Books, ISBN, Reviews & Authors programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.1",
    "x-build-id": "n0eYWoeDgVw6arqhn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~goodreads-all-in-one-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-goodreads-all-in-one-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/khadinakbar~goodreads-all-in-one-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-goodreads-all-in-one-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/khadinakbar~goodreads-all-in-one-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-goodreads-all-in-one-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "targets"
        ],
        "properties": {
          "targets": {
            "title": "Goodreads URLs or text queries",
            "type": "array",
            "description": "List of Goodreads URLs OR plain-text search queries. Each item can be a book URL (https://www.goodreads.com/book/show/40097951), author URL (/author/show/...), list URL (/list/show/...), series URL (/series/...), an ISBN-10 or ISBN-13 such as '9781250301697' (hyphens allowed), or a text query like 'sapiens yuval noah harari'. Auto-detected per item. NOT for private user shelves requiring login.",
            "items": {
              "type": "string"
            }
          },
          "resultsPerTarget": {
            "title": "Max results per target",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Cap on records returned per target. For books, this caps reviews collected (book metadata always returned); public book pages usually expose about 30 top reviews, so a book can return fewer. For lists and search, this caps entries. Defaults to 50. Maximum 500 per target to keep runs predictable. Not the total across all targets — applied per-target.",
            "default": 50
          },
          "scrapeReviews": {
            "title": "Scrape reviews for book targets",
            "type": "boolean",
            "description": "When true, opens each book URL and also pulls its reviews up to resultsPerTarget. When false, returns only the book metadata record (faster and cheaper). Has no effect on non-book targets. Defaults to true.",
            "default": true
          },
          "reviewsLanguage": {
            "title": "Reviews language filter",
            "enum": [
              "all",
              "en",
              "es",
              "fr",
              "de",
              "it",
              "pt",
              "nl",
              "ru",
              "ja",
              "zh",
              "ko"
            ],
            "type": "string",
            "description": "Limit reviews to a specific language. Use ISO 639-1 codes like 'en', 'es', 'fr', or 'all' for no filter. Defaults to 'all'. Filtering uses Goodreads' built-in language tag — reviews with no detected language pass through 'all' only.",
            "default": "all"
          },
          "minRating": {
            "title": "Minimum review rating",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Skip reviews below this star rating (1-5). Set to 1 to return every review. Use 4 for positive-only sentiment, 2 for negative-only when combined with maxRating. Applies only to review records, not books.",
            "default": 1
          },
          "maxRating": {
            "title": "Maximum review rating",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Skip reviews above this star rating (1-5). Set to 5 for no upper bound. Combine with minRating to slice review sentiment (e.g., min=1 max=2 returns only 1-2 star reviews). Applies only to review records.",
            "default": 5
          },
          "responseFormat": {
            "title": "Response shape for AI agents",
            "enum": [
              "concise",
              "detailed"
            ],
            "type": "string",
            "description": "Controls dataset item richness. 'concise' returns a token-efficient subset of fields (good for AI agents and recommendation systems). 'detailed' returns every parsed field including raw HTML descriptions and reviewer profile metadata. Defaults to 'detailed' for humans.",
            "default": "detailed"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify proxy settings. Residential proxies are recommended for reliability — Goodreads occasionally tightens anti-bot. Datacenter works for low volume. Defaults to residential.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Goodreads Scraper — Books, ISBN, Reviews & Authors OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Goodreads Scraper — Books, ISBN, Reviews & Authors from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Goodreads Scraper — Books, ISBN, Reviews & Authors API in Python

Goodreads Scraper — Books, ISBN, Reviews & Authors API in JavaScript

Goodreads Scraper — Books, ISBN, Reviews & Authors API through CLI

Goodreads Scraper — Books, ISBN, Reviews & Authors API

Goodreads Review Scraper 📚

shahidirfan/Goodreads-Review-Scraper

Instantly extract detailed book reviews, ratings, and reader feedback from Goodreads. Perfect for sentiment analysis, market research, and tracking literary trends. Get structured data on millions of books and user opinions efficiently. Unlock valuable reader insights today!

Shahid Irfan

5.0

(2)

Goodreads Review Scraper 📚

easyapi/goodreads-review-scraper

A powerful scraper that extracts detailed book reviews from Goodreads, including review text, ratings, user information, and engagement metrics. Perfect for book analysis, reader sentiment research, and literary trend tracking.

EasyApi

134

Goodreads Books, ISBN & Reviews Scraper API

thescrapelab/Apify-Goodreads-Scraper

Scrape Goodreads books, ISBN lookups, reviews, ratings, authors, series, genres, and book metadata from URLs or searches into clean JSON datasets.

Inus Grobler

146

📚 Goodreads Book Scraper

easyapi/goodreads-book-scraper

Extract comprehensive book data from Goodreads search results. Get detailed information about books, authors, ratings, and more. Perfect for market research, data analysis, and building book recommendation systems. 🔍📚

EasyApi

150

4.8

(4)

Goodreads Scraper

epctex/goodreads-scraper

Scrape goodreads.com for data on millions of books. Crawl book details for images, ISBN, author, description, title, buy links, number of reviews, page number, language, and all other details. You can specify search terms, filters, and much more.

epctex

676

5.0

(7)

AliExpress Scraper — Products, Reviews & Sellers

khadinakbar/aliexpress-all-in-one-scraper

Scrape AliExpress listings, product details and customer reviews from a keyword or URL. Prices in your ship-to country's currency, orders and ratings, plus specs, SKU variants and seller fields when product pages load. Reviews include text, country and photos.

Khadin Akbar

697

Goodreads Review Scraper 📖 - Faster & Cheaper

scrapestorm/goodreads-review-scraper---faster-cheaper

Collect Goodreads book reviews by URL 📚. Access detailed review data with user names, ratings ⭐, review text, and profile links 🌐. Ideal for analyzing book feedback, researching titles, and gathering data for projects or studies 📊. Perfect for book lovers, researchers, and literary professionals.

Storm_Scraper

5.0

(1)

Goodreads Reviews Scraper

scraped/goodreads-review-scraper

Scrape reviews for books on Goodreads

scraped

LinkedIn Profile Scraper + Email (No Cookies)

harvestapi/linkedin-profile-scraper

Extract detailed information from LinkedIn profiles in bulk, including complete work experience, education history, skills and more. No cookies or account required.

HarvestAPI

80K

4.6

(93)

Instagram Posts Scraper – Profiles, Hashtags & URLs

khadinakbar/instagram-posts-scraper

Extract Instagram posts from profiles, hashtags and post URLs, with caption, likes, comments, post type, media URLs, mentions, tagged users and date. No login; works with Apify MCP and the API.

Khadin Akbar