Overview
The node integrates with the Readwise Reader API to manage and retrieve data related to reading materials. Specifically, the "Tag" resource with the "List" operation allows users to fetch a list of tags from their Readwise Reader account. This is useful for organizing, filtering, or displaying tags associated with documents or highlights.
Common scenarios include:
- Synchronizing tags from Readwise into another system.
- Displaying available tags for user selection in workflows.
- Automating tag-based processing or categorization of reading content.
Example: A user wants to retrieve all tags to create a dashboard showing reading trends by tag.
Properties
| Name | Meaning |
|---|---|
| Additional Options | Optional parameters to customize the request. Includes: - Page Cursor: A string token from a previous response used to fetch the next page of tags if the total exceeds one request's limit. |
Output
The node outputs JSON data representing the list of tags retrieved from the Readwise Reader API. Each item in the output typically contains tag details such as tag name and identifier.
If pagination is involved (when using the Page Cursor), the output may also include metadata about the next page cursor to continue fetching additional tags.
No binary data output is expected from this operation.
Dependencies
- Requires an API key credential for authenticating with the Readwise Reader API.
- The node makes HTTP requests to
https://readwise.io/api/v3. - Proper configuration of the API key credential within n8n is necessary.
Troubleshooting
- Empty results: If no tags are returned, verify that the Readwise account has tags created.
- Pagination issues: Ensure the Page Cursor value is correctly passed from previous responses to fetch subsequent pages.
- Authentication errors: Confirm that the API key credential is valid and has appropriate permissions.
- Network errors: Check internet connectivity and API endpoint availability.
Links and References
- Readwise Reader API Documentation (general reference for API endpoints and usage)