Actions48
- Account Actions
- Authentication Actions
- Blocks Actions
- Bookmarks Actions
- Favourites Actions
- Featured Tags Actions
- Follow Requests Actions
- Media Actions
- Mutes Actions
- Notifications Actions
- Polls Actions
- Status Actions
- Timeline Actions
Overview
This node interacts with the Mastodon API, specifically to retrieve the statuses that a user has bookmarked on a Mastodon instance. It is useful for scenarios where you want to programmatically access and process your bookmarked posts from Mastodon, such as aggregating saved content, analyzing bookmarked trends, or integrating bookmarked statuses into other workflows.
For example, you could use this node to:
- Fetch your latest bookmarked statuses to display them in a custom dashboard.
- Automatically archive bookmarked posts to another service.
- Analyze the content of bookmarked statuses for sentiment or topic modeling.
Properties
| Name | Meaning |
|---|---|
| Mastodon URL | The URL of the Mastodon instance to connect to (e.g., https://mastodon.social). |
| Max ID | Return results older than this status ID (used for pagination). |
| Since ID | Return results newer than this status ID (used for filtering recent bookmarks). |
| Min ID | Return results immediately newer than this status ID (used for incremental fetching). |
| Limit | Maximum number of bookmarked statuses to return (between 1 and 40). |
Output
The output is an array of JSON objects, each representing a bookmarked status retrieved from the Mastodon instance. Each JSON object contains the full data structure of a Mastodon status as returned by the Mastodon API, including details such as:
- Status ID
- Content text
- Author information
- Timestamps
- Media attachments (if any)
- Visibility settings
- Any other metadata associated with the status
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential configured in n8n to authenticate requests to the Mastodon instance.
- Requires the URL of the Mastodon instance to connect to.
- The node depends on the Mastodon API being accessible and the authenticated user having permission to read their bookmarks.
Troubleshooting
Common issues:
- Incorrect Mastodon URL or unreachable instance will cause connection errors.
- Invalid or missing API authentication token will result in authorization errors.
- Using IDs (
max_id,since_id,min_id) incorrectly may lead to empty results or unexpected pagination behavior. - Requesting more than 40 results will be rejected due to API limits.
Error messages:
"The operation "get" for resource "bookmarks" is not implemented!"— This indicates a misconfiguration or unsupported operation; ensure the correct resource and operation are selected.- Network or timeout errors — Check network connectivity and Mastodon instance availability.
- Authentication errors — Verify that the API key/token credential is valid and has required scopes.
Resolution tips:
- Double-check the Mastodon instance URL and credentials.
- Use the
Limitproperty within allowed bounds. - Use pagination parameters (
max_id,since_id,min_id) carefully according to Mastodon's API documentation.