Mastodon icon

Mastodon

Interact with Mastodon API

Actions115

Directory → View

AI-generated

Overview

This node operation interacts with the Mastodon API to view the directory of accounts on a specified Mastodon instance. It allows users to retrieve a list of accounts with options to limit the number of results, offset the starting point, order the results by activity or newness, and filter to only local accounts. This is useful for discovering and exploring Mastodon users on a particular instance.

Use Case Examples

  1. Retrieve the top 40 most active accounts on mastodon.social.
  2. Get a list of new accounts starting from the 10th account on a custom Mastodon instance.
  3. Fetch only local accounts from a Mastodon instance's directory.

Properties

Name Meaning
Mastodon URL URL of the Mastodon instance to connect to, used to specify which instance's directory to view.
Authentication Type Method of authentication with the Mastodon instance, either OAuth2 or Access Token.
Limit Maximum number of results to return from the directory (up to 80).
Offset Number of accounts to skip before starting to return results, useful for pagination.
Order Order in which to return results, either by activity or by new accounts.
Local Only Boolean flag to return only local accounts from the Mastodon instance.

Output

JSON

  • json - The JSON output contains the directory accounts data returned from the Mastodon instance according to the specified parameters.

Dependencies

  • Requires authentication credentials for Mastodon API, either OAuth2 or an access token.

Troubleshooting

  • If authentication credentials are missing or incorrect, the node will throw an error indicating no credential selected or invalid authentication.
  • If the specified operation or resource is not implemented, an error will be thrown indicating the operation is not implemented.
  • Ensure the Mastodon URL is correctly formatted without trailing slashes to avoid request errors.

Discussion