Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API to perform various operations related to the Timeline resource, specifically including the 'Get Link Timeline' operation. It allows users to retrieve the timeline of a trending article URL from a specified Mastodon instance. This is useful for monitoring how a particular link is being discussed or shared across the Mastodon network. For example, a user can input a trending article URL and get a timeline of statuses referencing that link, which helps in tracking its popularity and engagement.

Use Case Examples

  1. Retrieve the timeline of a specific trending article URL from a Mastodon instance to analyze its reach and user interactions.
  2. Monitor the spread of a news article or blog post on Mastodon by fetching its link timeline.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to, e.g., https://mastodon.social.
URL The URL of the trending article to get the timeline for.
Additional Fields Optional parameters to filter or limit the timeline results, such as showing only local or remote statuses, filtering by media attachments, hashtags, or limiting the number of results.

Output

JSON

  • json
    • ``
      * id - The unique identifier of each status in the timeline.
      * content - The content of each status referencing the link.
      * created_at - Timestamp when the status was created.
      * account - Information about the account that posted the status.
      * media_attachments - Any media attached to the status.
      * reblogs_count - Number of reblogs (shares) of the status.
      * favourites_count - Number of favourites (likes) of the status.

Dependencies

  • Requires an OAuth2 API credential for Mastodon authentication, including the base URL of the Mastodon instance.

Troubleshooting

  • Ensure the Mastodon URL is correct and accessible; incorrect URLs will cause connection failures.
  • Verify that the OAuth2 credentials are valid and have the necessary permissions to access timelines.
  • If the operation is not implemented for the resource, an error will be thrown; check that the operation 'Get Link Timeline' is supported for the 'Timeline' resource.
  • API rate limits may affect the number of results returned; use the 'Limit' property to control the volume of data.
  • Network issues or Mastodon instance downtime can cause request failures; retry or check instance status.

Discussion