Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

This 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 Posts" operation, it allows retrieving Instagram posts data from a specified Metricool brand account within a defined date range.

Common scenarios include:

  • Automating the retrieval of Instagram post metrics or content for reporting.
  • Integrating Instagram post data into custom dashboards or workflows.
  • Scheduling analytics or content audits based on historical post data.

For example, a marketing team could use this node to fetch all Instagram posts published between two dates to analyze engagement trends or prepare reports without manual export.

Properties

Name Meaning
Blog ID The blog ID of the Metricool brand account associated with the Instagram profile.
Start Date The start date (inclusive) for retrieving Instagram posts, formatted as YYYY-MM-DD.
End Date The end date (inclusive) for retrieving Instagram posts, formatted as YYYY-MM-DD.

Output

The node outputs JSON data representing the retrieved Instagram posts within the specified date range for the given blog ID. Each item in the output array corresponds to a post and includes details such as post content, publication date, metrics, and other metadata provided by Metricool's API.

If the node supports binary data output (not explicitly shown in the code), it would typically represent media files related to posts (e.g., images or videos). However, based on the static analysis, the output is primarily JSON structured data about posts.

Dependencies

  • Requires an active Metricool account with API access.
  • Needs an API key credential configured in n8n for authenticating requests to Metricool's API.
  • The node uses Metricool's REST API endpoint at https://api.metricool.com/v1.
  • Proper permissions on the Metricool account to access Instagram brand data.

Troubleshooting

  • Common Issues:

    • Invalid or missing Blog ID: Ensure the Blog ID corresponds to a valid Metricool brand account linked to Instagram.
    • Date format errors: Dates must be in the correct ISO format (YYYY-MM-DD).
    • Authentication failures: Verify that the API key credential is correctly set up and has not expired.
    • Rate limiting or API quota exceeded: Metricool may limit API calls; check your account limits.

  • Error Messages:

    • "Unknown resource: instagram" or "Unknown operation: getPosts": Indicates a misconfiguration in the Resource or Operation parameters.
    • Network or timeout errors: Check internet connectivity and Metricool service status.
    • API response errors with messages from Metricool: Review the error message for specific issues like invalid parameters or permission denied.

Resolving these usually involves verifying input parameters, ensuring credentials are valid, and confirming API usage limits.

Links and References

Discussion