Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

The Metricool node integrates with the Metricool social media management platform, enabling users to interact programmatically with various social media resources and operations. Specifically, for the Bluesky resource with the Get Posts operation, the node retrieves posts from a Bluesky account within a specified date range.

This node is beneficial for social media managers or marketers who want to automate data retrieval from their Bluesky accounts for reporting, analytics, or content auditing purposes. For example, you can use it to fetch all posts published between two dates to analyze engagement trends or to archive content.

Properties

Name Meaning
Blog ID The numeric identifier of the Metricool brand account (blog) from which to retrieve posts.
Start Date The start date (inclusive) for retrieving posts, formatted as YYYY-MM-DD.
End Date The end date (inclusive) for retrieving posts, formatted as YYYY-MM-DD.

Output

The node outputs an array of JSON objects representing the posts retrieved from the specified Bluesky blog within the given date range. Each object corresponds to a post and contains its details as returned by the Metricool API.

  • The json output field includes the posts' metadata such as content, timestamps, and possibly other post-related information.
  • There is no indication that this node outputs binary data.

Dependencies

  • Requires an active connection to the Metricool API via an API key credential configured in n8n.
  • The node uses the Metricool API base URL: https://api.metricool.com/v1.
  • Proper API authentication credentials must be set up in n8n under the node's credentials configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect Blog ID may result in empty responses or errors if the blog does not exist or is inaccessible.
    • Date format errors: Ensure Start Date and End Date are correctly formatted as YYYY-MM-DD.
    • Network connectivity issues can prevent successful API calls.

  • Error messages:

    • "Unknown resource: bluesky" or "Unknown operation: getPosts" indicates misconfiguration of resource or operation parameters.
    • API errors returned from Metricool will be surfaced; check the error message for details such as rate limits or permission issues.

  • Resolution tips:

    • Verify API credentials and permissions.
    • Double-check input parameters for correctness.
    • Use the "Continue On Fail" option in n8n to handle errors gracefully during batch executions.

Links and References

Discussion