Goodreads Quotes Scraper

Extract Goodreads quotes into clean, structured datasets for research, publishing, and app features. Collect by tag, author, search query, or direct Goodreads quotes URL. Output is deduplicated and ready for analysis.

Features

• Flexible targeting — Collect by tag, author name, search text, or direct URL.
• Rich quote records — Includes quote text, IDs, author details, tags, likes, and source context.
• Dataset quality controls — Removes empty values and skips duplicate items.
• Pagination controls — Configure both result limit and page limit.
• Production-friendly output — Structured records suitable for BI tools and apps.

Use Cases

Content Planning

Build quote collections for blogs, newsletters, social channels, and editorial calendars.

Author and Theme Research

Compare quote popularity and tag distribution across authors and topics.

Product Data Feeds

Power quote-of-the-day apps, writing assistants, and recommendation features.

Analytics Workflows

Export datasets for trend analysis, NLP, classification, and dashboards.

Input Parameters

Parameter	Type	Required	Default	Description
startUrl	String	No	—	Goodreads quotes URL to start from. Overrides other filters when provided.
tag	String	No	"inspirational"	Tag page to collect quotes from.
author	String	No	—	Author name used for quote search.
search	String	No	—	Free-text search term.
results_wanted	Integer	No	100	Maximum number of quotes to collect.
max_pages	Integer	No	20	Safety cap for the number of pages to process.
proxyConfiguration	Object	No	{"useApifyProxy": true}	Proxy configuration for large-scale runs.

Output Data

Each dataset item contains:

Field	Type	Description
quote_id	String	Stable Goodreads quote identifier when available.
quote	String	Full quote text.
author	String	Author name.
author_url	String	Goodreads author profile URL.
book	String	Book title when available.
book_url	String	Goodreads book URL when available.
tags	Array	Tags associated with the quote.
tag_count	Number	Number of tags on the quote.
likes	Number	Likes count on Goodreads.
url	String	Direct quote URL on Goodreads.
source	String	Source type: tag, search, or quotes.
source_query	String	Query term used during collection.
page	Number	Page number where the quote was found.

Usage Examples

Basic Tag Collection

{
  "tag": "inspirational",
  "results_wanted": 50,
  "max_pages": 5
}

Author Search

{
  "author": "Maya Angelou",
  "results_wanted": 80,
  "max_pages": 8
}

Direct URL Collection

{
  "startUrl": "https://www.goodreads.com/quotes/tag/love",
  "results_wanted": 200,
  "max_pages": 12,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Sample Output

{
  "quote_id": "24499",
  "quote": "Be the change that you wish to see in the world.",
  "author": "Mahatma Gandhi",
  "author_url": "https://www.goodreads.com/author/show/5810891.Mahatma_Gandhi",
  "tags": ["action", "change", "inspirational", "philosophy"],
  "tag_count": 4,
  "likes": 114486,
  "url": "https://www.goodreads.com/quotes/24499-be-the-change-that-you-wish-to-see-in-the",
  "source": "tag",
  "source_query": "inspirational",
  "page": 1
}

Tips for Best Results

Start Small First

Test with 20 to 50 results before scaling to larger runs.

Use Specific Queries

Clear tags and author names usually return cleaner, more relevant datasets.

Use Proxies for Scale

For larger runs, use residential proxies to keep collection stable.

Integrations

Connect output with:

• Google Sheets — Reporting and collaboration
• Airtable — Searchable quote databases
• Zapier — Workflow automation
• Make — No-code pipelines
• Webhooks — Push to custom systems

Export Formats

• JSON — Developer-ready data
• CSV — Spreadsheet analysis
• Excel — Business reporting
• XML — Structured system integrations

Frequently Asked Questions

How many quotes can I collect?

The actor scales from small test runs to large collections. Use results_wanted and max_pages to control run size.

Why are some optional fields missing?

Not every quote has complete metadata on Goodreads. The actor removes empty fields to keep records clean.

Can I run by author only?

Yes. Provide author and the actor will collect quotes matching that author search.

Legal

Use this actor responsibly and follow applicable terms and regulations for your use case. Ensure your downstream usage and publishing workflows comply with relevant policies and rights requirements.