Actions16
Overview
This node interacts with the Audiobookshelf API to retrieve filter data related to a specific library. The "Get Filter Data" operation under the "Library" resource fetches metadata or filtering options that can be used to refine searches or organize content within a given library. This is useful when you want to dynamically obtain available filters such as genres, authors, tags, or other categorizations from an audiobook library.
Practical examples include:
- Displaying available filter categories in a user interface to help users narrow down audiobook selections.
- Automating workflows that adjust queries based on current filter options in the library.
- Synchronizing filter metadata for reporting or analytics purposes.
Properties
| Name | Meaning |
|---|---|
| Library ID | The unique identifier of the library for which to retrieve filter data. This is a required string input. |
Output
The node outputs JSON data containing the filter information retrieved from the specified library. This typically includes various filter categories and their possible values (e.g., genres, authors, tags). The exact structure depends on the API response but generally provides structured metadata to support filtering operations.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the Audiobookshelf API.
- Needs an API authentication token credential configured in n8n to authorize requests.
- The base URL for API requests is derived from the user's configured domain credential.
Troubleshooting
- Missing or invalid Library ID: Ensure the Library ID property is provided and correctly references an existing library.
- Authentication errors: Verify that the API key or authentication token is valid and has sufficient permissions.
- Network issues: Confirm that the domain URL is reachable and the API endpoint is accessible.
- Unexpected API responses: Check if the Audiobookshelf API version or schema has changed, which might affect the returned filter data format.
Links and References
- Audiobookshelf API Documentation (general reference for API endpoints and data structures)
- n8n Documentation (for configuring credentials and using HTTP request nodes)