Connect WeRead with Open Flow

Find your next book, organize highlights alongside your own thoughts, and turn your reading history into a clear review of your progress and interests.

20,000 free app calls per month (paid services billed separately)

What you can do

Search the WeRead catalog, inspect your bookshelf and progress, collect notes by chapter, compare public reviews, and explore personalized or similar-book recommendations. Reading statistics help you review time spent and changing preferences.

Books and Discovery

Search books and other catalog content, inspect details and chapters, and explore recommendations.

Shelf and Reading History

Read your shelf, progress and periodic reading statistics.

Notes and Reader Discussions

Collect personal notes and explore public reviews, popular passages and reader thoughts.

All actions

16 actions

Search

Search WeRead. Choose scope explicitly; use the last searchIdx as maxIdx for the next page. Response group scope may differ from request scope.

weread.search

Get Book

Get book details by ID.

weread.get_book

List Chapters

List a book's chapter table of contents.

weread.list_chapters

Get Reading Progress

Get reading progress. Progress 1 means 1%; completion requires progress 100 and finishTime.

weread.get_reading_progress

Get Shelf

Read the shelf. Visible entries equal books.length + albums.length + 1 when mp is nonempty; bookCount excludes audio and mp.

weread.get_shelf

List Notebooks

List notebook summaries. Next lastSort is the final book's sort. Total notes include reviewCount + noteCount + bookmarkCount.

weread.list_notebooks

List Highlights

List personal highlights in a book, excluding reading-position bookmarks. Query list_my_reviews as well to retrieve all exportable note content.

weread.list_highlights

List My Reviews

List personal thoughts, chapter comments and book reviews. Continue with the returned synckey while hasMore is 1.

weread.list_my_reviews

Get Underline Stats

Get chapter highlight popularity statistics without source text.

weread.get_underline_stats

List Popular Highlights

Get up to 20 popular highlights with source text. The upstream result is fixed-size and does not support pagination.

weread.list_popular_highlights

List Highlight Reviews

List thoughts on specified highlight ranges, preserving per-range pagination.

weread.list_highlight_reviews

Get Review

Get a single thought or review with optional comments and likes.

weread.get_review

Get Reading Stats

Get reading statistics for one period. Durations are seconds; annual mode covers only the selected calendar year.

weread.get_reading_stats

List Book Reviews

List public book reviews. Continue with the last idx and returned synckey. Content is nested at reviews[].review.review.

weread.list_book_reviews

List Recommendations

List personalized book recommendations. Continue with the last book's searchIdx as maxIdx.

weread.list_recommendations

List Similar Books

List similar books. Defaults to count 12 and maxIdx 0; continue with the last idx and returned sessionId.

weread.list_similar_books

Connect WeRead with Open Flow

Connect WeRead

20,000 free app calls per month (paid services billed separately)