Mastodon icon

Mastodon

Interact with Mastodon API

Actions48

Overview

This node interacts with the Mastodon API to retrieve information about account followers. Specifically, the "Get Account Followers" operation fetches the list of followers for a given Mastodon account on a specified Mastodon instance.

Common scenarios where this node is beneficial include:

  • Social media analytics: Gathering follower data to analyze audience size or engagement.
  • Community management: Monitoring who follows an account to manage interactions or outreach.
  • Integration workflows: Syncing follower lists with other systems or databases.

Practical example:

  • A user wants to automatically collect and store the followers of their Mastodon account from a specific instance to track growth over time or trigger notifications when new followers appear.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to (e.g., https://mastodon.social).
Account ID The unique identifier of the Mastodon account whose followers are to be retrieved.

Output

The output is a JSON array where each item represents a follower of the specified Mastodon account. Each follower object typically contains details such as the follower's account ID, username, display name, avatar URL, and other profile metadata as provided by the Mastodon API.

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 instance.
  • The node needs network access to the specified Mastodon instance URL.
  • No additional external dependencies beyond the Mastodon API and the configured credentials.

Troubleshooting

  • Common issues:

    • Incorrect or unreachable Mastodon URL: Ensure the Mastodon instance URL is correct and accessible.
    • Invalid or missing Account ID: Verify that the Account ID corresponds to a valid account on the Mastodon instance.
    • Authentication errors: Confirm that the API authentication token is valid and has sufficient permissions.
    • Rate limiting by Mastodon API: If many requests are made in a short period, the API may throttle requests.

  • Error messages:

    • "The operation "getAccountFollowers" for resource "account" is not implemented!" — This indicates a misconfiguration or typo in the operation or resource name.
    • Network or authentication errors will typically return error messages from the Mastodon API; check credentials and connectivity.

  • Resolution tips:

    • Double-check input parameters for correctness.
    • Ensure the API token is properly set up in n8n credentials.
    • Review Mastodon instance status and API limits.

Links and References

Discussion