Pricing

from $2.99 / 1,000 results

Goodreads Review Scraper

📚 Goodreads Review Scraper extracts insightful book reviews from Goodreads for faster research & analysis. 🚀 Ideal for market insights, sentiment analysis, and catalog optimization. ⚡ Automated scraping with clean, usable data.

Pricing

from $2.99 / 1,000 results

Rating

0.0

(0)

Developer

ScrapAPI

Actor stats

Bookmarked

Total users

Monthly active users

9 days ago

Last modified

Categories

Automation

Developer tools

Other

You can access the Goodreads Review Scraper 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 Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "MzrdbQpYGKnavPUXV"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapapi~goodreads-review-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapapi-goodreads-review-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/scrapapi~goodreads-review-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapapi-goodreads-review-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/scrapapi~goodreads-review-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapapi-goodreads-review-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": [
          "urls"
        ],
        "properties": {
          "urls": {
            "title": "📚 Book URLs",
            "type": "array",
            "description": "Paste one or more Goodreads book links. **Tip:** you can paste just the number from the URL (e.g. `26032825`) — we’ll fix the link for you. 🌟",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Max reviews per book",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "How many reviews to collect **for each** book in your list. (Example: 50 here × 3 books = up to 150 rows.) 📊",
            "default": 20
          },
          "filtersAndOptions": {
            "title": "⚙️ Filters & sorting",
            "type": "object",
            "description": "🎛️ **Optional:** open this section to change sort order, language, and which edition reviews come from. Leave defaults for a quick start! 👇",
            "properties": {
              "sortBy": {
                "title": "📊 Sort reviews by",
                "type": "string",
                "description": "⭐ **Popular** — most helpful first · 🆕 **Newest** — newest first · 📜 **Oldest** — oldest first",
                "editor": "select",
                "enum": [
                  "popular",
                  "newest",
                  "oldest"
                ],
                "default": "popular"
              },
              "languageCode": {
                "title": "🌍 Review language",
                "type": "string",
                "description": "🌐 **All languages** — no filter · Or choose one language — reviews are filtered to match. 🗣️",
                "editor": "select",
                "enum": [
                  "all",
                  "en",
                  "bn",
                  "fr",
                  "de",
                  "es",
                  "it",
                  "pt",
                  "ru",
                  "ja",
                  "ko",
                  "zh",
                  "ar",
                  "hi",
                  "nl",
                  "pl",
                  "tr",
                  "vi",
                  "id",
                  "th"
                ],
                "enumTitles": [
                  "All languages",
                  "English",
                  "Bengali",
                  "French",
                  "German",
                  "Spanish",
                  "Italian",
                  "Portuguese",
                  "Russian",
                  "Japanese",
                  "Korean",
                  "Chinese",
                  "Arabic",
                  "Hindi",
                  "Dutch",
                  "Polish",
                  "Turkish",
                  "Vietnamese",
                  "Indonesian",
                  "Thai"
                ],
                "default": "all"
              },
              "reviewEdition": {
                "title": "📖 Edition scope",
                "type": "string",
                "description": "📚 **All editions** — reviews for the whole work · 📕 **This book only** — reviews for this edition. 🎯",
                "editor": "select",
                "enum": [
                  "ALL",
                  "only_this_book"
                ],
                "default": "ALL"
              }
            }
          },
          "proxyConfiguration": {
            "title": "🔒 Proxy (optional)",
            "type": "object",
            "description": "🌐 **Optional.** Turn on Apify Proxy if you need extra reliability. If something blocks a run, we’ll try smarter routing automatically — you stay focused on the results. ✨"
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Goodreads Review Scraper 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 Review Scraper 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 Review Scraper API in Python

Goodreads Review Scraper API in JavaScript

Goodreads Review Scraper API through CLI

Goodreads Review Scraper API

Goodreads Review Scraper

scraperx/goodreads-review-scraper

ScraperX

Goodreads Review Scraper

scraperforge/goodreads-review-scraper

📚 Goodreads Review Scraper extracts insightful book reviews, ratings, and metadata fast. ⚡ Ideal for research, analytics, and content discovery. Automate review collection with an easy, reliable workflow—turn Goodreads data into actionable insights! ✅

ScraperForge

Goodreads Review Scraper

simpleapi/goodreads-review-scraper

📚 Goodreads Review Scraper extracts ratings, reviews, dates, reviewers & metadata from Goodreads book pages at scale. 🔍 Export clean data to CSV/JSON for sentiment, market research & content analysis. 🚀 Ideal for authors, publishers, researchers & SEO teams.

SimpleAPI

Goodreads Review Scraper

scrapio/goodreads-review-scraper

📚 Goodreads Review Scraper extracts book reviews, star ratings, reviewer profiles, dates, helpful votes, shelves & comments from Goodreads. 🔍 Clean, structured data for sentiment analysis, market research & book marketing. 📊 Export to CSV/JSON. 🚀 Ideal for authors, publishers & analysts.