Mastodon icon

Mastodon

Interact with Mastodon API

Actions115

Timeline → Get Public Timeline

AI-generated

Overview

This node interacts with the Mastodon API to retrieve the public timeline from a specified Mastodon instance. It supports filtering options such as showing only local or remote statuses, statuses with media attachments, and limiting the number of results. This is useful for users who want to monitor or analyze public posts on Mastodon, for example, to track trending topics or gather public social media data.

Use Case Examples

  1. Retrieve the latest 20 public posts from a Mastodon instance.
  2. Filter the public timeline to show only local statuses with media attachments.
  3. Limit the public timeline results to 40 posts for performance optimization.

Properties

Name Meaning
Mastodon URL URL of the Mastodon instance to connect to, e.g., https://mastodon.social.
Authentication Type Method to authenticate with the Mastodon instance, either OAuth2 or Access Token.
Local Only Show only local statuses in the public timeline.
Remote Only Show only remote statuses in the public timeline.
Media Only Show only statuses that have media attachments.
Max ID Return results older than this ID to paginate backward.
Since ID Return results newer than this ID to paginate forward.
Min ID Return results immediately newer than this ID.
Limit Maximum number of results to return, with a maximum of 40.

Output

JSON

  • json - The JSON output contains the public timeline statuses retrieved from the Mastodon instance. Each item represents a status object with details such as content, author, media attachments, and metadata.

Dependencies

  • Requires authentication credentials for Mastodon API, either OAuth2 or an access token.

Troubleshooting

  • If authentication credentials are missing or incorrect, the node will throw an error indicating no credential selected or invalid authentication.
  • If the specified operation or resource is not implemented, an error will be thrown indicating the operation is not implemented.
  • Ensure the Mastodon URL is correctly formatted without trailing slashes to avoid request errors.
  • If the Mastodon instance is unreachable or the API rate limit is exceeded, the node may fail to retrieve data.

Discussion