Audiobookshelf icon

Audiobookshelf

Work with the Audiobookshelf API

Overview

This node integrates with the Audiobookshelf API to retrieve detailed listening statistics for a specific user. It is useful in scenarios where you want to analyze or display a user's audiobook listening habits, such as total listening time, most listened audiobooks, or session counts. For example, it can be used in a dashboard that tracks user engagement or in personalized recommendation systems.

Properties

Name Meaning
User ID The unique identifier of the user whose listening stats you want to retrieve. This is a required string input.

Output

The node outputs JSON data containing the listening statistics of the specified user. This typically includes aggregated metrics such as total listening duration, number of sessions, and possibly detailed session information depending on the API response. The output does not include binary data.

Dependencies

  • Requires an API key credential for authenticating with the Audiobookshelf API.
  • The node expects the base URL of the Audiobookshelf instance to be configured via credentials.
  • No additional external dependencies are needed beyond the API access.

Troubleshooting

  • Missing or invalid User ID: Ensure the User ID property is provided and correctly corresponds to an existing user in Audiobookshelf.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • Network issues: Confirm that the domain URL is reachable and correct in the credentials configuration.
  • API rate limits or server errors: If requests fail repeatedly, check the Audiobookshelf API status and consider implementing retry logic.

Links and References

Discussion