# Connect WeRead with Open Flow

Source: https://openflow.run/en/integrations/weread/

[All integrations](https://openflow.run/en/integrations/)

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

*   [16 actions](https://openflow.run/en/integrations/weread/#integration-actions)
*   API key
*   Productivity

[Connect WeRead](https://console.openflow.run/connections/weread)

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`

No actions match your search.

## Connect WeRead with Open Flow

[Connect WeRead](https://console.openflow.run/connections/weread)

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