Guides

Task-oriented walkthroughs for the things people actually do with public Goodreads data.

Each guide is built around a job rather than a command: looking up books and authors, searching and discovering, reading shelves and quotes, crawling in bulk into a local store, and shaping the output. They assume you have run the quick start.

Books and authors Look up books, authors, and series, find similar books, and read embedded reviews, with the WAF caveat. Search and discovery Search the catalog through the open autocomplete endpoint, browse genres and lists, and classify URLs. Shelves and quotes Read a reader's bookshelf from the public RSS feed, collect quotes, and look up reader profiles. Bulk crawling Discover URLs from the sitemap, queue them, crawl into a local SQLite store, and export the records. Output formats Render records as a table, JSON, CSV, or your own template, and script against the exit codes.