ParseForge Scrapers

Goodreads Quotes Scraper

parseforge/goodreads-quotes-scraper

Other

Searches Goodreads quotes by keyword and returns each quote as a flat row with its text, author, book title, tags, and like count. No login required.

Run this scraper See the API call
Total users
3
Monthly active
0
Total runs
34
Bookmarked
0
Rating
Not rated yet
Last modified
12 days ago

Overview

ParseForge

Goodreads Quotes Scraper

Scrape Goodreads quotes by any search keyword and collect up to a million per run. Each quote includes the full text, author name, book title, tags, and like count. No login required. Export to CSV, JSON, Excel, or XML.

Goodreads has no official quotes API, and scraping by hand means paginating through endless search results. This Actor searches Goodreads quotes by any keyword you provide and returns every match in a clean, flat schema. It handles the pagination and rate-limiting so you get a complete dataset without writing a single line of code.

Who uses it What they scrape Goodreads for
Content marketers Find quotable lines on a topic for social media posts or blog headers.
App builders Populate a quote-of-the-day feature with fresh, tagged content.
Researchers Analyze which authors or books dominate a theme in public discourse.
Book marketers Collect pull quotes from a genre to use in promotional copy.

What it does

This Actor searches Goodreads quotes by keyword and returns each quote as a flat row with its text, author, book, tags, and likes.

  • ๐Ÿ” Keyword search: feed the Actor any search term and it returns every matching quote on Goodreads.
  • ๐Ÿ“Š Flat output: each row is one quote with its text, author, book title, tags, and like count in a fixed schema.
  • โšก Bulk extraction: paid users can pull up to 1,000,000 quotes in a single run.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with Goodreads data

๐Ÿ“ Build a quote library by topic.

A content marketer searches for 'leadership' and exports 5,000 quotes to seed a year of daily social media posts.

๐Ÿ“ฑ Feed a mobile app with fresh content.

An indie developer runs the Actor weekly on 'motivation' and 'stoicism' to keep a quote widget populated with new material.

๐Ÿ“š Analyze author prominence in a genre.

A literature researcher scrapes quotes for 'science fiction' and tallies which authors appear most often to map influence.

๐Ÿท๏ธ Collect tagged quotes for a niche site.

A niche publisher scrapes quotes tagged 'writing' and 'creativity' to build a curated resource page that ranks for long-tail searches.

Why choose this scraper

What you get
No API key needed Reads the public Goodreads quote search pages directly.
Fixed schema Every quote arrives with the same fields, ready for your database or spreadsheet.
Built-in pagination Walks through every page of results until your maxItems count is reached.
Tag preservation Goodreads community tags come through so you can filter by theme.

How it compares

This Actor focuses on quote search by keyword and returns full quote metadata. The other Goodreads scrapers target books or a narrower quote schema.

Feature ParseForge Goodreads Books Scraper Goodreads Quotes
Search quotes by keyword Yes Not listed Yes
Returns quote text Yes Not listed Yes
Returns author name Yes Not listed Yes
Returns book title Yes Not listed Not listed
Returns community tags Yes Not listed Not listed
Returns like count Yes Not listed Not listed
Up to 1,000,000 items per run Yes Not listed Not listed

Configure the run

Drive the Actor with a single search keyword and set a maximum number of quotes to return. The scraper stops when it hits your limit or runs out of results. The Input tab lists every parameter.

A first run with the defaults:

{
 "searchQuery": "life",
 "maxItems": 10
}

A larger pull:

{
 "searchQuery": "life",
 "maxItems": 200
}

Pricing

Pay-per-result: $0.004 per result collected. You pay only for the results written to your dataset.

Results collected Approximate cost
100 results $0.40
1,000 results $4.00
10,000 results $40.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

  1. Create a free Apify account with $5 in credit.
  2. Open the Goodreads Quotes Scraper.
  3. Set your inputs and any filters, then click Start.
  4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to Goodreads through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/goodreads-quotes-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check that your searchQuery is spelled correctly and is not too narrow. Try a broader keyword. Also confirm that Goodreads has quotes for that term by searching the site manually.

Why did my run stop after only 10 items?

Free Apify accounts are limited to 10 items as a preview. Upgrade to a paid plan and set maxItems to a higher number to collect more quotes.

Why are some quotes missing their book title?

Goodreads does not always associate a book with a quote. When the source page lists no book, that field will be empty in your output. This is expected behavior.

Why is my run slow?

The Actor respects Goodreads servers by spacing requests. Large maxItems values will take longer. Use the Apify schedule feature to run it overnight if you need a very large dataset.

Why do I see a 'request failed' error?

Goodreads may occasionally block aggressive scraping. The Actor retries automatically. If failures persist, try reducing maxItems or running during off-peak hours.

FAQ

Question Answer
Do I need a Goodreads account or API key? No. The Actor reads the public Goodreads quote search pages. No login, no API key, and no OAuth flow are required.
What does each result row contain? Every row includes the quote text, the author who said it, the book title it comes from, the Goodreads tags, and the number of likes the quote received.
How many quotes can I scrape in one run? Free users are limited to 10 items as a preview. Paid Apify users can set maxItems up to 1,000,000 per run.
Can I scrape quotes from a specific author or book? The Actor searches by keyword. To target an author, use their name as the search query. It does not accept author or book IDs directly.
What export formats are supported? You can download your dataset in CSV, JSON, Excel, XML, or RSS from the Apify storage tab.
Does the Actor handle Goodreads rate limiting? Yes. It spaces requests and retries on failure so your run completes without manual intervention.
Can I schedule this Actor to run regularly? Yes. Apify supports cron-style schedules. Set it to run daily or weekly and it will append new results to your dataset.
What happens if my search returns more results than maxItems? The Actor stops as soon as it has collected the number of quotes you set in maxItems. It will not exceed that limit.
Are the tags the same ones Goodreads users assign? Yes. The tags field preserves the community-added labels exactly as they appear on the Goodreads quote page.
Can I filter quotes by minimum likes? The Actor does not filter by likes during scraping. You can sort or filter the exported dataset by the likes column in your spreadsheet or script.

Related actors

Browse the full ParseForge collection for more scrapers.

๐Ÿ†˜ Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

โš ๏ธ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Goodreads, LLC. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

Input

FieldTypeWhat it doesDefault
searchQuery string Keyword to search for quotes on Goodreads. life
maxItems integer Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 10

Pricing

from $3.62 per 1,000 results

Charged forWhat it isPrice each
result Single result in the default dataset. $0.00362 to $0.004

Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.

API

One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.

POST ยท run and get results
curl -X POST "https://api.apify.com/v2/acts/parseforge~goodreads-quotes-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "helloWorld": 123
  }'

Examples

Input that runs as-is.

input.json
{
  "helloWorld": 123
}

Reviews

No reviews yet. Be the first.

Issues

We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.

Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.

Related scrapers

Run Goodreads Quotes Scraper on Apify All scrapers