Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API to retrieve the full thread context of a specific status (post) on a Mastodon instance. It is useful for users who want to analyze or display the conversation thread around a particular status, including its ancestors and descendants. For example, it can be used to fetch the entire conversation thread for a status to display it in a structured format or to analyze the discussion flow.

Use Case Examples

  1. Retrieve the full thread context of a status by providing the Mastodon instance URL and the status ID.
  2. Fetch the conversation thread including private statuses if the user has the necessary permissions.
  3. Format the returned conversation data as a structured set of ancestors and descendants, a flat chronological list, or a nested tree structure.

Properties

Name Meaning
Mastodon URL URL of the Mastodon instance to connect to, e.g., https://mastodon.social.
Status ID ID of the status to retrieve its full thread context.
Additional Options Optional parameters to customize the context retrieval, including whether to include private statuses, maximum depth of reply threads, and the format of the returned conversation data.

Output

JSON

  • ancestors - Array of ancestor statuses in the conversation thread.
  • descendants - Array of descendant statuses in the conversation thread.
  • thread - Flat array of all statuses in chronological order (if flat format selected).
  • tree - Nested tree structure of statuses representing the conversation thread (if tree format selected).

Dependencies

  • Requires an OAuth2 API credential for Mastodon to authenticate and access the Mastodon instance API.

Troubleshooting

  • Common issues include invalid or missing Mastodon instance URL, incorrect or missing status ID, and insufficient permissions to access private statuses.
  • Error messages may indicate unimplemented operations or resources if the node parameters are incorrectly set.
  • Ensure the OAuth2 credentials are correctly configured and have the necessary scopes, especially for accessing private statuses.

Links

Discussion