Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API, specifically to retrieve information about accounts and their relationships. The "Get Account Following" operation under the "Account" resource fetches the list of accounts that a specified Mastodon account is following. This is useful for social media analysis, monitoring user connections, or building integrations that need to track follow relationships on Mastodon.

Practical examples include:

  • Fetching the list of users followed by a particular account to analyze their interests or network.
  • Building dashboards that display an account's following list.
  • Automating notifications or actions based on changes in an account's following list.

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 following list you want to retrieve.

Output

The output is a JSON array where each item represents an account that the specified account is following. Each JSON object contains detailed information about a followed account, such as username, display name, profile details, and other metadata 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.
  • Needs the Mastodon instance URL to direct API calls correctly.
  • The node depends on the Mastodon API being accessible and the authenticated user having permission to view the target account's following list.

Troubleshooting

  • Common Issues:

    • Incorrect or missing Mastodon instance URL can cause connection failures.
    • Invalid or expired API authentication tokens will result in authorization errors.
    • Providing an invalid or non-existent Account ID will lead to errors or empty results.
    • Network issues or Mastodon server downtime can cause request failures.
  • Error Messages:

    • "The operation "getAccountFollowing" for resource "account" is not implemented!" — indicates a misconfiguration or unsupported operation; ensure correct operation and resource names.
    • Authorization errors typically mention permission denied or unauthorized access; verify API credentials.
    • Connection timeouts or network errors suggest checking internet connectivity and Mastodon instance availability.
  • Resolutions:

    • Double-check the Mastodon URL and ensure it includes the protocol (https://).
    • Refresh or reconfigure the API authentication token credential.
    • Verify the Account ID exists on the specified Mastodon instance.
    • Retry after some time if the Mastodon server is temporarily unavailable.

Links and References

Discussion