Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API to retrieve the public timeline of statuses from a specified Mastodon instance. It is useful for scenarios where users want to monitor or analyze public posts on Mastodon, such as aggregating social media content, tracking trends, or integrating Mastodon feeds into other applications. For example, a user can fetch the latest public posts from a Mastodon server to display on a website or to perform sentiment analysis.

Use Case Examples

  1. Fetching the latest 20 public statuses from a Mastodon instance.
  2. Filtering public timeline posts to show only those with media attachments.
  3. Retrieving public statuses that contain specific hashtags.

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 public timeline results, such as showing only local or remote statuses, filtering by media presence, specifying hashtags, and controlling pagination and result limits.

Output

JSON

  • json - The JSON output contains the public timeline statuses retrieved from the Mastodon instance. Each item represents a status with its associated data as returned by the Mastodon API.

Dependencies

  • Requires an OAuth2 API credential for Mastodon authentication to access the Mastodon API.

Troubleshooting

  • If the node throws an error stating the operation is not implemented, verify that the 'Get Public Timeline' operation is correctly selected under the 'Timeline' resource.
  • Connection errors may occur if the Mastodon URL is incorrect or the OAuth2 credentials are invalid or expired. Ensure the URL is correct and the credentials are properly configured.
  • If no results are returned, check the filter parameters such as 'Local Only', 'Remote Only', or hashtag filters to ensure they are not overly restrictive.

Links

Discussion