Free tool
Goodreads CSV analyzer
Upload your Goodreads CSV export and get instant stats — total books, top authors, reading by year, average rating. Everything runs locally in your browser.
Why this exists
Goodreads gives you a CSV export but doesn\'t do much with it once you have the file. This tool opens the CSV directly in your browser and produces a useful summary — the kind of stats Goodreads should show you natively but doesn\'t.
Nothing is uploaded to our servers. Parsing happens entirely in your browser using the file you select. You can verify with your browser\'s network tab.
Upload your Goodreads CSV export to get instant stats. Everything runs in your browser — your data never touches our servers.
Don\'t have a CSV yet? On Goodreads, go to Import / Export → Export Library.
How to get your Goodreads CSV
- 1
Sign in to Goodreads
Go to goodreads.com/review/import. - 2
Click "Export Library"
Goodreads generates a CSV file containing your entire library. The download link appears at the top of the page within a few seconds for most libraries. - 3
Upload it here
Choose the downloaded file using the upload above. Your library is parsed entirely in your browser.
What you'll see
Library size
Total books across all shelves, plus a breakdown by Read / Currently Reading / Want to Read.
Total pages read
Sum of pages across the books on your "Read" shelf.
Average rating
Your average rating across the books you've rated.
Top authors
The 10 authors you've read most, ranked by book count.
Reading by year
Books finished per year, drawn from the "Date Read" column.
Privacy preserved
Nothing is uploaded. Parsing is local. Refresh and the data is gone.
Frequently asked questions
- Is my CSV uploaded anywhere?
- No. The file is parsed entirely in your browser using JavaScript. Nothing is sent to a server. You can verify in your browser's developer tools network tab.
- What if my CSV has weird characters?
- The parser handles UTF-8, escaped quotes, and embedded newlines in fields. If something fails, the error message will tell you what column was problematic.
- Can I analyse a CSV that isn't from Goodreads?
- The tool expects Goodreads' specific column names ("Title", "Author", "My Rating", "Exclusive Shelf", etc.). Other formats won't parse correctly.
- How does this relate to Literal's Goodreads importer?
- The importer pulls directly from your public Goodreads profile (no CSV needed) and lands the books on Literal. This tool just analyses the CSV — useful as a preview before importing.
