Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API to retrieve the home timeline of a user. It fetches statuses from the user's home timeline, which includes posts from accounts the user follows. This is useful for applications that want to display or process a user's Mastodon feed, such as social media dashboards, content aggregators, or automation workflows that react to new posts.

Use Case Examples

  1. Fetching the latest posts from a user's home timeline to display in a custom dashboard.
  2. Automating responses or actions based on new statuses appearing in the home timeline.
  3. Aggregating content from followed accounts for analysis or reposting.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to, e.g., https://mastodon.social.
Additional Fields Optional parameters to filter or limit the timeline results, such as limiting the number of results, filtering by media presence, or specifying ID boundaries for pagination.

Output

JSON

  • json - The JSON output contains the statuses retrieved from the user's home timeline. Each item represents a status object as returned by the Mastodon API.

Dependencies

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

Troubleshooting

  • Common errors include invalid or missing OAuth2 credentials, incorrect Mastodon instance URL, or unsupported operations for the selected resource.
  • If the node throws an error about an unimplemented operation, verify that the operation name matches the supported ones for the 'timeline' resource.
  • Network or API rate limit errors may occur if the Mastodon instance is unreachable or the API limits are exceeded.

Links

Discussion