Mastodon icon

Mastodon

Interact with Mastodon API

Actions48

Overview

This node interacts with the Mastodon API, a decentralized social networking platform. Specifically, the "Featured Tags" resource with the "Get Featured Tags" operation allows users to retrieve a list of tags that are currently featured or highlighted on a given Mastodon instance.

Common scenarios where this node is beneficial include:

  • Monitoring trending or important topics on a Mastodon instance.
  • Aggregating popular hashtags for content curation or analysis.
  • Integrating Mastodon featured tags into other workflows or dashboards.

For example, a user might use this node to fetch featured tags from "https://mastodon.social" and then trigger further actions based on those tags, such as fetching related posts or notifying a community manager about trending topics.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to (e.g., https://mastodon.social). This specifies which Mastodon server the node will query for featured tags.

Output

The output is a JSON array containing the featured tags retrieved from the specified Mastodon instance. Each item in the array represents a featured tag object as returned by the Mastodon API. The structure typically includes details such as the tag name, URL, and possibly additional metadata like the number of uses or description.

No binary data output is involved in this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to authenticate requests to the Mastodon API.
  • Needs the URL of the target Mastodon instance to connect to.
  • The node depends on the Mastodon API being accessible and the provided credentials having sufficient permissions.

Troubleshooting

  • Common Issues:

    • Incorrect or unreachable Mastodon URL: Ensure the URL is correct and the Mastodon instance is online.
    • Invalid or missing API authentication token: Verify that the credential is properly set up and has access rights.
    • Operation not implemented error: This would occur if the operation name is misspelled or unsupported; ensure "Get Featured Tags" is selected correctly.

  • Error Messages:

    • "The operation "Get Featured Tags" for resource "Featured Tags" is not implemented!"
      Means the operation is not recognized; check spelling and supported operations.
    • Network or authentication errors may return messages indicating failure to connect or unauthorized access; verify network connectivity and credentials.

Links and References

Discussion