Mastodon icon

Mastodon

Interact with Mastodon API

Actions115

Lists → Get Accounts in List

AI-generated

Overview

This node operation interacts with the Mastodon API to retrieve accounts that belong to a specific list on a Mastodon instance. It is useful for scenarios where you want to manage or analyze the members of a Mastodon list, such as fetching user details for moderation, analytics, or integration with other systems.

Use Case Examples

  1. Fetch all accounts in a Mastodon list to display in a dashboard.
  2. Retrieve accounts in a list to send targeted notifications or messages.
  3. Analyze the members of a list for community management or engagement tracking.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to.
Authentication Type The method used to authenticate with the Mastodon instance, either OAuth2 or Access Token.
List ID The unique identifier of the Mastodon list from which to retrieve accounts.
Max ID Return results older than this ID, used for pagination or filtering older accounts.
Since ID Return results newer than this ID, used for filtering newer accounts.
Min ID Return results immediately newer than this ID, used for precise filtering.
Limit Maximum number of accounts to return, with a maximum of 80 and 0 meaning all accounts.

Output

JSON

  • id - The unique identifier of the account in the list.
  • username - The username of the account.
  • display_name - The display name of the account.
  • acct - The account handle including domain if remote.
  • url - The URL to the account's profile.
  • avatar - The URL to the account's avatar image.
  • header - The URL to the account's header image.
  • note - The bio or note of the account.
  • followers_count - Number of followers the account has.
  • following_count - Number of accounts the account is following.
  • statuses_count - Number of statuses (posts) the account has made.

Dependencies

  • Mastodon API

Troubleshooting

  • Ensure the correct Mastodon URL is provided and accessible.
  • Verify that the authentication credentials (OAuth2 or Access Token) are valid and have the necessary permissions.
  • Check that the List ID is correct and that the authenticated user has access to the list.
  • If pagination parameters (max_id, since_id, min_id) are used, ensure they are valid IDs from the Mastodon instance.
  • The limit parameter must be between 0 and 80; setting it to 0 returns all accounts, which might be large and slow.

Discussion