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. Specifically, for the Instagram resource and the "Get Stories" operation, the node retrieves Instagram story data from a specified Metricool brand account within a defined date range.

This node is beneficial for social media managers and marketers who want to automate the extraction of Instagram stories analytics or content data for reporting, analysis, or further processing workflows. For example, you could use it to gather all Instagram stories posted by a brand between two dates to analyze engagement trends or archive content.

Properties

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

Output

The node outputs JSON data representing the Instagram stories retrieved from the Metricool platform for the specified blog ID and date range. Each item in the output array corresponds to a story object containing details such as story content, timestamps, and any associated metadata provided by Metricool's API.

If the node supports binary data output (e.g., images or videos from stories), it would be included in the binary property of the output items; however, based on the static code, this node primarily returns JSON data about stories.

Dependencies

  • Requires an active Metricool API key credential configured in n8n to authenticate requests.
  • The node communicates with the Metricool API endpoint at https://api.metricool.com/v1.
  • Proper configuration of the Metricool brand account (blog) is necessary to access Instagram stories data.

Troubleshooting

  • Common Issues:

    • Invalid or missing Blog ID: Ensure the Blog ID corresponds to a valid Metricool brand account.
    • Date format errors: Dates must be in the correct YYYY-MM-DD format.
    • Authentication failures: Verify that the Metricool API key credential is correctly set up and has sufficient permissions.
    • API rate limits or connectivity issues may cause request failures.

  • Error Messages:

    • "Unknown resource: instagram" or "Unknown operation: Get Stories": Indicates a misconfiguration of resource or operation parameters.
    • Network or authentication errors will typically return messages from the Metricool API; check credentials and network connectivity.

To resolve these, double-check input parameters, ensure valid credentials, and confirm network access to Metricool's API.

Links and References

Discussion