Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API to retrieve the statuses that a user has bookmarked. It is useful for applications that need to fetch and process bookmarked posts from a Mastodon instance, such as social media management tools or content aggregation services. For example, a user can fetch their bookmarked statuses to analyze or display them in a custom dashboard.

Use Case Examples

  1. Fetch the latest 20 bookmarked statuses from a Mastodon instance to display in a user interface.
  2. Retrieve bookmarked statuses older than a specific ID to paginate through bookmarks.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to for fetching bookmarked statuses.
Max ID Return bookmarked statuses older than this ID, useful for pagination.
Since ID Return bookmarked statuses newer than this ID, useful for fetching recent bookmarks.
Min ID Return bookmarked statuses immediately newer than this ID, for fine-grained pagination.
Limit Maximum number of bookmarked statuses to return, with a range from 1 to 40.

Output

JSON

  • id - The unique identifier of the bookmarked status.
  • content - The content of the bookmarked status.
  • created_at - Timestamp when the status was created.
  • account - Information about the account that posted the status.
  • media_attachments - Any media attached to the status.
  • reblogs_count - Number of times the status has been reblogged.
  • favourites_count - Number of times the status has been favorited.

Dependencies

  • Requires an OAuth2 API credential for Mastodon authentication, including the base URL of the Mastodon instance.

Troubleshooting

  • Ensure the Mastodon URL is correct and accessible; incorrect URLs will cause connection failures.
  • Verify that the OAuth2 credentials are valid and have the necessary permissions to access bookmarks.
  • If the operation is not implemented for the resource, an error will be thrown indicating the unsupported operation.
  • Pagination parameters (max_id, since_id, min_id) must be used correctly to avoid empty or unexpected results.

Links

Discussion