Actions48
- Account Actions
- Authentication Actions
- Blocks Actions
- Bookmarks Actions
- Favourites Actions
- Featured Tags Actions
- Follow Requests Actions
- Media Actions
- Mutes Actions
- Notifications Actions
- Polls Actions
- Status Actions
- Timeline Actions
Overview
This node allows you to interact with the Mastodon API, specifically enabling you to search for user accounts on a Mastodon instance. It is useful when you want to find Mastodon users based on a search query, such as looking up people or organizations by name or keyword.
Practical examples include:
- Searching for accounts related to a specific topic or interest.
- Finding user profiles to follow or analyze.
- Automating discovery of new accounts on a given Mastodon instance.
Properties
| Name | Meaning |
|---|---|
| Mastodon URL | The URL of the Mastodon instance where the search will be performed (e.g., https://mastodon.social). |
| Query | The search string used to find matching accounts on the Mastodon instance. |
| Limit | The maximum number of account results to return from the search. |
Output
The output is a JSON array where each item represents a Mastodon account matching the search query. Each JSON object contains the details of an account as returned by the Mastodon API, which typically includes fields like username, display name, bio, follower counts, and other profile information.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential configured in n8n to access the Mastodon API.
- Needs the URL of the target Mastodon instance to direct API requests properly.
Troubleshooting
Common issues:
- Incorrect or unreachable Mastodon URL can cause connection failures.
- Invalid or missing API authentication token will result in authorization errors.
- Exceeding rate limits imposed by the Mastodon instance may cause temporary request failures.
Error messages:
"The operation "searchAccounts" for resource "account" is not implemented!"indicates a misconfiguration or unsupported operation selection.- Network or authentication errors usually come from invalid credentials or incorrect instance URLs.
Resolutions:
- Verify the Mastodon instance URL is correct and accessible.
- Ensure the API authentication token is valid and has necessary permissions.
- Respect rate limits and implement retry logic if needed.