Mastodon icon

Mastodon

Interact with Mastodon API

Actions115

Search → Search

AI-generated

Overview

This node performs search operations on a Mastodon instance. It allows users to query the Mastodon API to search for accounts, hashtags, or statuses based on a specified query string. The node supports various filters and options to refine the search results, such as limiting the number of results, filtering by account ID, and excluding unreviewed tags. This node is useful for scenarios where users want to programmatically retrieve and analyze Mastodon content matching specific criteria, such as monitoring hashtags, finding accounts, or tracking statuses.

Use Case Examples

  1. Searching for recent statuses containing a specific hashtag.
  2. Finding accounts related to a particular topic or user.
  3. Retrieving a list of trending hashtags on a Mastodon instance.

Properties

Name Meaning
Mastodon URL URL of the Mastodon instance to connect to, used as the base URL for API requests.
Authentication Type Method to authenticate with the Mastodon instance, either OAuth2 or Access Token.
Query The search query string to find matching accounts, hashtags, or statuses.
Type Specify the type of results to return: accounts, hashtags, or statuses.
Resolve Attempt WebFinger lookup for remote accounts to resolve them.
Following Only return accounts that the authenticated user is following.
Account ID Filter statuses to those from a specific account ID.
Exclude Unreviewed Exclude unreviewed tags from the search results.
Max ID Return results older than this ID, used for pagination or filtering.
Min ID Return results newer than this ID, used for pagination or filtering.
Limit Maximum number of results to return from the search.

Output

JSON

  • json - The search results returned from the Mastodon API, which may include accounts, hashtags, or statuses depending on the query and filters applied.

Dependencies

  • Mastodon API credentials (OAuth2 or Access Token)

Troubleshooting

  • Ensure the Mastodon URL is correct and accessible.
  • Verify that the correct authentication type and credentials are selected.
  • Check that the query string is not empty and properly formatted.
  • If the node throws an error about missing credentials, ensure the appropriate Mastodon API credentials are configured in n8n.
  • Errors about unsupported operations indicate that the selected resource or operation is not implemented in the node.

Discussion