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
The node interacts with the Mastodon API, specifically providing functionality to retrieve the timeline of a trending article link on a Mastodon instance. This operation fetches statuses related to a given URL, allowing users to monitor discussions or activity around specific articles shared on Mastodon.
Common scenarios where this node is beneficial include:
- Tracking social engagement and conversations about a particular news article or blog post.
- Aggregating user reactions and comments linked to a trending URL.
- Integrating Mastodon link timelines into dashboards or analytics workflows.
For example, a user can input the URL of a popular article and retrieve all Mastodon statuses referencing that link, enabling sentiment analysis or content curation based on real-time social data.
Properties
| Name | Meaning |
|---|---|
| Mastodon URL | The base URL of the Mastodon instance to connect to (e.g., https://mastodon.social). |
| URL | The URL of the trending article for which to get the timeline (i.e., the target link). |
| Additional Fields | Optional parameters to refine the timeline query: |
| - Local Only | Show only local statuses from the connected Mastodon instance. |
| - Remote Only | Show only remote statuses from other instances. |
| - Media Only | Show only statuses that include media attachments. |
| - Max ID | Return results older than this status ID. |
| - Since ID | Return results newer than this status ID. |
| - Min ID | Return results immediately newer than this status ID. |
| - Limit | Maximum number of results to return (maximum 40). |
Note: Some additional fields apply to multiple operations but are available here for completeness.
Output
The output consists of an array of JSON objects, each representing a Mastodon status related to the specified link timeline. Each JSON object contains detailed information about a status, such as content, author, timestamps, and any associated media or metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential for the Mastodon instance (OAuth2-based).
- The Mastodon instance URL must be provided to direct API requests correctly.
- No additional external services beyond the Mastodon API are required.
Troubleshooting
Error: "The operation 'link' for resource 'timeline' is not implemented!"
This indicates a mismatch between the selected operation and the implemented methods. Ensure the operation name is exactly "link" and the resource is "timeline".Authentication errors
Verify that the OAuth2 credentials are correctly configured and authorized for the target Mastodon instance.Empty or incomplete results
Check if the provided URL is correct and actually referenced in Mastodon statuses. Also, verify optional filters like "Local Only" or "Media Only" are not overly restrictive.Rate limiting or API errors
Mastodon instances may impose rate limits; handle these gracefully or adjust request frequency.